linkfox-ruiguan-graphic-trademark

瑞冠图形商标检测

本技能将指导你如何检测产品图片中的图形商标，帮助电商卖家和品牌所有者在上架产品前识别潜在的商标侵权风险。

核心概念

图形商标检测会分析产品图片，在多个国家和地区查找视觉上相似的注册商标。该工具使用基于 YOLO 的目标检测来定位图片中类似徽标的区域，然后将其与全球商标数据库进行比对。

相似度分数：similarity 值越高，检测到的图形与注册商标在视觉上越相似。值越接近 1.0，表示匹配越接近完全一致，侵权风险也越高。

商标状态含义：

状态	含义
registered	商标已注册且有效
act	商标处于有效状态
pend	商标申请待审核
filed	商标申请已提交
ended	商标已过期
DEL	商标已删除／取消

参数指南

参数	必填	描述	默认值
imageUrl	是	产品图片 URL 或 Base64 编码的图片数据	-
topNumber	是	返回的检测结果数量上限（1-100）	5
productTitle	否	产品标题，有助于提高检测准确率	-
trademarkName	否	疑似徽标名称，有助于缩小结果范围	-
regions	否	要检查的国家／地区代码，以逗号分隔。省略时将搜索所有国家	全部
enableLocalizing	否	是否启用检测区域的图片裁剪	false
enableRadar	否	是否启用雷达监控	true

支持的地区

US（美国）、WO（WIPO）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（比荷卢）、CN（中国）

用户未指定地区时，请省略 regions 参数，默认搜索所有国家。

上传本地图片

此工具需要可公开访问的图片 URL。如果用户提供的是本地图片文件路径（例如，C:\Users\...\photo.png、/home/.../image.jpg），你必须先上传图片以获取公开 URL。

运行上传脚本：

python scripts/upload_image.py /path/to/local/image.png

脚本会返回一个公开 URL（有效期为 24 小时），可将其用作图片 URL 参数。

使用示例

1. 基本图片商标检查 检测产品图片在所有地区的商标，最多返回 10 条结果：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10

2. 指定地区的商标检查 仅使用美国和欧盟商标数据库检查产品图片：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 5
regions: "US,EM"

3. 提供产品背景信息的详细检查 提供产品标题和疑似徽标名称，以提高检测准确率：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10
productTitle: "Wireless Bluetooth Headphones with Noise Cancellation"
trademarkName: "SonicWave"
regions: "US,GB,DE"

4. 启用图片裁剪的完整检测 启用区域定位，获取检测到的徽标区域的裁剪图片：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 20
enableLocalizing: true
regions: "US"

API 使用

此工具调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参见 references/api.md。你也可以直接运行 scripts/ruiguan_trademark_graphic_detection.py 来执行检测。

显示规则

1. 清晰呈现结果：使用结构清晰的表格展示检测结果，包括商标图片、相似度评分、商标名称、状态、注册局、尼斯分类、申请人名称和关键日期
2. 突出高风险匹配：当相似度高于 0.8 时，明确提醒用户存在较高的侵权风险
3. 说明商标状态：展示结果时，说明各商标状态对用户风险评估的意义
4. 雷达结果：如果响应中包含 radarResult，应突出显示，因为其中包含汇总风险评估
5. 子雷达结果：如果单项结果中包含 subRadarResult，请在每条匹配结果旁一并显示此信息
6. 地区背景：始终注明已搜索的地区，让用户了解检查范围
7. 错误处理：检测失败时，根据响应说明原因，并建议调整方式（例如使用更清晰的图片、指定地区、调整 topNumber）

重要限制

• 图片要求：imageUrl 参数为必填项；没有图片时，该工具无法执行检测
• 结果上限：每次请求最多返回 100 条结果，由 topNumber 参数限制
• 图片质量：检测准确度取决于图片分辨率和清晰度；图片质量越高，结果越好
• 地区覆盖范围：并非覆盖所有国家；支持列表包含 15 个主要商标局

用户表达与场景速查

适用——图形商标检测任务：

用户说法	场景
“检查这张图片是否存在商标问题”	基础商标检测
“这个徽标是否在任何地区注册过”	多地区商标搜索
“我的产品图片存在什么商标风险”	商品刊登风险评估
“查找与这幅图形相似的商标”	相似度搜索
“检查这张图片是否与美国商标相符”	特定地区检测
“这个设计是否侵犯任何商标”	侵权风险检查
“扫描我的产品照片中的徽标”	产品图片徽标检测

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

• 文字／词语商标搜索（不涉及图片）
• 商标注册或申请
• 专利或版权检查
• 商标争议方面的法律建议
• 商品刊登优化

边界判断：如果用户说“检查我的产品”或“这个产品是否可以放心销售”，且关注的是产品图片中的图形元素或徽标是否可能侵犯已注册商标，则适用此技能。如果用户询问的是文字商标、专利问题或一般法律合规，则不适用。

反馈：

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

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

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

处理大型响应

为避免撑爆 Agent 上下文，请将响应保存到磁盘，并仅提取所需字段：

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

此技能提供多个入口脚本：ruiguan_trademark_graphic_detection.py、upload_image.py。传入 --script scripts/<name>.py，选择所需脚本。

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

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

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

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

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

---

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