linkfox-zhihuiya-pdf-data

Zhihuiya 特許 PDF ダウンローダー

このスキルでは、Zhihuiya の特許データベースから特許の PDF 全文ダウンロードリンクを取得する方法を説明します。特許 ID または公開番号で検索できます。

主な概念

Zhihuiya 特許 PDF サービスでは、世界中の特許の PDF 全文ドキュメントを直接ダウンロードできるリンクを提供しています。特許 ID または 公開番号（公開公告番号とも呼ばれます）で検索でき、1 回のリクエストで最大 100 件の特許を取得できます。

検索の優先順位：patentId と patentNumber の両方が指定されている場合、サービスは最初に patentId を使用します。両方の識別子が利用できる場合は、この点に注意してください。

ファミリー特許による代替：特許自身の PDF を取得できない場合、関連するファミリー特許の PDF を代わりに返すよう、サービスに指定できます。

パラメーターガイド

パラメーター	型	必須	説明
patentId	string	条件付き	特許 ID。patentId または patentNumber のいずれかを必ず指定してください。複数の値はカンマで区切ります。最大 100 件です。
patentNumber	string	条件付き	公開番号／公告番号。patentId または patentNumber のいずれかを必ず指定してください。複数の値はカンマで区切ります。最大 100 件です。
replaceByRelated	string	いいえ	元の特許の PDF を取得できない場合、ファミリー特許の PDF で代替するかどうかを指定します。1 = はい、0 = いいえです。デフォルトでは代替しません。

適切な識別子の選び方

• 特許 ID（patentId）：Zhihuiya システム内で使用される内部数値識別子です。ユーザーが Zhihuiya 固有の ID を指定した場合に使用します。
• 公開番号（patentNumber）：一般に公開されている特許番号です（例：US20230012345A1、CN115000000A）。ユーザーが標準的な特許番号を指定した場合に使用します。

レスポンスフィールド

フィールド	説明
total	返されたレコード数
data	特許オブジェクトの配列。各オブジェクトにはダウンロード情報が含まれます
data[].patentId	特許 ID
data[].pn	公開番号／公告番号
data[].pdfPath	PDF 全文のダウンロード URL
data[].pnRelated	代替されたファミリー特許の公開番号（ファミリー特許による代替が使用された場合のみ存在）
costToken	リクエストで消費されたトークン数

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-pdf-data-<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／プランの期限切れ／チャージが必要／チャージしてください」など、同様の意味の内容が含まれています。

使用例

1. 公開番号で特許を 1 件検索

Retrieve the PDF for patent publication number US20230012345A1.

パラメーター：{"patentNumber": "US20230012345A1"}

2. 公開番号で複数の特許を検索

Download PDFs for CN115000000A, CN115000001A, and CN115000002A.

パラメーター：{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}

3. 特許 ID で特許を 1 件検索

Get the full-text PDF for patent ID 12345678.

パラメーター：{"patentId": "12345678"}

4. ファミリー特許による代替を有効にする

Download the PDF for EP4000000A1. If it is unavailable, use a family patent PDF instead.

パラメーター：{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}

5. 特許 ID で一括ダウンロード

Retrieve PDFs for patent IDs 11111111, 22222222, 33333333.

パラメーター：{"patentId": "11111111,22222222,33333333"}

表示ルール

1. ダウンロードリンクを明確に表示する：特許ごとに、公開番号と PDF のダウンロードリンクを見やすい表またはリスト形式で表示します。
2. 代替を明示する：ファミリー特許による代替で PDF が提供された場合は、その旨を明記し、どのファミリー特許が使用されたかが分かるように pnRelated の値を表示します。
3. 一括結果：複数の特許が返された場合は、「公開番号」「特許 ID」「PDF リンク」「代替に関する注記（該当する場合）」の列を含む表で表示します。
4. エラー処理：クエリに失敗した場合、または結果がない場合は、その理由を説明し、特許 ID または公開番号を確認するよう提案します。replaceByRelated が有効になっていない場合は、代替として有効にするよう提案します。
5. PDF がない場合：特許エントリが pdfPath なしで返された場合は、PDF を利用できないことを伝え、ファミリー特許による代替を有効にするよう提案します。

重要な制限事項

• 一括処理の上限：1 リクエストあたり最大 100 件の特許です。
• 識別子の要件：patentId または patentNumber の少なくとも 1 つを指定する必要があります。両方が空の場合、リクエストは失敗します。
• 優先ルール：両方の識別子が指定された場合は、patentId が patentNumber より優先されます。
• PDF の利用可能性：PDF を利用できない特許もあります。ファミリー特許で代替するには、replaceByRelated オプションを使用してください。

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

該当する -- 特許 PDF 文書の取得タスク：

ユーザーの発言	シナリオ
"特許 XX の PDF をダウンロードして"	単一特許の PDF 取得
"これらの特許の全文書を取得して"	特許 PDF の一括ダウンロード
"公開番号 XX の PDF が必要です"	公開番号による検索
"直接入手できない場合でも特許文書を取得できますか"	ファミリー特許による代替のシナリオ
"特許 PDF を一括エクスポートして"	複数特許の一括ダウンロード

該当しない -- 特許 PDF の取得以外のニーズ：

• 特許の検索または発見（キーワード、譲受人などによる特許の検索）
• 特許の引用または法的状態の分析
• 特許請求項の解釈または翻訳
• 特許ポートフォリオの分析またはランドスケープのマッピング

算力消耗规则

动态计费规则：消耗算力 = 81 × 返回 data 条数。每条为 1 条专利 PDF 结果

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

Feedback:

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

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

references/api.md に記載されているとおりに Feedback API を呼び出してください。ユーザーの操作を中断しないでください。

---

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