linkfox-zhihuiya-patent-cited

Zhihuiya 特許引用エクスプローラー

このスキルでは、Zhihuiya（PatSnap）の特許引用データを照会する方法を説明し、特定の特許の引用状況をユーザーが把握できるよう支援します。

基本概念

特許引用分析からは、特許がその技術分野でどの程度の影響力を持つかがわかります。特許 B が先行技術の項目で特許 A を引用している場合、特許 A は特許 B に「引用されている」といいます。引用数が多いほど、一般に技術的重要性が高く、業界への影響も広いことを示します。

主な指標：

• 3 年間の引用数（citedBy3y）：公開から 3 年以内にその特許が引用された回数です。初期段階での影響を示します。
• 5 年間の引用数（citedBy5y）：5 年以内にその特許が引用された回数です。中期的な影響を示します。
• シンプルファミリーの引用数（citedBySimpleFamily）：その特許を引用しているシンプル特許ファミリーのメンバー数です。
• INPADOC ファミリーの引用数（citedByInpadocFamily）：その特許を引用している INPADOC 特許ファミリーのメンバー数です。
• PatSnap ファミリーの引用数（citedByPatsnapFamily）：その特許を引用している PatSnap 定義の特許ファミリーメンバー数です。

パラメーターガイド

以下の識別子を少なくとも 1 つ指定する必要があります。両方指定した場合は、特許 ID が優先されます。

パラメーター	説明	例
patentId	Zhihuiya の内部特許 ID。複数の ID はコンマで区切ります（最大 100 件）。	abc123def456
patentNumber	公開番号／公報番号。複数の番号はコンマで区切ります（最大 100 件）。	US10123456B2, CN112345678A

重要：patentId または patentNumber の少なくとも一方が必要です。ユーザーが公開番号（例：「US10123456B2」）を指定した場合は、patentNumber を使用します。内部 ID を指定した場合は、patentId を使用します。

使用例

1. 公開番号による単一特許の引用照会 クエリ：「特許 US10123456B2 の引用数はいくつですか？」

{
  "patentNumber": "US10123456B2"
}

2. 複数特許の引用数の比較 クエリ：「CN112345678A と CN113456789B の引用数を比較してください」

{
  "patentNumber": "CN112345678A,CN113456789B"
}

3. 特許 ID による照会 クエリ：「特許 ID abc123def456 の引用データを取得してください」

{
  "patentId": "abc123def456"
}

4. 複数 ID による一括照会 クエリ：「次の特許 ID の引用情報：id001, id002, id003」

{
  "patentId": "id001,id002,id003"
}

表示ルール

1. データを表で提示する：引用結果は、明確で構造化された表で示します。公開番号、3 年間の引用数、5 年間の引用数、ファミリーの引用数を含めます。
2. 主要指標を強調する：複数の特許を比較する場合、引用数が最も多い特許を強調します。
3. ファミリーの種類を説明する：ユーザーが特許ファミリーに詳しくない場合は、Simple、INPADOC、PatSnap のファミリー定義の違いを簡潔に説明します。
4. 引用特許の詳細：応答に引用した特許の詳細を含む citedByPatents 配列がある場合は、サブテーブルまたは展開可能なリストで表示します。
5. エラー処理：クエリに失敗した場合は、応答に基づいて理由を説明し、特許番号または ID が正しいか確認するよう提案します。
6. 主観的な助言をしない：特許の価値や投資判断について評価せず、事実に基づく引用データを提示します。

呼び出し方法

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

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

• 常に完全な応答を <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-cited-<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／プランの有効期限切れ／チャージが必要／チャージしてください」または類似の内容が含まれています。

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

該当する -- 特許引用分析のシナリオ：

ユーザーの発言	シナリオ
「この特許は何回引用されていますか」	基本的な引用数
「この特許を引用している特許はどれですか」	引用特許の一覧
「特許の影響分析」	引用に基づく影響度
「特許間の引用数を比較」	複数特許の比較
「3年間／5年間の引用数」	期間別の引用指標
「特許ファミリーの引用データ」	ファミリーレベルの引用分析
「特許Xの前方引用」	被引用検索の同義語

該当しない -- 特許引用データの範囲を超える内容：

• 特許全文検索またはセマンティック検索
• 特許の法的状態または審査履歴
• 特許の評価またはライセンスに関する推奨
• 後方引用（特許が引用した文献）

計算リソースの消費ルール

動的ルールに基づいて課金されます：消費する計算リソース = 81 × 返されるdataの件数。各件は、特許が引用された結果1件に相当します。

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

フィードバック：

以下のいずれかに該当する場合は、Feedback APIを通じてフィードバックを自動検出して報告してください。

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

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

---

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