linkfox-eureka-abstract-translated

Eureka 特許要約の翻訳

このスキルでは、Eureka 特許データプラットフォームから翻訳済みの特許の名称と要約を取得する方法を説明します。中国語、英語、日本語の翻訳に対応しています。

基本概念

Eureka は、特許データを扱う専門プラットフォームです。このツールはデータベースを照会し、1件以上の特許について翻訳済みの名称と要約を返します。特許は特許 IDまたは**公開番号（公告番号）**で検索でき、中国語、英語、日本語の翻訳を取得できます。

特許の識別：各特許は、patentId（内部識別子）またはpatentNumber（US20200012345A1やCN112345678Aなどの公開番号／公告番号）で識別できます。両方が指定された場合は、特許 ID が優先されます。

ファミリー特許による代替：元の特許に要約がない場合、replaceByRelatedを1に設定すると、関連するファミリー特許の要約で代替できます。

パラメーターガイド

パラメーター	型	必須	説明
patentId	string	patentIdまたはpatentNumberのいずれか1つ以上	内部特許 ID。複数の ID はカンマで区切ります。1回のリクエストにつき最大100件の特許を指定できます。
patentNumber	string	patentIdまたはpatentNumberのいずれか1つ以上	公開番号（公告番号）。複数の番号はカンマで区切ります。1回のリクエストにつき最大100件の特許を指定できます。
replaceByRelated	integer	いいえ	元の特許に要約がない場合に、ファミリー特許の要約で代替するかどうかを指定します。1＝はい、0＝いいえ。デフォルトは0です。
lang	string	いいえ	翻訳先の言語です。en＝英語（デフォルト）、cn＝中国語、jp＝日本語。

主なルール

1. 識別子を少なくとも1つ指定する必要があります：patentIdまたはpatentNumber（あるいは両方）を指定してください。両方が指定された場合は、patentIdが優先されます。
2. 一括検索：値をカンマで区切ると、複数の特許を一度に検索できます。1回のリクエストにつき最大100件です。
3. デフォルトの言語は英語です：ユーザーが言語を指定しない場合は、enを使用してください。
4. ファミリー特許による代替：元の特許に要約がない場合に、ユーザーがファミリー特許の要約での代替を明示的に希望した場合に限り、replaceByRelatedを1に設定してください。

レスポンスフィールド

フィールド	説明
total	返された特許レコードの数
data	特許オブジェクトの配列（下記参照）
data[].patentId	内部特許 ID
data[].pn	公開番号（公告番号）
data[].title	翻訳済みの特許名称
data[].abstractText	翻訳済みの特許要約
data[].pnRelated	代替に使用されたファミリー特許の公開番号（ファミリー特許による代替が行われた場合のみ存在）
costToken	このリクエストで消費されたトークン数

使用例

1. 公開番号を指定して、1件の特許要約を英語に翻訳する

Look up patent number US20200012345A1 and give me the English abstract.

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

2. 複数の特許を中国語に翻訳する

Get the Chinese translation of abstracts for patents CN112345678A and US20200067890A1.

パラメーター：patentNumber = "CN112345678A,US20200067890A1"、lang = "cn"

3. 特許 ID で検索し、ファミリー特許で代替する

Get the Japanese abstract for patent ID 12345678. If the abstract is unavailable, use a family patent instead.

パラメーター：patentId = "12345678"、lang = "jp"、replaceByRelated = 1

4. 特許 ID で一括検索する

Translate the titles and abstracts for these patent IDs: 111111, 222222, 333333.

パラメーター：patentId = "111111,222222,333333"、lang = "en"

5. ファミリー特許による代替を有効にして、中国語に翻訳する

查询专利CN112345678A的中文摘要，如果没有就用同族专利替代。

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

表示ルール

1. データを明確に表示する：特許番号、タイトル、要約を含む、適切に構成された表で結果を示してください。
2. 言語を明記する：結果がどの言語であるかユーザーが把握できるよう、出力ヘッダーに翻訳言語を記載してください。
3. ファミリー特許に関する通知：いずれかの結果に pnRelated が含まれている場合、要約がファミリー特許から取得されたことを明示し、代替の公開番号を示してください。
4. 長い要約：非常に長い要約は切り詰めず、全文を表示して内容を確認できるようにしてください。
5. エラー処理：クエリが失敗した場合や結果が返されない場合は、考えられる原因（無効な特許番号、データベースに特許が見つからないなど）を説明し、修正方法を提案してください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-abstract-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全体をコンテキストに取り込まないようにしてください。

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

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

異常な状況

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

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

対象 -- 特許の要約やタイトルの翻訳に関するクエリ：

ユーザーの発言	シナリオ
「この特許の要約を翻訳して」	単一特許の翻訳
「特許XXには何が書かれていますか／どのような内容ですか」	要約の照会
「この特許の中国語／日本語版を取得して」	特定言語への翻訳
「特許番号XXの要約を調べて」	公開番号の照会
「これらの特許を一括翻訳して」	一括翻訳
「要約がありません。ファミリー特許を試してください」	ファミリー特許へのフォールバック

対象外 -- 要約の翻訳を超えるニーズ：

• 特許全文、請求項、説明文の取得
• キーワード、分類、出願人による特許検索
• 特許の法的状態、引用分析、ランドスケープレポート
• 特許の評価または侵害分析

境界 -- エッジケース：

• ユーザーが対象箇所を指定せずに「特許の内容」を求めた場合は、デフォルトで要約の翻訳を行い、請求項／説明文のツールについて案内してください。
• ユーザーが100件を超える特許を提示した場合は、複数のバッチに分けてください。

ポイント消費ルール

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

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

フィードバック：

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

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

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

---

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