linkfox-zhihuiya-patent-family

Zhihuiya Patent Family Explorer

このスキルでは、Zhihuiya（PatSnap）プラットフォームを通じて特許ファミリー情報を照会する方法を説明します。指定した特許のSimple Family、INPADOC Family、PatSnap Familyのメンバーを見つけるのに役立ちます。

呼び出し方法

• API エンドポイント：POST /zhihuiya/patentFamily（完全なパラメーター／レスポンス／エラーコードについては references/api.md を参照）
• Python スクリプト：python scripts/zhihuiya_patent_family.py '<JSON 参数>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッション内の同一パラメーターの組み合わせについては、デフォルトで一度だけ呼び出します。スクリプトには24時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードの変更、ページ送り、郵便番号の変更を試しながら自動的に連続検索してはいけません。検索を続ける必要がある場合は、追加のリソースを消費することを先にユーザーへ説明してください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-family-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動的にまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーを返します）
• レスポンス本文が8 KB以下の場合：ファイルに書き込んだ後、完全な JSON を stdout に出力します
• レスポンス本文が8 KBを超える場合：ファイルに書き込んだ後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭3件のサンプル）
• --inline を付けると、stdout への全量出力を強制します（同様にファイルにも書き込みます）

データの読み取りに関する推奨事項：まず要約を確認して十分かどうか判断してください。具体的なフィールドが必要な場合は、保存された json ファイルから jq または ConvertFrom-Json を使って必要な項目を抽出し、JSON 全体がコンテキストに入らないようにしてください。

認証と計算リソースの問題解決

次の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが401または402
• 計算リソースまたは残高が不足していることを示すレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの期限切れ／チャージが必要／チャージしてください」、または類似の意味の内容が含まれている場合。

コア概念

特許ファミリーとは、優先権主張によって互いに関連付けられた特許文書の集合です。ファミリーの定義が異なると、関連性の範囲も異なります。

• Simple Family：優先権出願の組み合わせが完全に同一の特許です。通常、異なる国に出願された直接的な対応特許を指します。
• INPADOC Family：欧州特許庁が定める、より広いグループです。直接的または間接的に、少なくとも1つの共通の優先権を持つ特許を関連付けます。
• PatSnap Family：PatSnap（Zhihuiya）独自のファミリー定義です。INPADOC のロジックを拡張し、追加のヒューリスティックを用いて、継続出願、分割出願、その他の関連出願を取り込みます。

レスポンス内の各特許には、simpleFamilyId、inpadocFamilyId、patsnapFamilyId がそれぞれ付与されており、各定義におけるファミリーグループの一意の識別子として機能します。

パラメーターガイド

検索パラメーターとして、次の2つのうち少なくとも1つを指定する必要があります。両方が指定されている場合は、特許 ID が優先されます。

パラメーター	型	必須	説明
patentId	string	条件付き	特許 ID。複数の値はカンマで区切ります。最大100件です。
patentNumber	string	条件付き	公開番号／公告番号。複数の値はカンマで区切ります。最大100件です。

ルール：

1. patentId または patentNumber の少なくとも一方を指定する必要があります。
2. 両方が指定されている場合、API は patentId を使用し、patentNumber を無視します。
3. 複数の値はカンマで区切ります（例："US10000001B2,EP3000001A1"）。
4. 1回のリクエストで指定できる特許は最大100件です。

レスポンスフィールド

フィールド	型	説明
total	integer	返された特許レコード数
data	array	特許ファミリーの結果オブジェクトのリスト
data[].patentId	string	このレコードの特許 ID
data[].pn	string	公開番号／公告番号
data[].simpleFamilyId	integer	Simple Family グループの一意の識別子
data[].simpleFamily	array	Simple Family に属する特許のリスト
data[].inpadocFamilyId	integer	INPADOC Family グループの一意の識別子
data[].inpadocFamily	array	INPADOC Family に属する特許のリスト
data[].patsnapFamilyId	integer	PatSnap Family グループの一意の識別子
data[].patsnapFamily	array	PatSnap Family に属する特許のリスト
columns	array	表示用の列定義
costToken	integer	このリクエストで消費されたトークン数
type	string	表示スタイルのヒント

