mcpField
L
linkfox-zhihuiya-abstract-image

linkfox-zhihuiya-abstract-image

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

linkfox-zhihuiya-abstract-image について

Zhihuiyaの特許データベースから要約図を取得するスキルです。特許の代表図を確認したい場合に、特許IDまたは公開番号で検索でき、1回のリクエストで最大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-zhihuiya-abstract-image

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
onboarding.md
scripts/
onboarding.py
zhihuiya_abstract_image.py

詳細

Zhihuiya 特許抄録画像

このスキルでは、Zhihuiya の特許データベースから抄録画像(図面)を取得する方法を説明します。特定の特許に関連する図をすばやく取得できます。

基本概念

抄録画像(抄録図面)は、特許文書の抄録セクションに添付されている代表的な図です。発明の概要を視覚的にすばやく把握するのに役立ちます。このツールは Zhihuiya の特許データベースに問い合わせ、これらの画像のダウンロードパスを返します。

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

パラメーターガイド

パラメーターAPI 名必須説明例
特許 IDpatentId条件付き(いずれか一方は必須)内部特許識別子。複数の値はカンマで区切り、最大 100 件5e6f7a8b9c
公開番号patentNumber条件付き(いずれか一方は必須)特許の公開/公告番号。複数の値はカンマで区切り、最大 100 件CN115059423A, US11234567B2
  • patentId または patentNumber のいずれかを必ず指定してください。
  • 両方が指定された場合は、patentId が優先されます。
  • 複数の値はカンマ(半角)で区切ります。上限は 100 件です。

レスポンスフィールド

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

呼び出し方法

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

出力方法(スクリプトのデフォルト動作):

  • 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-abstract-image-<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 を使って必要に応じて抽出してください。

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md に従って解決してください。

異常な状況
  • API Key が設定されていない:環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
  • 401 または 402 のレスポンスステータスコード
  • 計算リソースまたは残高不足を示すレスポンス:メッセージに「計算リソースの残高不足/課金不足/残高不足/quota exceeded/insufficient balance/プランの期限切れ/チャージが必要/チャージしてください」または同様の内容が含まれています。

使用例

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 または公開番号を確認するようユーザーに提案します。
  6. 主観的な分析を行わない:主観的な特許分析や法的解釈を加えず、取得した画像とメタデータを提示します。

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

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

ユーザーの発言シナリオ
「特許 XX の要約画像を見せて」単一特許の画像照会
「これらの特許の図面を取得して」複数特許の画像照会
「この特許の図面はどんな感じ?」要約図面の取得
「XX の特許図面を取得して」画像ダウンロードパスの取得
「公開番号 XX の要約図面が必要です」公開番号による照会

該当しない -- 要約画像の取得以外のニーズ:

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

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

動的ルールに基づいて課金されます:計算リソースの消費量 = 81 × 返された data 件数。各件は特許要約図面の結果 1 件です。

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

フィードバック:

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

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

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


高品質でプロフェッショナルな越境 EC スキルをさらに利用するには、LinkFox Skills を設定してください。

コメント