linkfox-zhihuiya-simple-bibliography

Zhihuiya 特許簡易書誌

このスキルでは、Zhihuiya 特許データベースを使用して特許の簡易書誌データを照会する方法を説明し、ユーザーが構造化された特許メタデータを効率よく取得できるようにします。

基本概念

Zhihuiya 簡易書誌ツールは、特許の基本的な書誌情報（フロントページ情報）を取得します。1つ以上の特許 ID または公開番号を指定すると、タイトル、要約、出願人、発明者、権利者、分類コード、出願日、優先権主張、引用文献などの構造化メタデータを返します。

検索モード：patentId（Zhihuiya の内部特許 ID）または patentNumber（公開番号／登録番号）のいずれかを使って特許を検索できます。両方が指定された場合は、patentId が優先されます。複数の値はカンマ区切りで指定でき、1回のリクエストにつき最大100件です。

パラメーターガイド

パラメーター	型	必須	説明
patentId	string	条件付き	Zhihuiya の内部特許 ID。複数の値はカンマ区切りで指定でき、最大100件です。patentId または patentNumber のいずれかを指定する必要があります。
patentNumber	string	条件付き	公開番号／登録番号（例：US11234567B2、CN115000000A）。複数の値はカンマ区切りで指定でき、最大100件です。patentId または patentNumber のいずれかを指定する必要があります。

優先ルール：patentId と patentNumber の両方が指定されている場合、API は patentId を使用し、patentNumber を無視します。

レスポンスデータのフィールド

フィールド	API 名	説明
特許 ID	patentId	Zhihuiya の内部特許識別子
タイトル	title	特許のタイトル
要約	abstractContent	特許の要約テキスト
公開番号	publicationNumber	公開番号
公開番号／登録番号	pn	公開番号／登録番号の完全な番号
国コード	country	特許の国コード
公開国	publicationCountry	特許が公開された国
公開日	publicationDate	公開日
公開種別	publicationKind	公開の種別コード
特許の種類	patentType	特許の種類（例：発明、実用新案、意匠）
種別コード	kind	特許の種別コード
出願番号	applicationNo	出願番号
出願日	applicationDate	特許の出願日
出願人	applicants	出願人の一覧
発明者	inventors	発明者の一覧
権利者	assignees	特許の権利者／所有者の一覧
権利者の住所	assigneeAddresses	権利者の住所の一覧
IPC メイン	ipcMain	IPC の主分類コード
IPC 追加	ipcFurther	IPC の追加分類コード
CPC メイン	cpcMain	CPC の主分類コード
CPC 追加	cpcFurther	CPC の追加分類コード
LOC	loc	ロカルノ分類コード（意匠特許）
GBC	gbc	GBC 分類コード
優先権主張	priorityClaims	優先権主張の項目一覧
PCT 出願番号	pctApplicationNo	PCT 国際出願番号
PCT 出願日	pctFilingDate	PCT 国際出願日
PCT 移行日	pctEntryDate	PCT 国内段階への移行日
引用特許	citedPatents	引用された特許文献の一覧
非特許引用文献	citedNonPatents	引用された非特許文献の一覧

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-simple-bibliography-<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／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれる場合。

使用例

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

User: "Show me the bibliographic info for patent US11234567B2."
Action: Call with patentNumber = "US11234567B2"

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

User: "Get the basic info for CN115000000A, EP4000000A1, and JP2023100000A."
Action: Call with patentNumber = "CN115000000A,EP4000000A1,JP2023100000A"

3. 智慧芽の特許 ID で特許を検索する

User: "Retrieve bibliography for patent IDs abc123 and def456."
Action: Call with patentId = "abc123,def456"

4. 発明者と出願人の情報を取得する

User: "Who are the inventors and applicants for patent US20230001234A1?"
Action: Call with patentNumber = "US20230001234A1", then extract the inventors and applicants fields from the response.

5. 特許分類コードを確認する

User: "What IPC and CPC codes does patent EP3999999B1 have?"
Action: Call with patentNumber = "EP3999999B1", then present ipcMain, ipcFurther, cpcMain, and cpcFurther from the response.

6. 特許の要約と引用文献を取得する

User: "Show me the abstract and cited patents for CN114000000B."
Action: Call with patentNumber = "CN114000000B", then display abstractContent and citedPatents.

表示ルール

1. データを明確に提示する：書誌情報は、適切に構成された表またはグループ分けしたセクションで表示します。特許が 1 件の場合はキーと値の形式を使用します。複数の特許の場合は、関連性の高い列を含む表を使用します。
2. 必要な情報を選んで表示する：結果に多くのフィールドが含まれる場合は、タイトル、公開番号、出願人、発明者、出願日、公開日、IPC／CPC の主分類コード、要約を優先して表示します。追加のフィールドは、ユーザーから明示的に求められた場合にのみ表示します。
3. リスト形式のフィールド：配列フィールド（発明者、出願人、権利者、分類コード、引用文献）は、長さに応じてカンマ区切りまたは箇条書きで表示します。
4. 空のフィールド：null または空のフィールドは、空欄として表示せず省略します。
5. エラー処理：クエリに失敗した場合は、エラーメッセージに基づいて理由を説明し、ユーザーに特許番号または ID の形式を確認するよう案内します。
6. 一括検索の通知：一度に多数の特許を検索する場合、1 リクエストあたりの上限が 100 件であることをユーザーに伝えます。

重要な制限事項

• 一括リクエストの最大件数：1 リクエストあたり最大 100 件の特許 ID または公開番号を指定できます。
• 識別子が 1 つ以上必要：patentId または patentNumber のいずれかを指定する必要があります。両方を省略するとエラーになります。
• patentId が優先されます：両方のパラメーターが指定された場合、patentId のみが使用されます。
• データ範囲：このツールが返すのは簡易書誌データのみです。請求項全文、詳細な説明、法的ステータス、特許ファミリー情報は返しません。

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

該当するケース -- 特許書誌データの取得：

ユーザーの発言	シナリオ
「特許 XX を調べて」／「特許 XX の情報を取得して」	単一特許の書誌情報の検索
「特許 XX の発明者は誰？」／「出願人は誰？」	発明者／出願人情報の取得
「XX の IPC コードは？」／「XX の分類は？」	分類コードの検索
「XX の要約を見せて」	要約の取得
「特許 XX の出願日は？」／「公開日は？」	日付情報の検索
「XX が引用している特許は？」	引用文献の検索
「これらの特許の書誌データを取得して：A、B、C」	書誌情報の一括検索
「特許の基本情報」／「特許のフロントページデータ」	一般的な書誌情報の取得

該当しないケース -- 単純な書誌データの取得を超える要件：

• 特許請求の範囲の全文または詳細な説明
• 特許の法的状態または審査経過
• 特許ファミリー／同等特許の分析
• 特許の価値評価またはランドスケープ分析
• 実施自由性または侵害の分析
• キーワードまたはセマンティック検索による特許検索（このツールには特定の特許識別子が必要です）

算力の消費ルール

動的ルールに基づいて課金されます：算力の消費量 = 81 × 返される data の件数。各件は、簡易版の特許書誌情報 1 件に相当します。

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

フィードバック：

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

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

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

---

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