使用例

1. 公開番号で特許ファミリーを検索する

「US10000001B2 の特許ファミリーを検索してください」

次のように呼び出します：

{"patentNumber": "US10000001B2"}

2. 複数の特許のファミリーを一度に検索する

「次の特許の INPADOC ファミリーを表示してください：EP3000001A1、CN112345678A、JP2020123456A」

次のように呼び出します：

{"patentNumber": "EP3000001A1,CN112345678A,JP2020123456A"}

3. 特許 ID で検索する

「特許 ID 5af83e12-xxxx-xxxx-xxxx-xxxxxxxxxxxx の特許ファミリーを取得してください」

次のように呼び出します：

{"patentId": "5af83e12-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

4. ファミリーの範囲を比較する

「US20200012345A1 の Simple Family と INPADOC Family の違いを確認したいです」

次のように呼び出します：

{"patentNumber": "US20200012345A1"}

その後、レスポンス内の simpleFamily と inpadocFamily の配列を比較します。

表示ルール

1. データを分かりやすく表示する：特許ファミリーの結果は、適切に構成された表で表示します。ユーザーから比較を求められた場合は、ファミリーの種類（Simple、INPADOC、PatSnap）ごとにまとめます。
2. 件数を要約する：ユーザーが地理的な広がりをすぐに把握できるよう、ファミリーの種類ごとに見つかったファミリーメンバーの数を必ず示します。
3. 管轄地域を明示する：ファミリーメンバーを列挙する際は、特許の地理的な保護範囲を理解しやすいよう、対象となる国や地域を示します。
4. エラー処理：API がエラーを返した場合や結果が空の場合は、考えられる原因（特許番号の形式が無効、データベースに特許が見つからないなど）を説明し、修正方法を提案します。
5. 一括検索結果を整理する：複数の特許を検索する場合は、ユーザーが個々の結果を簡単に見つけられるよう、特許ごとに整理します。
6. 主観的な法的助言をしない：客観的なファミリーデータのみを提示します。特許の範囲、有効性、侵害について法的見解を示さないでください。

重要な制限事項

• 検索のみ：このツールは、既知の特許のファミリー情報を取得します。キーワードによる特許検索や全文検索はできません。
• 一括検索の上限：1 回のリクエストにつき、特許 ID または公開番号は最大 100 件です。
• データソース：ファミリーデータは Zhihuiya（PatSnap）のデータベースに基づいており、最新の特許庁公開情報と比べて若干遅れる場合があります。
• ファミリーメンバーの詳細情報：ファミリーメンバーの配列には概要オブジェクトが含まれます。特定のファミリーメンバーの書誌情報全体を取得するには、別途検索が必要になる場合があります。

ユーザーの表現とシナリオのクイックリファレンス

該当するケース -- 特許ファミリーおよび同等特許の検索：

ユーザーの発言	シナリオ
「XX の特許ファミリー」	ファミリーの直接検索
「この特許の同等特許は何ですか」	Simple ファミリーの検索
「この特許はどの国に出願されていますか」	ファミリーによる地理的範囲の確認
「INPADOC ファミリーメンバー」	広範なファミリー検索
「関連特許／兄弟特許」	ファミリーの調査
「Simple ファミリーと拡張ファミリーを比較」	複数の定義による比較
「これらの特許ファミリーを一括で確認」	ファミリーの一括検索

該当しないケース -- 特許ファミリー検索の範囲を超える依頼：

• キーワードまたは分類コードによる特許全文検索
• 特許の評価額または訴訟データ
• 実施自由性または侵害の分析
• 特許出願または審査手続き

計算リソース消費ルール

動的ルールに基づいて課金されます：計算リソースの消費量 = 81 × 返されたdataの件数。各件は特許ファミリーの結果 1 件として数えられます。

重要：このスキルのサービス料金は倍率に応じて動的に計算されるため、一度に大量の計算リソースを消費する可能性があります。必ずユーザーに注意を促し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出して報告します：

1. このスキルで説明されている機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載された方法でフィードバック API を呼び出します。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境 EC スキルをさらに利用するには、LinkFox Skills を設定してください。