linkfox-maidalv-product-tro-detection

製品の権利侵害・TRO リスク検出

このスキルは、製品画像を知的財産資産（商標、特許、著作権）およびTRO訴訟の原告データベースと照合し、製品にTRO（一時的差止命令）または知的財産権侵害のリスクがあるかを検出します。全体的なリスクレベル、高リスクの該当項目、TRO原告の詳細を含む低リスクの知的財産リスト、数値のリスクスコア、AIが生成した法的レポートを返します。

主な概念

TRO（一時的差止命令）とは、商標、著作権、特許の侵害を理由に、ブランド所有者が販売者（多くの場合、Amazonの出品者）に対して申し立てる法的差止命令です。このツールはメイン製品画像（URLまたはBase64データURI）に加え、任意の参照画像／テキスト／知的財産関連キーワードを受け取り、知的財産資産およびTRO訴訟記録に対して画像とテキストを照合し、AIによる法的レポートを含む構造化されたリスク評価を返します（レポートはlanguageパラメーターに応じた言語で作成されます）。

データフィールド

トップレベルのレスポンス：

フィールド	説明
errcode	200 = 成功。それ以外のコードについてはapi.mdを参照
status	全体的な分析ステータス（success）
checkId	この検出処理の一意のID
riskLevel	全体的なリスク：高リスク／中リスク／低リスク
total	高リスク該当項目の件数（resultsの長さ）
results	高リスクの権利侵害項目（配列）
nonResults	低リスクまたは高リスクではない知的財産項目（TRO原告情報を含む、配列）
costToken	この呼び出しで消費したトークン数
columns	表示列のメタデータ（表示専用）

各項目（results / nonResults）：

フィールド	説明
ipType	Trademark / Copyright / Patent
text	知的財産に関するテキスト（商標の文字列、特許／著作権のタイトル）
ipOwner	知的財産権の所有者
regNo	登録番号（例：["1221667"]のようなJSON文字列の配列の場合があります）
riskLevel / riskScore / riskDescription	リスク評価／0～10のスコア／テキスト。スコアが付与されている場合のみ存在
ipAssetUrls	知的財産の証拠画像へのURL
plaintiffName / plaintiffId	TRO原告（知的財産がTRO訴訟に登場する場合のみ存在）
numberOfCases	原告の訴訟件数（TROのみ）
lastCaseDocket / lastCaseDateFiled	直近の裁判所の事件番号／提訴日（TROのみ）
report	AIが生成した法的評価（languageに応じた言語）

パラメーターガイド

パラメーター	必須	デフォルト	説明
mainProductImage	はい	-	メイン製品画像：URLまたはdata:image/...;base64,...（≤1000文字）
referenceImages	いいえ	-	類似製品の参照画像、最大3枚（URLまたはデータURI）
otherProductImages	いいえ	-	その他の製品画像、最大5枚（URLまたはデータURI）
ipImages	いいえ	-	知的財産関連の画像、最大3枚（URLまたはデータURI）
referenceText	いいえ	-	類似製品のテキスト（例：製品タイトル）、≤1000文字
description	いいえ	-	製品の説明（タイトルを推奨）、≤1000文字
ipKeywords	いいえ	-	知的財産関連のキーワード、最大20個
language	いいえ	zh	法的レポートの言語（zh / en）。reportの言語のみに影響します

画像のルール： URLは誰でもアクセスできる必要があります。Base64にはdata:image/...;base64,のプレフィックスが必要です。ローカル画像の場合は、先にアップロードする（「ローカル画像のアップロード」を参照）か、データURIに変換してください。

呼び出し方法

• API エンドポイント：POST /maidalv/checkApiFlash（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python スクリプト：python scripts/maidalv_check_api_flash.py '<JSON 参数>' [--inline]
• コスト上の制約：このツールは計算リソースを消費します。同一セッション内では、同じパラメーターの組み合わせによる呼び出しはデフォルトで1回のみです。スクリプトには24時間有効なローカルキャッシュがあります。失敗や空の結果を受けて、キーワードやメイン画像を自動的に変更したり、連続して試行したりしてはいけません。検索を続ける必要がある場合は、追加コストが発生することを事前にユーザーに説明してください。

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-maidalv-product-tro-detection-<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／套餐到期／需充值／请充值」または同様の意味の内容が含まれている場合。

ローカル画像のアップロード

