linkfox-ruiguan-graphic-trademark

Ruiguan グラフィック商標検出

このスキルでは、商品画像内のグラフィック商標を検出する方法を説明します。EC 出品者やブランド所有者が、商品を出品する前に商標権侵害の潜在的なリスクを特定できるよう支援します。

基本概念

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

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

商標ステータスの意味：

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

パラメーターガイド

パラメーター	必須	説明	デフォルト
imageUrl	はい	商品画像の URL または 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 の使用方法

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

表示ルール

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

重要な制限事項

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

ユーザーの表現とシナリオの早見表

該当する -- 図形商標の検出タスク：

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

該当しない -- 図形商標の検出を超える内容が必要なもの：

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

適用範囲の判断：「商品をチェックして」や「安全に販売できますか」とユーザーが尋ねた場合、商品画像内の図形要素やロゴが登録商標を侵害している可能性への懸念であれば、このスキルが該当します。テキスト商標、特許の問題、または一般的な法令遵守について尋ねている場合は該当しません。

フィードバック：

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

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

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

大きなレスポンスの処理

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

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

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

このスキルには複数のエントリースクリプトがあります：ruiguan_trademark_graphic_detection.py、upload_image.py。必要なスクリプトを選択するには、--script scripts/<name>.py を渡してください。

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

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

• レコードあたりのフィールド数が多い、または不要なフィールドがある
• バッチ／ページ分割された結果（1 回の呼び出しで複数の項目を取得する場合）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐに使用せず、後続の手順でも再利用する出力

小規模で一度しか使わないレスポンスの場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルを省略表示したものであり、データ全体ではありません。フィールド単位の判断を行う場合は、必ず保存先ファイルを read で読み込んでください。

---

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