linkfox-zhihuiya-description-data

智慧芽专利说明书数据

このスキルでは、智慧芽の特許データベースから特許の説明（明細書）データを照会する方法を案内し、ユーザーが特定の特許の説明全文を取得できるようにします。

基本概念

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

識別子の優先順位：同じ照会に特許 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 /zhihuiya/descriptionData（完全なパラメーター／レスポンス／エラーコードは references/api.md を参照）
• Python スクリプト：python scripts/zhihuiya_description_data.py '<JSON 参数>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同じセッションで同じパラメーターの組み合わせを使った呼び出しは、デフォルトで 1 回のみです。スクリプトには 24 時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードを自動的に変更したり、ページを進めたり、郵便番号を変えて連続して試したりしてはいけません。検索を続ける必要がある場合は、追加の消費が発生することを先にユーザーに説明してください。

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

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-description-data-<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 全体がコンテキストに入るのを避けてください。

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

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

異常な状況

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

クエリの作成方法

公開番号による照会

ユーザーから特許の公開番号（例：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 または出願公開番号を確認するようユーザーに案内してください。
6. 大量のコンテンツに関する警告：特許の説明は非常に長くなることがあります。最初に主要なセクションを要約し、ユーザーが希望する場合は全文を表示することを提案してください。

重要な制限事項

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

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

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

ユーザーの発言	シナリオ
「特許 XX の説明を表示して」	単一の特許の説明を検索
「これらの特許の明細書全文を取得して」	特許の説明を一括取得
「CN115099012A の詳細な本文が必要です」	出願公開番号で検索
「代わりにファミリー特許の説明を見つけられますか」	ファミリー代替検索
「この特許で技術的に何を説明していますか」	説明内容の確認

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

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

計算リソース消費ルール

動的ルールに基づいて課金されます：計算リソース消費量 = 81 × 返されたdataの件数。各件は特許明細書の結果 1 件に相当します。

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

フィードバック：

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

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

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

---

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