このツールは、一般公開されている画像 URL または Base64 データ URI を受け付けます。ユーザーからローカル画像ファイルのパスが提供された場合は、先にアップロードして公開 URL を取得するか、データ URI にエンコードしてください。

アップロードスクリプトを実行します：

python scripts/upload_image.py /path/to/local/image.png

スクリプトは、mainProductImage として使用できる（24時間有効な）公開 URL を返します。

使用例

1. 基本的な検出（メイン画像のみ）

检测这个产品的 TRO 和知识产权侵权风险，图片地址为 https://m.media-amazon.com/images/I/71jKJgFpg8L._AC_SL1500_.jpg

2. 英語の法的レポート

Check this product for TRO and IP infringement risk: https://example.com/product.jpg — give me the legal report in English.

3. 参照画像＋IP キーワードを指定

检测这个图片的侵权风险，主图 https://example.com/product.jpg，参考图 https://example.com/ref.jpg，IP 关键词 apple、iphone

表示ルール

1. 全体の判定を最初に示す：まず riskLevel（高リスク／中リスク／低リスク）と checkId を表示します。
2. 高リスク項目を先に表示する：results が空でない場合は、該当項目ごとに ipType／text／ipOwner／riskScore／riskDescription を目立つように表示します。
3. TRO 原告の詳細：plaintiffName がある項目では、原告、numberOfCases、lastCaseDocket、lastCaseDateFiled を表示します。これらは TRO リスクの判断に重要です。
4. 証拠画像：利用可能な場合は、視覚的な比較のため ipAssetUrls をインラインで表示します。
5. AI 法的レポート：高リスク項目については、report フィールド（詳細な法的評価）を表示します。
6. 件数：total（高リスク件数）と nonResults の長さを必ず示します。
7. 二次処理なし：結果は1回限りの分析です。SQL／二次クエリは利用できません。

重要な制限事項

1. 1回限りの分析：結果はデータベースに保存されません。二次処理に _dataQuery_executeDynamicQuery は使用できません。
2. 画像入力：mainProductImage は必須です。ローカル画像はアップロードするか、Base64 にエンコードする必要があります（data:image/...;base64, プレフィックスを付けます）。
3. 言語の適用範囲：language が影響するのは report のテキストのみです。フィールド値は返されたままです。
4. 条件付きフィールドは想定どおりです：TRO に該当しない項目、またはスコアが付与されていない項目には、基本フィールド（ipType／text／ipOwner／regNo／ipAssetUrls）のみが返されます。該当しない場合、原告／訴訟関連フィールドとリスクフィールドは 存在しません（null ではありません）。欠落をエラーとして扱わないでください。
5. columns はレンダリング用メタデータです：その長さはデータ配列と異なります。結果件数の推定には使用せず、results／nonResults の長さを使用してください。

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

適用対象 — 商品の TRO／IP 侵害リスクチェック：

ユーザーの発言	シナリオ
「この商品に TRO リスクはありますか」／「訴えられますか」	基本的な TRO リスクチェック
「この画像は商標／特許／著作権を侵害していますか」	IP 侵害の検出
「この Amazon 商品を出品すると侵害リスクがありますか」	出品前のコンプライアンスチェック
「この商品の原告情報を調べてください」	TRO 原告の検索
「英語の法律評価レポートを作成してください」	英語の法律レポート

適用対象外 — このツールの対象外：

• 1688／Amazon の画像検索による商品調達（画像検索スキルを使用）
• 特許全文／請求項の検索（智慧芽／Eureka の特許スキルを使用）
• 出品文面の最適化またはキーワード分析

適用範囲の判断：ユーザーが商品画像を提示し、侵害／TRO／法的リスクについて尋ねた場合は、このスキルが適用されます。仕入先の検索やキーワード分析を求めている場合は、該当する仕入れ／キーワードツールを使用してください。

コンピューティングリソースの消費ルール

113 コンピューティングリソースを消費します（約 150000 トークン）。

ユーザーはコンピューティングリソースの消費に応じて料金を支払います。本ツールは 1 回の呼び出しのコストが高いため（AI による法律評価を含む）、十分にご検討ください。本スキルを高頻度で呼び出す必要がある場合、またはユーザーがコンピューティングリソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

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

---

高品質でプロフェッショナルな越境 EC スキルについては、LinkFox Skills をご覧ください。