korean-patent-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

한국 특허 정보 검색

韩国专利信息搜索

What this skill does

技能功能

KIPRIS Plus(키프리스 플러스) 공식 Open API로 한국 특허/실용신안 공개·공고 데이터를 검색한다.

v1 범위:

키워드 검색 (
```
getWordSearch
```
)
출원번호 기준 서지 상세 조회 (
```
getBibliographyDetailInfoSearch
```
)
구조화된 JSON 출력
표준
```
python3
```
helper 동봉

通过KIPRIS Plus（키프리스 플러스）官方Open API检索韩国专利/实用新型的公开、公告数据。

v1版本支持范围：

关键词搜索（
```
getWordSearch
```
）
基于申请号的书目信息详情查询（
```
getBibliographyDetailInfoSearch
```
）
结构化JSON输出
附带标准
```
python3
```
辅助工具

When to use

适用场景

"배터리 관련 한국 특허 찾아줘"
"출원번호 1020240001234 특허 요약 보여줘"
"KIPRIS API로 특허 검색 결과를 JSON으로 받고 싶어"
"출원인/IPC/초록까지 포함한 한국 특허 검색 결과가 필요해"

"帮我查找和电池相关的韩国专利"
"给我展示申请号1020240001234的专利摘要"
"我想通过KIPRIS API获取JSON格式的专利搜索结果"
"我需要包含申请人/IPC/摘要在内的韩国专利搜索结果"

Prerequisites

前置要求

인터넷 연결
```
python3
```
KIPRIS Plus에서 발급받은 API 키
- helper 환경변수:
```
KIPRIS_PLUS_API_KEY
```
- 실제 요청 쿼리 파라미터명:
```
ServiceKey
```
설치된 skill payload 안에
```
scripts/patent_search.py
```
helper 포함

互联网连接
```
python3
```
环境
从KIPRIS Plus申请的API密钥
- 辅助工具读取的环境变量：
```
KIPRIS_PLUS_API_KEY
```
- 实际请求的查询参数名：
```
ServiceKey
```
已安装的skill payload中包含
```
scripts/patent_search.py
```
辅助脚本

Inputs

输入参数

키워드 검색

필수:
```
--query
```
선택:
```
--year
```
선택:
```
--page-no
```
선택:
```
--num-rows
```
선택:
```
--exclude-patent
```
선택:
```
--exclude-utility
```

상세 조회
- 필수:
```
--application-number
```

关键词搜索
- 必填：
```
--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으로 정리한다.

通过
```
KIPRIS_PLUS_API_KEY
```
或
```
--service-key
```
参数获取ServiceKey，从公共数据门户复制的百分号编码值也可直接传入，辅助工具会自动完成标准化处理。
如果是关键词搜索，则调用
```
getWordSearch
```
接口。
如果是申请号详情查询，则调用
```
getBibliographyDetailInfoSearch
```
接口。
解析XML响应的header/body/items结构。
将申请号、发明名称、申请人、摘要、公开/公告/登记元数据整理为JSON格式。

CLI examples

CLI使用示例

bash

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

bash

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 한다.

仅使用KIPRIS Plus Open API的官方响应结果。
缺少密钥时明确提示需要设置
```
KIPRIS_PLUS_API_KEY
```
或传入
```
--service-key
```
参数。
搜索结果至少包含申请号、发明名称、申请日期、申请人、摘要信息。
详情查询基于
```
getBibliographyDetailInfoSearch
```
接口返回结果，同步整理公开/公告/登记元数据。
API错误码不做隐藏，直接对外透出。

Done when

完成标准

유효한 ServiceKey로
```
getWordSearch
```
또는
```
getBibliographyDetailInfoSearch
```
호출이 가능하다.
helper가 JSON을 출력한다.
에러 시
```
KIPRIS_PLUS_API_KEY
```
/
```
ServiceKey
```
관련 안내가 분명하다.
응답에 출원번호와 발명의명칭이 포함된다.

持有效的ServiceKey可成功调用
```
getWordSearch
```
或
```
getBibliographyDetailInfoSearch
```
接口。
辅助工具可正常输出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에 집중한다.

공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.

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版本的辅助工具仅聚焦
```
getWordSearch
```
、
```
getBibliographyDetailInfoSearch
```
两个操作。
根据公共数据门户的说明，开发账号自动审批通过，运营账号需要单独审核。