linkfox-zhihuiya-fulltext-image

Zhihuiya 特許全文画像

このスキルでは、Zhihuiya の特許データサービスを使用して、特許文書から全文画像（図面、図、ダイアグラム）を取得する方法を説明します。特許に含まれる視覚的なコンテンツにアクセスし、分析できるよう支援します。

主な概念

特許全文画像とは、特許文書に埋め込まれた図、図面、ダイアグラムです。発明の技術的な詳細を理解するうえで不可欠です。このツールは Zhihuiya の特許データベースを検索し、指定された特許の画像メタデータ（ダウンロードパスや画像タイプなど）を返します。

検索方法：画像は、特許 ID（内部識別子）または公開番号（US20230012345A1 や CN115000000A など、公開されている特許番号）のいずれかで検索できます。少なくとも一方を指定する必要があります。

パラメーターガイド

パラメーター	API 名	必須	説明	例
特許 ID	patentId	いいえ*	特許の内部識別子	8a7b6c5d-...
公開番号	patentNumber	いいえ*	公開された特許の公開番号／登録番号	US20230012345A1
件数	limit	いいえ	返す画像の最大数（最大 100、デフォルトは 100）	50
オフセット	offset	いいえ	画像結果のページネーション用オフセット	0

*patentId または patentNumber の少なくとも一方を指定する必要があります。

レスポンスフィールド

フィールド	説明
total	利用可能な画像レコードの総数
data	画像エントリの配列
data[].patentId	特許識別子
data[].pn	公開番号／登録番号
data[].fulltextImagePath	画像をダウンロードする URL パス
data[].imageType	画像のタイプ／カテゴリ
columns	列のレンダリングメタデータ
costToken	リクエストのトークンコスト
type	レンダリングスタイルのヒント

呼び出し方法

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

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

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

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

認証と計算リソースに関する問題の解決

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

異常な状況

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

使用例

1. 公開番号を指定して特許の全画像を取得する

Retrieve fulltext images for patent US20230012345A1.

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

2. 特許 ID を指定して特許の画像を取得する

Fetch the drawings for patent ID abc123def456.

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

3. ページネーションを使用して画像を取得する

Get the first 20 images for patent CN115000000A.

パラメーター：{"patentNumber": "CN115000000A", "limit": "20", "offset": "0"}

4. 次のページの画像を取得する

Get images 21-40 for patent CN115000000A.

パラメーター：{"patentNumber": "CN115000000A", "limit": "20", "offset": "20"}

表示ルール

1. データを明確に提示する：画像の結果は、画像の種類、ダウンロードパス、特許番号を含む構造化された表で表示します
2. 画像リンク：fulltextImagePath の値は常にクリック可能なリンクとして提示し、ユーザーが画像を直接表示またはダウンロードできるようにします
3. ページネーションの通知：total が返された結果数を超える場合は、さらに画像があることをユーザーに知らせ、次のページを取得するか確認します
4. エラー処理：クエリに失敗した場合は、理由を説明し、特許 ID または公開番号を確認するよう提案します
5. 捏造の禁止：特許 ID、公開番号、画像 URL を決して捏造せず、API から返されたデータのみを表示します
6. 合計数：特許で利用可能な画像の合計数を必ず伝えます

重要な制限事項

• 画像数の上限：各リクエストで返される画像は最大 100 件です
• 識別子が必須：patentId または patentNumber のいずれかを指定する必要があります
• すべてのパラメーターは文字列：limit や offset などの数値も、文字列として渡す必要があります

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

該当する -- 特許の視覚的コンテンツに関するリクエスト：

ユーザーの発言	シナリオ
「特許 XX の図面を見せて」	全文画像の取得
「この特許の図を取得して」	全文画像の取得
「XX の特許画像をダウンロードして」	全文画像の取得
「特許 XX にはどのような図が含まれていますか」	全文画像の一覧表示
「特許 XX には図がいくつありますか」	画像数の照会
「技術図面を見せて」	全文画像の取得

該当しない -- 特許の全文画像以外の情報が必要な場合：

• 特許のテキスト／要約／請求項の検索
• 特許ファミリーまたは引用分析
• 特許の法的ステータスの照会
• 特許権者または発明者の検索
• 特許と無関係な一般的な画像検索

計算リソース消費ルール

計算リソースを 81 消費します。

ユーザーは計算リソースの消費に応じて料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

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