linkfox-eureka-description

Eureka 特許明細書データ

このスキルでは、Eureka 特許データプラットフォームから特許明細書データを検索する方法を案内します。特定の特許の明細書全文を取得できます。

主な概念

特許明細書（仕様書とも呼ばれます）は、特許出願に添付される詳細な技術文書です。発明の仕組み、好ましい実施形態、特許法で求められるその他の技術的な詳細を開示します。このツールは、内部特許 ID または公開番号で指定された 1 件以上の特許について、Eureka プラットフォームに問い合わせて明細書データを返します。

識別子の優先順位：同じ検索で特許 ID と公開番号の両方が指定された場合は、特許 ID が優先されます。

ファミリー特許による代替：指定した特許の明細書が取得できない場合、関連するファミリー特許の明細書を代わりに返すよう、任意で指定できます。

パラメーター

パラメーター	型	必須	説明
patentId	string	条件付き	内部特許 ID。patentId または patentNumber のいずれかを指定する必要があります。複数の値はコンマで区切ります。最大 100 件です。
patentNumber	string	条件付き	公開番号／公告番号。patentId または patentNumber のいずれかを指定する必要があります。複数の値はコンマで区切ります。最大 100 件です。
replaceByRelated	string	いいえ	対象特許の明細書が取得できない場合に、ファミリー特許の明細書で代替するかどうかを指定します。1 = はい、0 = いいえ。

応答フィールド

フィールド	型	説明
total	integer	返された特許レコード数
data	array	特許明細書オブジェクトのリスト
data[].patentId	string	特許 ID
data[].pn	string	公開番号
data[].pnRelated	string	代替に使用したファミリー特許の公開番号（ファミリー特許による代替を使用した場合のみ存在）
data[].description	array	明細書のセクション
columns	array	表示用の列定義
costToken	integer	検索で消費したトークン数
type	string	表示スタイルのヒント

呼び出し方法

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

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

• 必ず完全な応答を <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-description-<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／套餐到期／需充值／请充值」または同様の意味の内容が含まれています。

対処

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

クエリの作成方法

公開番号で検索する

ユーザーが特許公開番号（例：CN115099012A、US20230012345A1）を指定した場合は、patentNumber パラメーターに渡します：

patentNumber: "CN115099012A"

特許 ID で検索する

ユーザーが内部特許 ID を指定した場合は、patentId パラメーターに渡します：

patentId: "abc123def456"

バッチクエリ

patentId と patentNumber はどちらも、バッチ検索用にカンマ区切りの値を受け付けます（最大 100 件）。

patentNumber: "CN115099012A,US20230012345A1,EP4123456A1"

ファミリー代替

特許の説明がデータベースにない場合でもユーザーが内容を必要としているときは、ファミリー代替を有効にします。

patentNumber: "CN115099012A"
replaceByRelated: "1"

使用例

1. 公開番号で単一の特許の説明を検索する

patentNumber: "CN115099012A"

2. 複数の特許の説明を一度に検索する

patentNumber: "CN115099012A,US20230012345A1"

3. ファミリー代替を有効にして検索する

patentNumber: "CN115099012A"
replaceByRelated: "1"

4. 特許 ID で検索する

patentId: "some-patent-id"

表示ルール

1. データを忠実に提示する：返された説明の内容を、技術的な詳細を変更したり、主観的な解釈を加えたりせず、明確に示します。
2. 構造化された出力：説明に複数のセクション（背景、概要、詳細な説明、請求項など）が含まれる場合は、読みやすいように明確な見出しを付けて提示します。
3. ファミリー代替の通知：応答に pnRelated フィールドが含まれる場合、説明が関連するファミリー特許から取得されたことをユーザーに明示し、代替した公開番号を伝えます。
4. バッチ結果：複数の特許が返された場合は、それぞれの特許の内容を公開番号の見出しで明確に区切ります。
5. エラー処理：クエリが失敗した場合、またはデータが返されない場合は、その理由を説明し、特許 ID または公開番号を確認するようユーザーに提案します。

重要な制限事項

• 識別子の要件：patentId または patentNumber の少なくとも一方を指定する必要があります。このツールでは、キーワードや出願人名で検索できません。
• バッチの上限：1 回のリクエストで検索できる特許は最大 100 件です。
• 利用可能性：データベースに説明がない特許もあります。必要に応じて、replaceByRelated: "1" を使用してファミリー代替を試みます。
• 優先ルール：patentId と patentNumber の両方が指定された場合は、patentId が優先されます。

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

該当する -- 特許の説明／明細書の内容に関するクエリ：

ユーザーの発言	シナリオ
"Show me the description of patent XX"	単一の特許説明の検索
"Get the full specification for these patents"	複数特許の説明の取得
"I need the detailed text of CN115099012A"	公開番号による検索
"Can you find a family patent's description instead"	ファミリー代替クエリ
"What does this patent describe technically"	説明内容の確認

該当しない -- 特許の説明データを超えるニーズ：

• キーワード、出願人、または分類による特許検索
• 特許請求項の分析またはクレームチャートの作成
• 特許の法的状態または審査履歴
• 特許ランドスケープまたは統計分析
• 実施自由または侵害に関する意見

ポイント消費ルール

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

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

フィードバック：

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

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

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

---

高品質でプロフェッショナルな越境 EC スキルをもっとお探しなら、LinkFox Skills をご覧ください。