mcpField
L
linkfox-zhihuiya-description

linkfox-zhihuiya-description

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

linkfox-zhihuiya-description について

特許IDまたは公開番号を使って、Zhihuiyaのデータベースから特許明細書を取得するLinkFoxスキルです。単件・複数件の技術内容の確認に使え、対象の明細書がない場合は同族特許の内容で代替できます。

主な機能

  1. 01特許IDまたは公開番号で検索
  2. 02特許明細書の内容を取得
  3. 03最大100件の一括検索
  4. 04同族特許の明細書による代替

活用シーン

  1. 01指定特許の技術説明の確認
  2. 02複数特許の内容の取得
  3. 03対象の内容がない場合の同族特許の確認

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-description

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

同梱ファイル

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

references/
api.md
scripts/
response_io.py
zhihuiya_description_data.py

詳細

Zhihuiya 特許明細書データ

このスキルでは、Zhihuiya 特許データベースから特許明細書データを照会する方法を説明し、特定の特許の明細書全文を取得できるようにします。

基本概念

特許明細書(仕様書とも呼ばれます)は、特許出願に付随する詳細な技術文書です。発明の仕組み、好ましい実施形態、特許法で求められるその他の技術的な詳細を開示します。このツールは、内部特許 ID または公開番号で特定した 1 件以上の特許について、Zhihuiya データベースに照会し、明細書データを返します。

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

ファミリー特許による代替:指定した特許の明細書を取得できない場合、関連するファミリー特許の明細書を代わりに返すよう、オプションで指定できます。

パラメーター

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

レスポンスフィールド

フィールド型説明
totalinteger返された特許レコードの件数
dataarray特許明細書オブジェクトの一覧
data[].patentIdstring特許 ID
data[].pnstring公開番号
data[].pnRelatedstring代替に使用されたファミリー特許の公開番号(ファミリー特許による代替を使用した場合のみ存在)
data[].descriptionarray明細書のセクション
columnsarray表示用の列定義
costTokeninteger照会で消費されたトークン数
typestring表示形式のヒント

API の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し方法、リクエストパラメーター、レスポンス構造については、references/api.md を参照してください。scripts/zhihuiya_description_data.py を直接実行して照会することもできます。

クエリの作成方法

公開番号で照会する

ユーザーから特許公開番号(例:CN115099012A、US20230012345A1)が指定された場合は、patentNumber パラメーターに渡します。

patentNumber: "CN115099012A"
特許 ID で照会する

ユーザーから内部 Zhihuiya 特許 ID が指定された場合は、patentId パラメーターに渡します。

patentId: "abc123def456"
バッチ照会

patentId と patentNumber はどちらも、カンマ区切りの値を指定して一括検索できます(最大 100 件)。

patentNumber: "CN115099012A,US20230012345A1,EP4123456A1"
ファミリー特許による代替

データベースで特許の明細書を取得できず、ユーザーがそれでも内容を求めている場合は、ファミリー特許による代替を有効にします。

patentNumber: "CN115099012A"
replaceByRelated: "1"

使用例

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 または公開番号を確認するようユーザーに提案します。
  6. 大量のコンテンツに関する警告:特許の説明は非常に長い場合があります。まず主要なセクションを要約し、希望があれば全文を表示できることを伝えます。

重要な制限事項

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

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

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

ユーザーの発言シナリオ
"特許 XX の説明を見せて"1 件の特許の説明を検索
"これらの特許の明細書全文を取得して"複数の特許の説明を一括取得
"CN115099012A の詳細なテキストが必要です"公開番号で検索
"代わりにファミリー特許の説明を見つけられますか"ファミリー代替クエリ
"この特許が技術的に何を説明しているのか"説明内容の確認

該当しない -- 特許の説明データ以外の情報が必要な場合:

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

フィードバック:

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

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

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

大きなレスポンスの処理

エージェントのコンテキストがあふれないように、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください。

python scripts/response_io.py run --script scripts/zhihuiya_description_data.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリー外(Unix では /tmp/...、Windows では %TEMP%/... など)に指定してください。保存されたレスポンスには、個人情報、価格、認証に関わる機密データが含まれている可能性があります。コミットしないでください。ファイルは自動削除されないため、作業が完了したらクリーンアップしてください。

run は完全なレスポンスをファイルに書き込み、スキーマのプレビューとファイルパスだけを出力します。read は特定のフィールドを抽出し、スライスには --limit/--offset を、出力形式には --format json|jsonl|csv|table を指定できます。

このパターンを優先する場合 — 次のようなレスポンスの特徴に応じて判断してください。

  • レコードごとのフィールド数が多い、または不要なフィールドがある場合
  • バッチ結果やページ分割された結果(1 回の呼び出しで複数の項目が返される場合)
  • 長いテキストフィールド(説明、レビュー、HTML、時系列データ)
  • すぐに使うのではなく、後続のステップでも出力を再利用する場合

小規模で一度だけ使うレスポンスなら、メインスクリプトを直接呼び出してもかまいません。

⚠️ プレビューは、切り詰められたスキーマとサンプルであり、完全なデータではありません。フィールド単位で判断する場合は、read を使って保存されたファイルを読み込んでください。


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

コメント