linkfox-ruiguan-text-trademark

Ruiguan テキスト商標検出

このスキルでは、商品タイトルやその他の商品テキストを対象に、テキストベースの商標検出を行う方法を説明します。これにより、EC 販売者は出品を公開する前に、商標権侵害の潜在的なリスクを特定できます。

基本概念

テキスト商標検出では、商品テキスト（タイトル、説明、箇条書き）を、15 か国・地域の登録商標データベースと照合します。一致した商標とともに、リスクスコア、登録情報、権利者情報が返されるため、販売者は知的財産権の侵害を回避できます。

リスクスコアの仕組み：highestModeScore フィールドの範囲は 0～5 で、値が大きいほど侵害リスクが高いことを示します。textTrademarkRadar フィールドでは、商品全体のリスクを 3 段階で分類します。0（低リスク）、1（手動での確認が必要）、2（高リスク）です。

ブラックリストとホワイトリスト：レスポンスには、既知の危険な商標を含む blacklistTrademarks（常に避けるべき商標）や、無視しても問題のない商標を含む whitelistTrademarks が含まれる場合があります。ブラックリストに該当するものがあれば、必ずユーザーに明確に提示してください。

パラメーター

パラメーター	型	必須	説明	例
productTitle	string	はい	検査する商品タイトル（最大 1000 文字）	ワイヤレス Bluetooth ヘッドホン、ノイズキャンセリング
regions	string	いいえ	国・地域コード（カンマ区切り）。対応地域：US、EM、GB、DE、FR、IT、ES、AU、CA、MX、JP、CN、WO、TR、BX	US,EM,GB
limit	integer	はい	返す結果の最大数（デフォルト 100、最大 500）	100
productText	string	いいえ	箇条書きや説明など、追加の商品テキスト（最大 1000 文字）	人間工学に基づくデザインと上質な音質

対応地域

コード	地域
US	米国
EM	欧州連合
GB	英国
DE	ドイツ
FR	フランス
IT	イタリア
ES	スペイン
AU	オーストラリア
CA	カナダ
MX	メキシコ
JP	日本
CN	中国
WO	WIPO（世界知的所有権機関）
TR	トルコ
BX	ボリビア

ユーザーが地域を指定しない場合は、デフォルトで US を使用してください。

API の使用方法

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

リクエストの作成方法

原則

1. 商品タイトル全体を含める：productTitle には必ず商品タイトル全体を渡してください。一部のテキストだけでは商標との一致を見逃す可能性があります。
2. 対象地域を選択する：商品を販売するマーケットプレイスに対応する地域を選択してください。複数地域を確認する場合は、コードをカンマで区切って指定します。
3. 追加テキストがあれば入力する：ユーザーが箇条書き、説明、バックエンドキーワードを用意している場合は、より詳細に検査できるよう productText に含めてください。
4. 適切な上限を設定する：通常の検査ではデフォルトの 100 を使用してください。一致候補が多いタイトルを検査する場合は、最大 500 まで増やします。

使用例

1. 商品タイトルの基本的な米国商標チェック

productTitle: "Wireless Bluetooth Headphones Noise Cancelling Over Ear"
regions: "US"
limit: 100

2. 複数地域のチェック（米国＋EU＋英国）

productTitle: "Portable USB-C Charger Fast Charging Power Bank"
regions: "US,EM,GB"
limit: 100

3. 追加テキストを含む出品情報全体の検査

productTitle: "Stainless Steel Vacuum Insulated Water Bottle"
productText: "BPA-free, double-wall insulation, keeps drinks cold 24 hours, fits standard cup holders"
regions: "US,JP"
limit: 200

4. 広範なグローバルチェック

productTitle: "LED Ring Light with Tripod Stand for Streaming"
regions: "US,EM,GB,DE,FR,IT,ES,AU,CA,MX,JP,CN"
limit: 500

5. 中国国内市場のチェック

productTitle: "智能蓝牙耳机降噪头戴式"
regions: "CN"
limit: 100

表示ルール

1. リスクを最優先で表示：結果の冒頭に全体のリスクレベル（textTrademarkRadar）を必ず表示してください。「低リスク」「手動レビューが必要」「高リスク」のように、明確な言葉を使用してください。
2. ブラックリストを目立たせる：blacklistTrademarks が空でない場合は、明確な警告を添えて最初に表示してください。
3. 表形式：商標の一致結果は、「商標名」「地域」「リスクスコア」「ステータス」「権利者」「出願番号」「著名商標」「Amazon ブランド」「有効な権利者」の列を含む表で表示してください。
4. スコアの説明：highestModeScore は 0（安全）から 5（最高リスク）までの範囲であることをユーザーに伝えてください。
5. ホワイトリストによる安心材料：whitelistTrademarks に項目がある場合は、安全な対象、または適用除外された商標として説明してください。
6. エラー処理：リクエストが失敗した場合は、問題を説明し、ユーザーに商品タイトルの確認または地域の変更を提案してください。
7. 法律上の助言は行わない：結果は参考情報であり、法律上の助言ではないことを必ずユーザーに伝えてください。確実な商標クリアランスについては、知的財産を専門とする弁護士への相談を推奨してください。

重要な制限事項

• テキストのみを検出：このツールはテキスト内の商標を検出します。ロゴ、画像、またはデザイン商標は分析しません。
• 結果の上限：1 回のリクエストにつき最大 500 件です。
• 文字数制限：productTitle と productText は、それぞれ 1000 文字までです。
• データベースの対象範囲：15 か国・地域に対応しています。他の法域で登録された商標は検出されない場合があります。

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

該当する場合 -- 商品テキストの商標リスク分析：

ユーザーの発言	シナリオ
「タイトルに商標上の問題がないか確認して」	基本的な商標スキャン
「この商品名は安全に使える？」	侵害リスクの確認
「出品情報にブランド違反がないかスキャンして」	出品情報全体のスキャン
「このタイトルに商標上のリスクはある？」	リスク評価
「米国と EU の商標を確認して」	複数地域の確認
「XX は登録商標？」	特定の語句の検索
「知的財産権が理由で出品を取り下げられる？」	コンプライアンス審査
「このキーワードがブランドを侵害していないか確認して」	キーワードの安全性確認

該当しない場合 -- テキストでの商標検出を超える対応が必要なもの：

• ロゴまたは画像を用いた商標分析
• 特許侵害の確認
• 著作権の検出
• 法的見解または訴訟戦略
• 商標登録または出願の支援

フィードバック：

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

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

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

大きなレスポンスの処理

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

python scripts/response_io.py run --script scripts/ruiguan_text_trademark_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%/... など）に指定してください。保存されたレスポンスには、PII、価格、認証に関わる機密データが含まれている可能性があります。コミットしないでください。ファイルは自動削除されないため、タスクが終わったら削除してください。

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

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

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

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

⚠️ プレビューは省略されたスキーマとサンプルであり、データ全体ではありません。フィールド単位で判断する場合は、必ず保存されたファイルを read で読み取ってください。

---

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