linkfox-zhihuiya-description-data-translated

Zhihuiya 特許明細書（翻訳版）

このスキルでは、Zhihuiya データサービスを利用して、翻訳された特許明細書（仕様書）のテキストを取得する方法を説明します。中国語、英語、日本語への翻訳に対応しており、特許 ID または公開番号で特許を検索できます。

基本概念

特許明細書（「仕様書」とも呼ばれます）は、特許文書の技術的な全文です。このツールは、Zhihuiya の特許データベースからそのテキストの翻訳版を取得し、3 つの翻訳先言語：中国語（cn）、英語（en）、日本語（jp）に対応しています。

特許の明細書を取得できない場合、ツールでは、特許ファミリーの構成員（同じ発明を対象として別の管轄区域で出願された関連特許）の明細書で代用することもできます。

パラメーター

パラメーター	型	必須	説明
patentId	string	条件付き	特許 ID。patentId または patentNumber のいずれかを指定する必要があります。両方が指定された場合は、patentId が優先されます。複数の値はカンマで区切ります。最大 100 件です。
patentNumber	string	条件付き	公開（公告）番号。patentId または patentNumber のいずれかを指定する必要があります。複数の値はカンマで区切ります。最大 100 件です。
lang	string	いいえ	翻訳先の言語。対応する値：en（英語、デフォルト）、cn（中国語）、jp（日本語）。
replaceByRelated	integer	いいえ	元の明細書を取得できない場合に、特許ファミリーの構成員の明細書で代用するかどうかを指定します。1 = はい、0 = いいえ（デフォルト）。

主なルール

1. 識別子を少なくとも 1 つ指定する必要があります：patentId または patentNumber のいずれかを指定してください。「US10123456B2」のような公開番号が指定された場合は、patentNumber を使用してください。数値の特許 ID が指定された場合は、patentId を使用してください。
2. 優先順位：両方の識別子が指定された場合は、patentId が優先されます。
3. 一括クエリ：カンマ区切りの値を渡すことで、最大 100 件の特許を一度にクエリできます。
4. デフォルトの言語：ユーザーが言語を指定しない場合は、デフォルトで en（英語）を使用します。

呼び出し方法

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

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

• 常にレスポンス全体を <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-description-data-translated-<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. 公開番号を指定して特許明細書の英語訳を取得する

patentNumber: "US10123456B2"
lang: "en"

2. 特許 ID を指定して特許明細書の中国語訳を取得する

patentId: "abc123def"
lang: "cn"

3. 特許ファミリーの構成員による代替を指定した一括クエリ

patentNumber: "US10123456B2,EP3456789A1,CN112345678A"
lang: "en"
replaceByRelated: 1

4. 特定の特許の日本語訳

patentNumber: "JP2021012345A"
lang: "jp"

表示ルール

1. 翻訳文を明確に表示する：特許の説明文をそのまま表示してください。説明文が長い場合は、要約または最初のセクションを表示し、全文を利用できることをユーザーに伝えてください。
2. 代替を明示する：レスポンスに pnRelated が含まれる場合、説明文が同族特許から取得されたことを明確にユーザーに伝え、関連する公開番号を表示してください。
3. 結果をまとめる：複数の特許が返された場合は、各特許の説明文を明確に区別した構造化リストで表示してください。
4. エラー処理：実際のエラーを報告してください。翻訳結果が空であることだけでは、その特許が存在しないことや、同じ言語でのリクエストがすべてサポートされていないことの証明にはなりません。元の明細書を取得するには /zhihuiya/descriptionData を使用し、返された特許とテキストの言語を確認してください。指定された翻訳先の言語を維持し、黙って言語を切り替えたり、同族特許で代用したりしないでください。
5. 捏造しない：特許のテキストを決して創作したり、言い換えたりしないでください。API が返した内容のみを表示してください。

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

該当する -- 特許の説明文／明細書の翻訳に関するリクエスト：

ユーザーの発言	シナリオ
「この特許の説明文を英語に翻訳してください」	単一特許の翻訳
「特許 US10123456 の中国語版が必要です」	指定言語への翻訳
「これらの特許の明細書のテキストを取得してください」	複数特許の説明文の取得
「特許 CN112345678A には何が記載されていますか？」	特許の説明文の参照
「この特許の全文の日本語訳を表示してください」	日本語翻訳
「説明文が見つかりません。同族特許を試せますか？」	同族特許へのフォールバック

該当しない -- 特許の説明文の翻訳以外が必要な場合：

• 特許の検索または発見（キーワード／トピックによる特許の検索）
• 特許請求項の分析またはクレームチャートの作成
• 特許の法的状態または審査経過
• 特許の引用または参考文献の分析
• 特許ポートフォリオの分析または統計

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

動的なルールに基づいて課金されます：計算リソースの消費量 = 81 × 返された data の件数。1 件は特許明細書の翻訳結果 1 件です。

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

フィードバック：

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

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

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

---

高品質で専門的な越境 EC スキルをさらに利用するには、LinkFox Skills を設定してください。