Summary
Searches Korean patent and utility model publications through the official KIPRIS Plus Open API. You pass keywords or an application number, get back structured JSON with bibliographic data including applicant names, abstracts, and publication metadata. The Python helper handles both the getWordSearch endpoint for keyword queries and getBibliographyDetailInfoSearch for detailed lookups by application number. You'll need an API key from the Korea public data portal, which the script reads from KIPRIS_PLUS_API_KEY. Useful if you're doing IP research in Korea and want programmatic access to patent filings without scraping the web interface. The v1 scope is intentionally narrow, covering the two most common search patterns.
Install to Claude Code
npx -y skills add nomadamas/k-skill --skill korean-patent-search --agent claude-codeInstalls into .claude/skills of the current project.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Files
SKILL.mdView on GitHub
한국 특허 정보 검색
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
- helper 환경변수:
- 설치된 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 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에 집중한다. - 공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →First SeenApr 16, 2026
