linkfox-eureka-description-translated

Eureka 特許明細書の翻訳

このスキルでは、Eureka 特許データプラットフォームを通じて、翻訳済みの特許明細書（明細書本文）を取得する方法を説明します。中国語、英語、日本語への翻訳に対応しており、特許 ID または公開番号で特許を検索できます。

基本概念

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

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

パラメーターガイド

パラメーター	型	必須	説明
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（英語）を使用します。

レスポンスフィールド

フィールド	説明
total	返された特許レコードの数
data	特許オブジェクトの配列（以下を参照）
data[].patentId	内部特許 ID
data[].pn	公開（公告）番号
data[].description	翻訳された特許明細書のテキスト
data[].pnRelated	代替に使用されたファミリー特許の公開番号（ファミリー特許による置き換えが行われた場合のみ存在）
costToken	このリクエストで消費されたトークン

使用例

1. 公開番号で特許明細書の英語訳を取得

Get the English description for patent US10123456B2.

パラメーター：patentNumber = "US10123456B2"、lang = "en"

2. 特許 ID で特許明細書の中国語訳を取得

Get the Chinese translation of description for patent ID abc123def.

パラメーター：patentId = "abc123def"、lang = "cn"

3. ファミリー特許へのフォールバックを使った一括検索

Get English descriptions for US10123456B2, EP3456789A1, CN112345678A. Use family patents if unavailable.

パラメーター：patentNumber = "US10123456B2,EP3456789A1,CN112345678A"、lang = "en"、replaceByRelated = 1

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

Translate the description of JP2021012345A to Japanese.

パラメーター：patentNumber = "JP2021012345A"、lang = "jp"

5. ファミリー特許へのフォールバックを使った中国語訳

查询专利US10123456B2的中文说明书，如果没有就用同族专利替代。

パラメーター：patentNumber = "US10123456B2"、lang = "cn"、replaceByRelated = 1

表示ルール

1. 翻訳文を明確に表示する：特許の説明文をそのまま表示してください。説明文が長い場合は、要約または最初のセクションを表示し、全文を利用できることをユーザーに伝えてください。
2. 置き換えを明示する：応答に pnRelated が含まれる場合、説明文がファミリー特許から取得されたことをユーザーに明確に伝え、関連する公開番号を表示してください。
3. 結果をまとめて表示する：複数の特許が返された場合は、各特許の説明文を明確に分け、構造化されたリストで表示してください。
4. エラー処理：クエリに失敗した場合は、応答に基づいて理由を説明し、特許 ID または公開番号が正しいか確認するよう提案してください。
5. 捏造しない：特許文を決して創作したり言い換えたりしないでください。API が返した内容のみを表示してください。

呼び出し方法

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

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

• 常に完全な応答を <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-description-translated-<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 で抽出してください。

認証とクレジットの問題を解決する

以下の異常が発生した場合は、次の対処を行ってください。

異常な状況

• API Key が設定されていない：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• 応答のステータスコードが 401 または 402
• 応答にクレジットまたは残高不足の通知がある：メッセージに「クレジット残高不足／請求額不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれています。

対処

• まず skill 内の onboarding.md を使って、問題の解決方法を案内してください。
• onboarding.md ファイルが見つからない場合は、/linkfox-onboarding skill を読み込み、その案内に従って対処してください。インストールされていない場合は、まずインストールしてください：
  • https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip をダウンロードして解凍し、この skill をインストールします。ダウンロードにユーザーの許可が必要な場合は、ユーザーに許可を求めてください。自分の判断でダウンロードを諦めてはいけません。
• 最終手段：上記 2 つの対処をすべて試しても解決できない場合に限り、https://skill.linkfox.com/linkfoxskills/guide.htm の案内に従って API Key を取得するか、https://os.linkfox.com/ でクレジットを追加するようユーザーに伝えてください。

重要な制限事項

• 識別子が必要：特許 ID または公開番号を少なくとも 1 つ指定する必要があります。このツールではキーワード検索を実行できません。
• 翻訳言語：対応言語は中国語（cn）、英語（en）、日本語（jp）のみです。
• 説明文のみ：このツールが返すのは説明書の本文のみであり、タイトル、要約、請求項は返しません。
• ファミリー特許への置き換えは任意：代替となるファミリー特許の説明文は、replaceByRelated = 1 を明示的に指定した場合のみ提供されます。
• 一括処理の上限：1 回のリクエストにつき、特許は最大 100 件です。

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

該当するケース -- 特許の説明／明細書の翻訳に関する問い合わせ：

ユーザーの発言	シナリオ
「この特許の説明を英語に翻訳してください」	単一の特許の翻訳
「特許 US10123456 の日本語版が必要です」	特定言語への翻訳
「これらの特許の明細書のテキストを取得してください」	特許説明の一括取得
「特許 CN112345678A には何が記載されていますか？」	特許説明の検索
「この特許の全文の日本語訳を見せてください」	日本語への翻訳
「説明が見つかりません。ファミリーメンバーを試してもらえますか？」	ファミリーメンバーへのフォールバック

該当しないケース -- 特許の説明の翻訳以外のニーズ：

• 特許の検索や発見（キーワードやトピックによる特許の検索）
• 特許の請求項の分析やクレームチャートの作成
• 特許の法的ステータスや審査経過
• 特許の引用や参照の分析
• 特許ポートフォリオの分析や統計

境界ケース -- 判断が必要な場合：

• ユーザーが「特許の全文」を指定なしで求めた場合は、説明、請求項、要約のどれを希望するか確認してください。
• ユーザーが100件を超える特許を提示した場合は、複数のバッチに分割してください。

クレジット消費ルール

動的ルールに基づいて課金されます：消費クレジット数 = 81 × max（返却件数, 1）。

重要：このスキルのサービス料金は倍率に応じて動的に計算されるため、一度に大量のクレジットを消費する可能性があります。必ずユーザーに伝え、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

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

---

高品質でプロフェッショナルな越境ECスキルをさらにご覧になるには、LinkFox Skills にアクセスしてください。