korean-patent-search

korean-patent-search

熱門

透過官方 KIPRIS Plus Open API 以關鍵字搜尋及申請號詳細查詢,搜尋韓國專利及實用新型公開資料。

6464星標
736分支
更新於 2026/7/23
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

工作流程

  1. 透過 KIPRIS_PLUS_API_KEY--service-key 取得 ServiceKey。從公共資料入口網站複製的 percent-encoded 值,輔助腳本會自動正規化處理。
  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 Open API 的回應。
  • 若缺少金鑰,會清楚提示 KIPRIS_PLUS_API_KEY--service-key
  • 搜尋結果至少包含申請號、發明名稱、申請日期、申請人、摘要。
  • 詳細查詢以 getBibliographyDetailInfoSearch 為基礎,一併整理公開/公告/註冊元資料。
  • API 錯誤碼不隱藏,直接顯示。

完成條件

  • 使用有效的 ServiceKey 可成功呼叫 getWordSearchgetBibliographyDetailInfoSearch
  • 輔助腳本輸出 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 輔助腳本專注於 getWordSearchgetBibliographyDetailInfoSearch 兩個操作。
  • 根據公共資料入口網站說明,開發帳號自動核准,營運帳號需另行審核。