linkfox-ruiguan-text-trademark-detection

睿冠文本商标检测

本技能将指导你如何针对商品标题和其他商品文本进行文本商标检测，帮助电商卖家在发布商品信息前识别潜在的商标侵权风险。

核心概念

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

风险评分逻辑：highestModeScore 字段的取值范围为 0 到 5，数值越高表示侵权风险越大。textTrademarkRadar 字段将商品的整体风险划分为三个级别：0（低风险）、1（需要人工审核）、2（高风险）。

黑名单和白名单：响应可能包含 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]
• 成本约束：本工具会消耗算力；同一会话中，相同参数组合默认只调用一次，脚本带有 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 进入上下文。

解决认证和算力问题

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

异常情况

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

如何构建请求

原则

1. 包含完整商品标题：始终在 productTitle 中传入完整商品标题，部分文本可能会漏掉商标匹配结果。
2. 选择目标地区：选择与商品销售市场相符的地区。进行多地区检查时，使用逗号分隔的代码。
3. 有其他文本时一并提供：如果用户提供了要点、描述或后台关键词，请将其加入 productText，以进行更全面的扫描。
4. 设置合适的 limit：常规检查使用默认值 100。扫描可能匹配项较多的标题时，可将上限提高到 500。

使用示例

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. 扫描完整商品信息并检查其他文本

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. 不提供法律建议：始终提醒用户，结果仅供参考，不构成法律建议。建议咨询知识产权律师，以获得明确的商标检索结论。

重要限制

• 仅检测文本：此工具可检测文本中的商标，不会分析徽标、图片或图形商标。
• 结果上限：每次请求最多返回 500 条结果。
• 字符数限制：productTitle 和 productText 的长度均不得超过 1000 个字符。
• 数据库覆盖范围：涵盖 15 个国家/地区。可能无法检测到在其他司法管辖区注册的商标。

用户表达与场景速查

适用——针对商品文本的商标风险分析：

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

不适用——超出文本商标检测范围的需求：

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

算力消耗规则

消耗 36 算力。

重要：本技能消耗大量算力，如果调用次数超过5次，必须用AskUserQuestion 和用户进行二次确认，要明确告知用户已消耗算力和继续调用的话预计消耗的算力，让用户自行决定是否继续。

反馈：

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

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户对该技能表示不满或赞扬
4. 你认为有任何可以改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

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