korean-patent-search

한국 특허 정보 검색 What this skill does KIPRIS Plus(키프리스 플러스) 공식 Open API로 한국 특허/실용신안 공개·공고 데이터를 검색한다. v1 범위: 키워드 검색 ( getWordSearch ) 출원번호 기준 서지 상세 조회 ( getBibliographyDetailInfoSearch ) 구조화된 JSON 출력 표준 python3 helper 동봉 When to use "배터리 관련 한국 특허 찾아줘" "출원번호 1020240001234 특허 요약 보여줘" "KIPRIS API로 특허 검색 결과를 JSON으로 받고 싶어" "출원인/IPC/초록까지 포함한 한국 특허 검색 결과가 필요해" Prerequisites 인터넷 연결 python3 KIPRIS Plus에서 발급받은 API 키 helper 환경변수: KIPRIS_PLUS_API_KEY 실제 요청 쿼리 파라미터명: ServiceKey 설치된 skill payload 안에 scripts/patent_search.py helper 포함 Inputs 키워드 검색 필수: --query 선택: --year 선택: --page-no 선택: --num-rows 선택: --exclude-patent 선택: --exclude-utility 상세 조회 필수: --application-number Workflow KIPRIS_PLUS_API_KEY 또는 --service-key 로 ServiceKey를 확보한다. 공공데이터포털에서 복사한 percent-encoded 값도 helper가 한 번 정규화해서 그대로 받을 수 있다. 키워드 검색이면 getWordSearch endpoint를 호출한다. 출원번호 상세 조회면 getBibliographyDetailInfoSearch endpoint를 호출한다. XML 응답의 header/body/items 구조를 파싱한다. 출원번호, 발명의명칭, 출원인, 초록, 공개/공고/등록 메타데이터를 JSON으로 정리한다. CLI examples export KIPRIS_PLUS_API_KEY = your-service-key python3 scripts/patent_search.py --query "배터리" python3 scripts/patent_search.py --query "배터리" --year 2024 --num-rows 5 python3 scripts/patent_search.py --application-number 1020240001234 Response policy 공식 KIPRIS Plus Open API 응답만 사용한다. 키가 없으면 KIPRIS_PLUS_API_KEY 또는 --service-key 를 정확히 안내한다. 검색 결과는 최소한 출원번호, 발명의명칭, 출원일자, 출원인, 초록을 포함해 정리한다. 상세 조회는 getBibliographyDetailInfoSearch 기준으로 공개/공고/등록 메타데이터를 함께 정리한다. API 에러 코드는 숨기지 말고 그대로 surfaced 한다. Done when 유효한 ServiceKey로 getWordSearch 또는 getBibliographyDetailInfoSearch 호출이 가능하다. helper가 JSON을 출력한다. 에러 시 KIPRIS_PLUS_API_KEY / ServiceKey 관련 안내가 분명하다. 응답에 출원번호와 발명의명칭이 포함된다. Notes KIPRIS Plus 포털: https://plus.kipris.or.kr/portal/data/service/List.do?subTab=SC001&entYn=N&menuNo=200100 공공데이터포털 문서: https://www.data.go.kr/data/15058788/openapi.do v1 helper는 getWordSearch , getBibliographyDetailInfoSearch 두 operation에 집중한다. 공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.