linkfox-ruiguan-text-trademark-detection

Ruiguan テキスト商標検出

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

主な概念

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

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

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

パラメーター

パラメーター	型	必須	説明	例
productTitle	string	はい	スキャンする商品タイトル（最大 1000 文字）	Wireless Bluetooth Headphones Noise Cancelling
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 文字）	Ergonomic design with premium sound quality

対応地域

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

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

呼び出し方法

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

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

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

リクエストの作成方法

原則

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 は登録商標ですか」	特定語句の検索
「知的財産権の問題で出品が取り下げられますか」	コンプライアンス審査
「このキーワードがブランドを侵害していないか確認して」	キーワードの安全性確認

該当しない場合 -- テキストによる商標検出以外の対応が必要な場合：

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

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

36 計算リソースを消費します。

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

フィードバック：

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

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

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

---

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