korean-patent-search

한국 특허 정보 검색

本技能的功能

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

v1范围：

• 关键词搜索（getWordSearch）
• 按申请号查询书目详细信息（getBibliographyDetailInfoSearch）
• 结构化JSON输出
• 附带标准python3辅助脚本

使用场景

• “帮我找找电池相关的韩国专利”
• “显示申请号1020240001234的专利摘要”
• “我想通过KIPRIS API以JSON格式获取专利搜索结果”
• “需要包含申请人/IPC/摘要的韩国专利搜索结果”

前提条件

• 网络连接
• python3
• 从KIPRIS Plus获取的API密钥
  • 辅助脚本环境变量：KIPRIS_PLUS_API_KEY
  • 实际请求查询参数名：ServiceKey
• 已安装的技能包中包含scripts/patent_search.py辅助脚本

输入参数

• 关键词搜索
  • 必填：--query
  • 可选：--year
  • 可选：--page-no
  • 可选：--num-rows
  • 可选：--exclude-patent
  • 可选：--exclude-utility
• 详细查询
  • 必填：--application-number

工作流程

1. 通过KIPRIS_PLUS_API_KEY或--service-key获取ServiceKey。辅助脚本可以接收从公共数据门户复制的百分比编码值，并自动规范化。
2. 如果是关键词搜索，调用getWordSearch端点。
3. 如果是申请号详细查询，调用getBibliographyDetailInfoSearch端点。
4. 解析XML响应中的header/body/items结构。
5. 整理申请号、发明名称、申请人、摘要、公开/公告/注册元数据为JSON。

CLI示例

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

响应策略

• 仅使用官方KIPRIS Plus开放API响应。
• 如果缺少密钥，准确提示KIPRIS_PLUS_API_KEY或--service-key。
• 搜索结果至少包含申请号、发明名称、申请日期、申请人、摘要。
• 详细查询基于getBibliographyDetailInfoSearch，同时整理公开/公告/注册元数据。
• API错误代码不应隐藏，直接暴露。

完成条件

• 使用有效的ServiceKey能够调用getWordSearch或getBibliographyDetailInfoSearch。
• 辅助脚本输出JSON。
• 出错时明确提示KIPRIS_PLUS_API_KEY/ServiceKey相关信息。
• 响应中包含申请号和发明名称。

备注

• 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两个操作。
• 根据公共数据门户指南，开发账户自动批准，运营账户需单独审核。