kipris-cli — 韓国特許/商標/意匠検索（KIPRIS Plus）

KIPRIS Plus OpenAPI（특허청 韓国特許情報院）をラップする5つのサブコマンド — 韓国の公式IP データベースで、約500万件の特許、約600万件の商標、約100万件の意匠をカバーしています。すべてのエンドポイントは XML を返しますが、このスキルは AIエージェント向けに JSONL に正規化します。

重要な理由：韓国の IP 検索は通常、kipris.or.kr の Web UI でロックされています。先行技術調査、M&A 対象デューデリジェンス、ブランド名利用可能性確認を行う AI エージェントは、クリーンな JSON アクセスが必要です。この公開時点で、KIPRIS をカバーしている唯一の ClawHub スキルです。

クイックスタート

export KIPRIS_PLUS_KEY="<your-32-char-key>"   # plus.kipris.or.kr から取得（無料、承認は約1日）

# キーワードで特許検索
bin/kipris-cli patent --word "양자컴퓨팅" --rows 10

# 商標の利用可能性確認
bin/kipris-cli trademark --word "AURORA" --rows 5

# 意匠検索
bin/kipris-cli design --word "smart watch"

# 出願番号で特許の書誌的詳細を取得
bin/kipris-cli patent-detail --app-no 1020230012345

# 出願人名で特許を検索（個人/法人）
bin/kipris-cli applicant --name "삼성전자주식회사" --rows 20

サブコマンド

コマンド	エンドポイント	ユースケース
patent	patUtiModInfoSearchSevice/patUtiModInfoSearch	特許 + 実用新案のキーワード検索
trademark	TrademarkInfoSearchService/trademarkInfoSearchInfo	ブランド利用可能性 + 競合商標監視
design	DesignInfoSearchService/designInfoSearchInfo	工業意匠検索
patent-detail	patUtiModInfoSearchSevice/patUtiModBibliographicInfoSearch	出願番号による完全な書誌情報
applicant	patUtiModInfoSearchSevice/patUtiModInfoSearchByApplicantName	出願人による全出願

共通フラグ

• --word "<query>" — フリーテキスト検索（韓国語または英語、UTF-8）
• --app-no <13-digit> — 出願番号（1020230012345 = 특허、4020210012345 = 상표、3020230012345 = 디자인）
• --rows N — ページサイズ（デフォルト 30、最大 500）
• --page N — 1 インデックス付きページ（デフォルト 1）
• --format json|xml|jsonl — 出力形式（デフォルト jsonl）
• --key <KEY> — $KIPRIS_PLUS_KEY を上書き

特許固有フィルター（サブコマンド patent）

• --applicant "<name>" — 出願人名
• --inventor "<name>" — 発明者名
• --ipc "<code>" — IPC 分類（例：G06N）
• --pat true|false — 特許を含める（デフォルト true）
• --utility true|false — 実用新案を含める（デフォルト true）
• --last-update YYYYMMDD — 最終変更日以降

商標固有フィルター（サブコマンド trademark）

• --applicant "<name>"
• --class "<NICE int>" — 商品分類（NICE 分類 1-45）
• --reg-status "registered|pending|rejected|expired" — 権利状態
• --start-date YYYYMMDD / --end-date YYYYMMDD — 出願日の範囲

出力スキーマ（JSONL）

各行は 1 件のレコード（特許/商標/意匠）です。タイプ全体で正規化された共通フィールド：

{
  "type": "patent",
  "app_no": "1020230012345",
  "title_ko": "양자 회로 최적화 방법 및 장치",
  "title_en": "Method and apparatus for quantum circuit optimization",
  "applicant": "삼성전자주식회사",
  "inventors": ["홍길동", "김철수"],
  "app_date": "20230101",
  "reg_no": null,
  "reg_date": null,
  "pub_no": "1020240054321",
  "pub_date": "20240715",
  "ipc": ["G06N10/40", "G06F17/14"],
  "abstract": "..."
}

商標には nice_class、tm_kind（文字/図形/立体）が追加されます。意匠には locarno_class、parts が追加されます。

セットアップ — KIPRIS_PLUS_KEY の取得

1. https://plus.kipris.or.kr でサインアップ（無料、法人または個人）。
2. マイページ → API 申請 → 無料クォータ（月 10,000件）。
3. 承認は通常、個人は同一営業日、法人は 2～3 日です。
4. 32 文字の ServiceKey をコピーして export KIPRIS_PLUS_KEY=... に設定します。

⚠️ レガシーの kipris.or.kr API エンドポイントは 2024Q4 以降廃止されています。このスキルは最新の plus.kipris.or.kr/kipo-api/kipi/... パスを使用します。

例

• examples/competitor-patent-watch.sh — 競合他社が出願した新特許の日次 JSONL フィード（ページネーション対応、重複排除）。
• examples/brand-availability-check.sh — ブランド名が NICE クラス 9、35、42（典型的な SaaS クラス）で商標出願されているかを確認。
• examples/m-and-a-ip-snapshot.sh — 事業者登録番号（nts-bizno-cli 経由）→ 法人名 → すべての KIPRIS 出願 → 統合 CSV。opendart-cli と組み合わせると、完全な M&A デューデリジェンスチェーンになります。

関連スキル

• opendart-cli — 企業公開情報（IP vs 財務デューデリジェンスのペア用）
• nts-bizno-cli — KYB ビジネスナンバー検索（法人名のアンカー）
• juso-address-cli — 登録住所解決
• kosis-cli — R&D 投資統計オーバーレイ

制限

• クォータ：無料ティアは月 10,000 呼び出しです。各 patent --rows 30 --page 1 = 1 呼び出し。スキルはキャッシュをしません — 呼び出し側がページネーションのスロットリングを担当します。
• レイテンシ：典型的には呼び出しごと 200～800ms。
• レート制限：KIPRIS Plus からの ハードキャップは 30 req/sec。バルク操作は呼び出し間に 0.05s のスリープが必要です。

ライセンス

MIT-0。保証なし。公開されている KIPRIS Plus OpenAPI 仕様のみを使用して構築されています。