mcpField
L
linkfox-eureka-abstract-image

linkfox-eureka-abstract-image

github.com/linkfox-aiドキュメント113213 回インストール2 週間前に更新
リポジトリ

linkfox-eureka-abstract-image について

Eurekaプラットフォームから特許の要約図を取得するLinkFoxスキルです。特許IDまたは公開番号で検索でき、最大100件をまとめて照会して画像パスを返します。

主な機能

  1. 01特許IDまたは公開番号で図面を検索
  2. 021回に最大100件を照会
  3. 03要約図の画像パスを返却
  4. 04公開番号とともに図面を表示

活用シーン

  1. 01指定した特許の要約図を取得
  2. 02複数特許の図面を一括取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-eureka-abstract-image

インストール後、Claude Code で/linkfox-eureka-abstract-imageを入力して読み込まれたか確認します。

同梱ファイルreferences/api.mdscripts/eureka_abstract_image.py

詳細

Eureka 特許要約画像

このスキルでは、Eureka 特許データプラットフォームから要約画像（図面）を取得する方法を説明します。特定の特許に関連する説明図をすばやく入手できます。

基本概念

要約画像（要約図面）は、特許文書の要約欄に添付される代表図です。発明の概要を視覚的にすばやく把握できます。このツールは Eureka 特許プラットフォームに問い合わせ、これらの画像のダウンロードパスを返します。

検索ロジック：特許 ID または公開番号のいずれかを少なくとも 1 つ指定する必要があります。両方を指定した場合は、特許 ID が優先されます。1 回のリクエストで最大 100 件の特許を、値をカンマで区切って検索できます。

パラメーターガイド

パラメーターAPI 名必須説明例
特許 IDpatentId条件付き（2 つのうちどちらか 1 つが必要）内部特許識別子。複数の値はカンマで区切り、最大 100 件5e6f7a8b9c
公開番号patentNumber条件付き（2 つのうちどちらか 1 つが必要）特許の公開／公告番号。複数の値はカンマで区切り、最大 100 件CN115059423A, US11234567B2
  • patentId または patentNumber の少なくとも 1 つを指定する必要があります。
  • 両方を指定した場合は、patentId が優先されます。
  • 複数の値はカンマ（半角）で区切ります。上限は 100 件です。

レスポンスフィールド

フィールドAPI 名説明
特許 IDpatentId内部特許識別子
公開番号pn公開／公告番号
要約図面のパスabstractDrawingPath要約画像ファイルへの URL パス
合計total返されたレコードの合計数
消費トークンcostTokenクエリで消費されたトークン数

呼び出し方法

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

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

  • 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-abstract-image-<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/ でクレジットを追加するようユーザーに案内してください。

使用例

1. 公開番号で特許を 1 件検索

Retrieve the abstract image for patent CN115059423A.

2. 公開番号で複数の特許を検索

Get abstract drawings for patents US11234567B2, EP3456789A1, and CN115059423A.

3. 特許 ID で検索

Fetch the abstract image for patent ID 5e6f7a8b9c.

4. 識別子を混在させた一括検索

I have the following patent IDs: abc123, def456. Please get their abstract images.

表示ルール

  1. 画像を表示する：レスポンスに abstractDrawingPath が含まれる場合は、Markdown の画像構文を使って画像を直接表示し、ユーザーが図面をインラインで確認できるようにします。
  2. 特許を識別する：各画像の横に公開番号（pn）を必ず表示し、どの特許の図面かユーザーが分かるようにします。
  3. 画像がない場合：特許に要約図面がない（abstractDrawingPath が空）場合は、その特許の要約画像が利用できないことを明示します。
  4. 一括検索の結果：複数の特許を検索する場合は、分かりやすく整理されたリストまたは表形式で結果を提示します。
  5. エラー処理：検索に失敗した場合は、レスポンスに基づいて理由を説明し、特許 ID または公開番号を確認するようユーザーに提案します。

重要な制限事項

  • 1 回のリクエストにつき最大 100 件：1 回の呼び出しで指定できる特許 ID または公開番号は最大 100 件です。
  • 識別子が 1 つ以上必要：patentId または patentNumber のいずれかを指定する必要があります。両方が空の場合、リクエストは失敗します。
  • 特許 ID が優先されます：patentId と patentNumber の両方を指定した場合、システムは patentId を使用し、patentNumber は無視します。
  • データの収録範囲：結果は Eureka 特許プラットフォームのデータベースの収録状況によって異なります。ごく最近の出願は、まだ反映されていない場合があります。

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

該当する -- 特許の要約画像の取得：

ユーザーの発言シナリオ
"特許 XX の要約画像を見せて"特許画像の単件検索
"これらの特許の図面を取得して"特許画像の一括検索
"特許の図はどのようなものですか"要約図面の取得
"XX の特許図面を取得して"画像のダウンロードパスの取得
"公開番号 XX の要約図面が必要です"公開番号による検索

該当しない -- 要約画像の取得を超える依頼：

  • 特許全文または特許請求の範囲の分析
  • キーワードまたは分類による特許検索
  • 特許の法的状況またはファミリー情報
  • 特許の引用または先行技術の分析
  • 特許の価値評価または侵害分析

ポイント消費ルール

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

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

フィードバック：

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

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

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

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

コメント

Markdown 対応