한국 특허 정보 검색
What this skill does
KIPRIS Plus(키프리스 플러스) 공식 Open API로 한국 특허/실용신안 공개·공고 데이터를 검색한다.
v1 범위:
- 키워드 검색 (
getWordSearch) - 출원번호 기준 서지 상세 조회 (
getBibliographyDetailInfoSearch) - 구조화된 JSON 출력
- 표준
python3helper 동봉
When to use
- "배터리 관련 한국 특허 찾아줘"
- "출원번호 1020240001234 특허 요약 보여줘"
- "KIPRIS API로 특허 검색 결과를 JSON으로 받고 싶어"
- "출원인/IPC/초록까지 포함한 한국 특허 검색 결과가 필요해"
Prerequisites
- 인터넷 연결
python3- KIPRIS Plus에서 발급받은 API 키
- helper 환경변수: KIPRIS_PLUS_API_KEY - 실제 요청 쿼리 파라미터명: ServiceKey
- 설치된 skill payload 안에
scripts/patent_search.pyhelper 포함
Inputs
- 키워드 검색
- 필수: --query - 선택: --year - 선택: --page-no - 선택: --num-rows - 선택: --exclude-patent - 선택: --exclude-utility
- 상세 조회
- 필수: --application-number
Workflow
KIPRIS_PLUS_API_KEY또는--service-key로 ServiceKey를 확보한다. 공공데이터포털에서 복사한 percent-encoded 값도 helper가 한 번 정규화해서 그대로 받을 수 있다.- 키워드 검색이면
getWordSearchendpoint를 호출한다. - 출원번호 상세 조회면
getBibliographyDetailInfoSearchendpoint를 호출한다. - 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 1020240001234Response 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에 집중한다. - 공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.