linkfox-ruiguan-text-trademark

锐观文本商标检测

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

核心概念

文本商标检测会将商品文本（标题、描述、要点）与覆盖 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 用法

此工具会调用 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. 多地区检查（美国 + 欧盟 + 英国）

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 是注册商标吗”	特定词语查询
“我的商品刊登会因知识产权问题被下架吗”	合规筛查
“检查这个关键词是否侵犯任何品牌”	关键词安全检查

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

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

反馈：

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

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

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

处理大型响应

为避免 Agent 上下文溢出，请将响应持久化到磁盘，并仅提取所需字段：

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%/...）。持久化的响应可能包含个人身份信息、定价或敏感认证数据，请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 可提取指定字段，并支持使用 --limit/--offset 分页，以及使用 --format json|jsonl|csv|table 指定输出格式。

适合采用此模式的情况——请根据响应特征自行判断，例如：

• 每条记录的字段很多，或包含不需要的字段
• 批量或分页结果（每次调用返回多个项目）
• 长文本字段（描述、评价、HTML、时间序列）
• 输出会在后续步骤中重复使用，而非立即处理

对于小型且仅使用一次的响应，直接调用主脚本即可。

⚠️ 预览内容是经过截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从持久化文件中读取。

---

如需获取更多优质、专业的跨境电商技能，请设置 LinkFox Skills。