| name | korean-patent-search |
| title | 한국 특허 정보 검색 |
| description | Search Korean patent and utility-model publications through the official KIPRIS Plus Open API with keyword search plus application-number detail lookup. |
| author | NomaDamas |
| author_url | https://github.com/NomaDamas/k-skill/tree/main/korean-patent-search |
| license | MIT |
| version | 0.1.0 |
| execution_mode | open |
| jurisdiction | kr |
| practice | ip |
| language | ko |
한국 특허 정보 검색
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
- 상세 조회
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 를 정확히 안내한다.