韓国特許情報検索

このスキルが実行すること

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を取得します。公共データポータルからコピーしたパーセント エンコード値もヘルパーが一度正規化して、そのまま受け取ることができます。
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エラーコードは隠さずそのままsurfaceします。

完了条件

• 有効な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 の2つのoperationに集中します。
• 公共データポータルの案内基準により、開発アカウントは自動承認、運用アカウントは別途審査対象です。