linkfox-ruiguan-trademark-graphic-detection

Ruiguan グラフィック商標検出

このスキルでは、商品画像内のグラフィック商標を検出する方法を説明します。出品前に潜在的な商標権侵害リスクを特定できるため、EC 販売者やブランドオーナーに役立ちます。

基本概念

グラフィック商標検出では、商品画像を解析し、複数の国や地域で登録されている、視覚的に類似した商標を検索します。このツールは YOLO ベースの物体検出を使用して画像内のロゴらしき領域を特定し、世界各地の商標データベースと照合します。

類似度スコア：similarity の値が高いほど、検出されたグラフィックは登録商標に視覚的に類似しています。値が 1.0 に近いほどほぼ同一の一致を示し、権利侵害のリスクも高くなります。

商標ステータスの意味：

ステータス	意味
registered	商標は有効に登録されています
act	商標は有効です
pend	商標の出願が審査中です
filed	商標の出願が提出されています
ended	商標の有効期限が切れています
DEL	商標は削除／取り消されています

パラメーターガイド

パラメーター	必須	説明	デフォルト
imageUrl	はい	誰でもアクセスできる HTTP(S) 商品画像 URL（最大 1000 文字）。サービスがダウンロードして Base64 に変換するため、Base64 を直接渡さないでください。	-
topNumber	はい	返す検出結果の最大数（1～100）	5
productTitle	いいえ	商品タイトル。検出精度の向上に役立ちます	-
trademarkName	いいえ	ロゴの推定名称。検索結果の絞り込みに役立ちます	-
regions	いいえ	確認する国／地域コードをカンマ区切りで指定します。省略した場合は、すべての国を検索します	すべて
enableLocalizing	いいえ	検出領域の画像切り抜きを有効にするかどうか	false
enableRadar	いいえ	レーダー監視を有効にするかどうか	true

対応地域

US（米国）、WO（WIPO）、ES（スペイン）、GB（英国）、DE（ドイツ）、IT（イタリア）、CA（カナダ）、MX（メキシコ）、EM（欧州連合）、AU（オーストラリア）、FR（フランス）、JP（日本）、TR（トルコ）、BX（ベネルクス）、CN（中国）

ユーザーが地域を指定しない場合は、regions パラメーターを省略してください。デフォルトですべての国が検索されます。

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

このツールでは、誰でもアクセスできる画像 URL が必要です。ユーザーがローカル画像ファイルのパス（例：C:\Users\...\photo.png、/home/.../image.jpg）を指定した場合は、公開 URL を取得するため、まず画像をアップロードする必要があります。

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

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

スクリプトは、画像 URL パラメーターとして使用できる公開 URL（有効期間 24 時間）を返します。

使用例

1. 基本的な画像商標チェック すべての地域を対象に商品画像内の商標を検出し、最大 10 件の結果を返します：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10

2. 地域を指定した商標チェック 商品画像を米国と EU の商標データベースのみと照合します：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 5
regions: "US,EM"

3. 商品情報を指定した詳細チェック 商品タイトルとロゴの推定名称を指定すると、検出精度が向上します：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10
productTitle: "Wireless Bluetooth Headphones with Noise Cancellation"
trademarkName: "SonicWave"
regions: "US,GB,DE"

4. 画像切り抜きを使った全件検出 位置特定を有効にして、検出されたロゴ領域の切り抜き画像を取得します：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 20
enableLocalizing: true
regions: "US"

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-detection-<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 キー未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• 401 または 402 のステータスコードが返される
• 計算リソースまたは残高不足を示す応答：メッセージに「計算リソース残高不足／請求額不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれています。

表示ルール

1. 結果をわかりやすく表示する：商標画像、類似度スコア、商標名、ステータス、登録機関、ニース分類、出願人名、主要な日付を含む、よく構成された表で検出結果を表示します。
2. 高リスクの一致を強調する：類似度が 0.8 を超える場合は、侵害リスクが高いことを明確に警告します。
3. 商標ステータスを説明する：結果を表示する際は、リスク評価における各商標ステータスの意味を説明します。
4. レーダー結果：応答に radarResult が含まれている場合は、リスク評価を集約した情報であるため、目立つように表示します。
5. サブレーダー結果：個々の項目に subRadarResult が含まれている場合は、各一致結果と併せてこの情報を表示します。
6. 地域の情報：チェックの対象範囲をユーザーが把握できるよう、検索した地域を必ず示します。
7. エラー処理：検出に失敗した場合は、応答に基づいて理由を説明し、調整方法（例：より鮮明な画像を使う、地域を指定する、topNumber を調整する）を提案します。

重要な制限事項

• 画像が必須：imageUrl パラメーターは必須です。画像なしではツールは検出を実行できません。
• 結果数の上限：topNumber パラメーターにより、1 回のリクエストにつき最大 100 件までに制限されます。
• 画像の品質：検出精度は画像の解像度と鮮明さに左右されます。高品質な画像ほど、より良い結果が得られます。
• 地域のカバー範囲：すべての国が対象ではありません。対応リストには主要な商標登録機関が 15 機関含まれています。

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

適用対象 -- 図形商標の検出タスク：

ユーザーの発言	シナリオ
「この画像に商標の問題がないか確認して」	基本的な商標検出
「このロゴはどこかで登録されていますか」	複数地域での商標検索
「自社商品の画像に関する商標リスクを確認して」	商品リスティングのリスク評価
「この図形に似た商標を探して」	類似検索
「この画像を米国の商標と照合して」	地域を指定した検出
「このデザインは商標を侵害していますか」	侵害リスクの確認
「商品写真にあるロゴをスキャンして」	商品画像内のロゴ検出

適用対象外 -- 図形商標の検出を超える要件：

• テキスト／文字商標の検索（画像を使用しないもの）
• 商標の登録または出願
• 特許または著作権の確認
• 商標紛争に関する法的助言
• 商品リスティングの最適化

適用範囲の判断：「商品を確認してほしい」「販売しても安全か」といった依頼で、商品画像内の図形要素やロゴが登録商標を侵害する可能性について尋ねている場合、このスキルが適用されます。テキスト商標、特許の問題、または一般的な法令遵守について尋ねている場合は適用されません。

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

レーダー検出を有効にすると計算リソースを 92 消費し、無効の場合は 61 消費します。

重要：このスキルは計算リソースを大量に消費します。呼び出し回数が 5 回を超える場合は、必ず AskUserQuestion を使ってユーザーに再確認してください。すでに消費した計算リソースと、呼び出しを続けた場合に予想される消費量を明確に伝え、続行するかどうかはユーザー自身に判断してもらってください。

フィードバック：

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

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

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

---

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