linkfox-ruiguan-text-trademark-detection

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ruiguan Text Trademark Detection

Ruiguan 文字商标检测

This skill guides you on how to perform text-based trademark detection against product titles and other product text, helping e-commerce sellers identify potential trademark infringement risks before publishing listings.

本技能将指导您如何针对产品标题及其他产品文本进行基于文字的商标检测，帮助电商卖家在发布Listing前识别潜在的商标侵权风险。

Core Concepts

核心概念

Text Trademark Detection scans product text (titles, descriptions, bullet points) against registered trademark databases across 15 countries/regions. It returns matched trademarks along with risk scores, registration details, and holder information so sellers can avoid intellectual property violations.

Risk score logic: The

highestModeScore

field ranges from 0 to 5 -- a higher value indicates greater infringement risk. The

textTrademarkRadar

field classifies overall product risk into three levels: 0 (low risk), 1 (needs manual review), 2 (high risk).

Blacklist and whitelist: The response may include

blacklistTrademarks

(known dangerous trademarks to always avoid) and

whitelistTrademarks

(safe trademarks that can be ignored). Always surface blacklist matches prominently to the user.

文字商标检测会扫描产品文本（标题、描述、五点描述），并与15个国家/地区的注册商标数据库进行比对。返回匹配的商标信息及风险评分、注册详情和持有人信息，帮助卖家避免知识产权违规。

风险评分逻辑：

highestModeScore

字段范围为0到5——数值越高表示侵权风险越大。

textTrademarkRadar

字段将产品整体风险分为三个等级：0（低风险）、1（需人工审核）、2（高风险）。

黑名单与白名单：响应结果可能包含

blacklistTrademarks

（需始终规避的高风险已知商标）和

whitelistTrademarks

（可忽略的安全商标）。需始终向用户突出显示黑名单匹配结果。

Parameters

参数

Parameter	Type	Required	Description	Example
productTitle	string	Yes	Product title to scan (max 1000 chars)	Wireless Bluetooth Headphones Noise Cancelling
regions	string	No	Country/region codes, comma-separated. Supported: US, EM, GB, DE, FR, IT, ES, AU, CA, MX, JP, CN, WO, TR, BX	US,EM,GB
limit	integer	Yes	Max number of results to return (default 100, max 500)	100
productText	string	No	Additional product text such as bullet points, description (max 1000 chars)	Ergonomic design with premium sound quality

Parameter	Type	Required	描述	示例
productTitle	string	Yes	需扫描的产品标题（最多1000字符）	Wireless Bluetooth Headphones Noise Cancelling
regions	string	No	国家/地区代码，以逗号分隔。支持的代码：US, EM, GB, DE, FR, IT, ES, AU, CA, MX, JP, CN, WO, TR, BX	US,EM,GB
limit	integer	Yes	返回结果的最大数量（默认100，上限500）	100
productText	string	No	额外的产品文本，如五点描述、详情描述（最多1000字符）	Ergonomic design with premium sound quality

Supported Regions

支持的地区

Code	Region
US	United States
EM	European Union
GB	United Kingdom
DE	Germany
FR	France
IT	Italy
ES	Spain
AU	Australia
CA	Canada
MX	Mexico
JP	Japan
CN	China
WO	WIPO (World Intellectual Property Organization)
TR	Turkey
BX	Bolivia

When the user does not specify a region, default to US.

代码	地区
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]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<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（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /ruiguan/textTrademarkDetection
```
（完整参数/响应/错误码详见
```
references/api.md
```
）

Python 脚本：

python scripts/ruiguan_text_trademark_detection.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认仅调用一次，脚本带有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
```
参数可强制将全量内容打印到标准输出（同时仍会写入文件）

读数据建议：先查看摘要判断信息是否足够；如需具体字段，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免将整份JSON导入上下文。

解决认证和积分问题

认证与积分问题解决

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

出现以下异常情况时，按照

references/onboarding.md

中的指引解决：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

How to Build Requests

请求构建指南

Principles

原则

Include the full product title: Always pass the complete product title in
```
productTitle
```
-- partial text may miss trademark matches.
Choose target regions: Select regions matching the marketplaces where the product will be sold. Use comma-separated codes for multi-region checks.
Provide additional text when available: If the user has bullet points, descriptions, or backend keywords, include them in
```
productText
```
for a more thorough scan.
Set an appropriate limit: Use the default of 100 for standard checks. Increase up to 500 when scanning titles with many potential matches.

提供完整产品标题：始终将完整产品标题传入
```
productTitle
```
参数——部分文本可能会遗漏商标匹配结果。
选择目标地区：选择与产品销售市场对应的地区代码，多地区检查使用逗号分隔多个代码。
提供额外文本（如有）：若用户有五点描述、详情描述或后台关键词，将其传入
```
productText
```
参数以进行更全面的扫描。
设置合适的结果数量上限：标准检查使用默认值100；当扫描包含多个潜在匹配项的标题时，可将上限提高至500。

