linkfox-zhihuiya-pdf

Zhihuiya Patent PDF Downloader

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

コアコンセプト

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

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

ファミリー特許への置き換え：特許自体の PDF が利用できない場合、関連するファミリー特許の PDF を代わりに返すよう指定できます。

パラメーターガイド

パラメーター	型	必須	説明
patentId	string	条件付き	特許 ID。patentId または patentNumber のいずれかを指定する必要があります。複数の値はコンマで区切ります。最大 100 件です。
patentNumber	string	条件付き	公開番号／公告番号。patentId または patentNumber のいずれかを指定する必要があります。複数の値はコンマで区切ります。最大 100 件です。
replaceByRelated	string	いいえ	元の特許が利用できない場合に、ファミリー特許の 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 の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し規約、リクエストパラメーター、レスポンス構造については references/api.md を参照してください。scripts/zhihuiya_pdf_data.py を直接実行して検索することもできます。

使用例

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 の少なくとも一方を指定する必要があります。両方が空の場合、リクエストは失敗します。
• 優先順位：両方の識別子が指定されている場合は、patentId が patentNumber より優先されます。
• PDF の利用可否：すべての特許で PDF を利用できるとは限りません。特許ファミリーの特許にフォールバックするには、replaceByRelated オプションを使用してください。

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

該当する — 特許 PDF ドキュメントの取得タスク：

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

該当しない — 特許 PDF の取得を超えるニーズ：

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

フィードバック：

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

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

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

大きなレスポンスの処理

エージェントのコンテキストがあふれないように、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください：

python scripts/response_io.py run --script scripts/zhihuiya_pdf_data.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリー外（Unix では /tmp/...、Windows では %TEMP%/... など）に指定してください。保存されたレスポンスには、PII、価格情報、認証に関わる機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、タスクが完了したら削除してください。

run はレスポンス全体をファイルに書き込み、スキーマのプレビューとファイルパスだけを出力します。read は指定したフィールドを抽出し、スライスには --limit/--offset、出力形式には --format json|jsonl|csv|table を使用できます。

このパターンを優先する場合 — レスポンスの特性に基づいて判断してください。たとえば：

• レコードあたりのフィールド数が多い場合、または不要なフィールドがある場合
• 一括処理やページネーションされた結果（1 回の呼び出しで複数の項目が返る場合）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐに使用せず、後続のステップでも出力を再利用する場合

小規模で一度しか使用しないレスポンスの場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューは、切り詰められたスキーマとサンプルであり、データ全体ではありません。フィールド単位の判断を行う場合は、read を使って保存済みファイルから読み込んでください。

---

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