SKILL.md
唯讀
名稱
korean-patent-search
描述
透過官方 KIPRIS Plus Open API 以關鍵字搜尋及申請號詳細查詢,搜尋韓國專利及實用新型公開資料。
한국 특허 정보 검색
此技能功能
透過 KIPRIS Plus(키프리스 플러스) 官方 Open 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
- 必填:
工作流程
- 透過
KIPRIS_PLUS_API_KEY或--service-key取得 ServiceKey。從公共資料入口網站複製的 percent-encoded 值,輔助腳本會自動正規化處理。 - 若為關鍵字搜尋,呼叫
getWordSearch端點。 - 若為申請號詳細查詢,呼叫
getBibliographyDetailInfoSearch端點。 - 解析 XML 回應中的 header/body/items 結構。
- 將申請號、發明名稱、申請人、摘要、公開/公告/註冊元資料整理為 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 Open 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兩個操作。 - 根據公共資料入口網站說明,開發帳號自動核准,營運帳號需另行審核。