Usage Examples

使用示例

1. Basic US Trademark Check for a Product Title

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

2. Multi-Region Check (US + EU + UK)

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

3. Full Listing Scan with Additional Text

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. Broad Global Check

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. China Domestic Market Check

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

1. 针对产品标题的基础美国商标检查

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

2. 多地区检查（美国+欧盟+英国）

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

3. 包含额外文本的完整Listing扫描

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

Display Rules

展示规则

Risk-first presentation: Always highlight the overall risk level (
```
textTrademarkRadar
```
) at the top of results. Use clear language: "Low Risk", "Needs Manual Review", or "High Risk".
Blacklist prominence: If
```
blacklistTrademarks
```
is non-empty, display them first with a clear warning.
Table format: Present trademark matches in a table with columns: Trademark Name, Region, Risk Score, Status, Holder, Application Number, Famous, Amazon Brand, Active Holder.
Score explanation: Remind users that
```
highestModeScore
```
ranges from 0 (safe) to 5 (highest risk).
Whitelist reassurance: If
```
whitelistTrademarks
```
contains entries, note them as safe/exempted trademarks.
Error handling: When a request fails, explain the issue and suggest the user check their product title or adjust regions.
No legal advice: Always remind users that results are for reference only and do not constitute legal advice. Recommend consulting an IP attorney for definitive trademark clearance.

风险优先展示：始终在结果顶部突出显示整体风险等级（
```
textTrademarkRadar
```
），使用清晰表述：“低风险”、“需人工审核”或“高风险”。
黑名单突出显示：若
```
blacklistTrademarks
```
非空，需首先显示这些内容并附上明确警告。
表格格式呈现：将商标匹配结果以表格形式展示，列包括：商标名称、地区、风险评分、状态、持有人、申请号、知名商标、亚马逊品牌、有效持有人。
评分说明：提醒用户
```
highestModeScore
```
范围为0（安全）到5（最高风险）。
白名单安心提示：若
```
whitelistTrademarks
```
包含内容，需注明这些是安全/豁免商标。
错误处理：当请求失败时，说明问题并建议用户检查产品标题或调整地区。
不提供法律建议：始终提醒用户结果仅供参考，不构成法律建议。建议咨询知识产权律师以获得明确的商标许可意见。

Important Limitations

重要限制

Text-only detection: This tool detects trademarks in text. It does not analyze logos, images, or design marks.
Result cap: Maximum 500 results per request.
Character limit: Both
```
productTitle
```
and
```
productText
```
are limited to 1000 characters each.
Database coverage: Covers 15 countries/regions. Trademarks registered in other jurisdictions may not be detected.

仅支持文字检测：本工具仅检测文本中的商标，不分析logo、图片或设计商标。
结果数量上限：每次请求最多返回500条结果。
字符限制：
```
productTitle
```
和
```
productText
```
参数均限制为最多1000字符。
数据库覆盖范围：覆盖15个国家/地区，在其他司法管辖区注册的商标可能无法被检测到。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Trademark risk analysis for product text:

User Says	Scenario
"Check my title for trademark issues"	Basic trademark scan
"Is this product name safe to use"	Infringement risk check
"Scan my listing for brand violations"	Full listing scan
"Any trademark risks in this title"	Risk assessment
"Check trademarks in US and EU"	Multi-region check
"Is XX a registered trademark"	Specific term lookup
"Will my listing get taken down for IP"	Compliance screening
"Check if this keyword infringes any brand"	Keyword safety check

Not applicable -- Needs beyond text trademark detection:

Logo or image-based trademark analysis
Patent infringement checks
Copyright detection
Legal opinions or litigation strategy
Trademark registration or filing assistance

适用场景——产品文本的商标风险分析：

用户表述	场景
"检查我的标题是否存在商标问题"	基础商标扫描
"这个产品名称可以安全使用吗"	侵权风险检查
"扫描我的Listing是否存在品牌违规"	完整Listing扫描
"这个标题有任何商标风险吗"	风险评估
"检查美国和欧盟的商标情况"	多地区检查
"XX是注册商标吗"	特定术语查询
"我的Listing会因知识产权问题被下架吗"	合规筛查
"检查这个关键词是否侵犯任何品牌权益"	关键词安全检查

不适用场景——超出文字商标检测范畴的需求：

基于logo或图片的商标分析
专利侵权检查
版权检测
法律意见或诉讼策略
商标注册或申请协助

积分消耗规则

消耗 59 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

消耗59积分。

用户会因积分消耗产生费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，通过Feedback API自动检测并提交反馈：

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不匹配
用户表达了对本技能的不满或赞赏
任何您认为可以改进的内容

按照

references/api.md

中的说明调用反馈API，请勿中断用户流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。