Works with Paperclip
How Korean Patent Search fits into a Paperclip company.
Korean Patent Search drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.
S
SaaS FactoryPaired
Pre-configured AI company — 18 agents, 18 skills, one-time purchase.
$27$59
Explore packSource file
SKILL.md89 linesExpandCollapse
---name: korean-patent-searchdescription: Search Korean patent and utility-model publications through the official KIPRIS Plus Open API with keyword search plus application-number detail lookup.license: MITmetadata: category: ip locale: ko-KR phase: v1--- # 한국 특허 정보 검색 ## 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 1. `KIPRIS_PLUS_API_KEY` 또는 `--service-key` 로 ServiceKey를 확보한다. 공공데이터포털에서 복사한 percent-encoded 값도 helper가 한 번 정규화해서 그대로 받을 수 있다.2. 키워드 검색이면 `getWordSearch` endpoint를 호출한다.3. 출원번호 상세 조회면 `getBibliographyDetailInfoSearch` endpoint를 호출한다.4. XML 응답의 header/body/items 구조를 파싱한다.5. 출원번호, 발명의명칭, 출원인, 초록, 공개/공고/등록 메타데이터를 JSON으로 정리한다. ## CLI examples ```bashexport KIPRIS_PLUS_API_KEY=your-service-keypython3 scripts/patent_search.py --query "배터리"python3 scripts/patent_search.py --query "배터리" --year 2024 --num-rows 5python3 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에 집중한다.- 공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.