linkfox-ruiguan-trademark-graphic-detection

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ruiguan Graphic Trademark Detection

Ruiguan图形商标检测

This skill guides you on how to detect graphic trademarks in product images, helping e-commerce sellers and brand owners identify potential trademark infringement risks before listing products.

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

Core Concepts

核心概念

Graphic trademark detection analyzes a product image to find visually similar registered trademarks across multiple countries and regions. The tool uses YOLO-based object detection to locate logo-like regions in the image, then compares them against trademark databases worldwide.

Similarity score: A higher

similarity

value means the detected graphic is more visually similar to the registered trademark. Values closer to 1.0 indicate near-identical matches and higher infringement risk.

Trademark status meanings:

Status	Meaning
registered	Trademark is actively registered
act	Trademark is active
pend	Trademark application is pending
filed	Trademark application has been filed
ended	Trademark has expired
DEL	Trademark has been deleted/cancelled

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

相似度评分：

similarity

值越高，表明检测到的图形与已注册商标的视觉相似度越高。数值越接近1.0，说明匹配度近乎一致，侵权风险越高。

商标状态含义:

状态	含义
registered	商标处于有效注册状态
act	商标处于有效状态
pend	商标申请处于待审状态
filed	商标申请已提交
ended	商标已过期
DEL	商标已删除/撤销

Parameter Guide

参数指南

Parameter	Required	Description	Default
imageUrl	Yes	Product image URL or base64-encoded image data	-
topNumber	Yes	Maximum number of detection results to return (1-100)	5
productTitle	No	Product title, helps improve detection accuracy	-
trademarkName	No	Suspected logo name, helps narrow down results	-
regions	No	Country/region codes to check, comma-separated. If omitted, all countries are searched	All
enableLocalizing	No	Whether to enable image cropping for detected regions	false
enableRadar	No	Whether to enable radar monitoring	true

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

Supported Regions

支持的地区

US (United States), WO (WIPO), ES (Spain), GB (United Kingdom), DE (Germany), IT (Italy), CA (Canada), MX (Mexico), EM (European Union), AU (Australia), FR (France), JP (Japan), TR (Turkey), BX (Benelux), CN (China)

When the user does not specify a region, omit the

regions

parameter so all countries are searched by default.

US (美国), WO (世界知识产权组织), ES (西班牙), GB (英国), DE (德国), IT (意大利), CA (加拿大), MX (墨西哥), EM (欧盟), AU (澳大利亚), FR (法国), JP (日本), TR (土耳其), BX (比荷卢经济联盟), CN (中国)

当用户未指定地区时，省略

regions

参数，默认搜索所有国家。

Local Image Upload

本地图片上传

This tool requires a publicly accessible image URL. If the user provides a local image file path (e.g.,

C:\Users\...\photo.png

/home/.../image.jpg

), you must upload it first to obtain a public URL.

Run the upload script:

bash

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

The script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.

本工具需要可公开访问的图片URL。如果用户提供本地图片文件路径（例如

C:\Users\...\photo.png

、

/home/.../image.jpg

），您必须先上传图片以获取公开URL。

运行上传脚本：

bash

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

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

Usage Examples

使用示例

1. Basic image trademark check Detect trademarks in a product image across all regions, returning up to 10 results:

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

2. Region-specific trademark check Check a product image against US and EU trademark databases only:

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

3. Detailed check with product context Provide product title and suspected logo name for more accurate detection:

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

4. Full detection with image cropping Enable localizing to get cropped images of detected logo regions:

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

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. 结合产品上下文的详细检测 提供产品标题和疑似Logo名称以获得更准确的检测结果：

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

4. 启用图片裁剪的完整检测 启用localizing功能以获取检测到的Logo区域的裁剪图片：

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

调用方式

API 端点：

POST /ruiguan/trademarkGraphicDetection

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

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

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-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/trademarkGraphicDetection

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

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

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-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 引导解决问题：

发生以下异常情况时，按照

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/套餐到期/需充值/请充值"或类似含义的内容。

Display Rules

展示规则

Present results clearly: Show detection results in a well-structured table including trademark image, similarity score, trademark name, status, registration office, Nice classification, applicant name, and key dates
Highlight high-risk matches: When similarity is above 0.8, explicitly warn the user about high infringement risk
Explain trademark status: When showing results, clarify what each trademark status means for the user's risk assessment
Radar results: If
```
radarResult
```
is present in the response, display it prominently as it contains aggregated risk assessment
Sub-radar results: If individual items contain
```
subRadarResult
```
, include this information alongside each match
Region context: Always indicate which regions were searched so the user understands the scope of the check
Error handling: When a detection fails, explain the reason based on the response and suggest adjustments (e.g., using a clearer image, specifying regions, adjusting topNumber)

清晰呈现结果：以结构清晰的表格展示检测结果，包括商标图片、相似度评分、商标名称、状态、注册机构、Nice分类、申请人名称及关键日期
高亮高风险匹配项：当相似度高于0.8时，明确向用户警告存在高侵权风险
解释商标状态：展示结果时，向用户说明各商标状态对风险评估的意义
雷达结果：若响应中包含
```
radarResult
```
，需突出展示，因为它包含了聚合风险评估信息
子雷达结果：若单个条目包含
```
subRadarResult
```
，需将该信息与对应匹配项一同展示
地区上下文：始终注明搜索的地区范围，以便用户了解检测的覆盖范围
错误处理：当检测失败时，根据响应信息解释原因并建议调整方案（例如使用更清晰的图片、指定地区、调整topNumber）

Important Limitations

重要限制

Image requirement: The
```
imageUrl
```
parameter is mandatory; the tool cannot perform detection without an image
Result cap: The
```
topNumber
```
parameter caps at 100 results per request
Image quality: Detection accuracy depends on image resolution and clarity; higher quality images yield better results
Region coverage: Not all countries are covered; the supported list includes 15 major trademark offices

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

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Graphic trademark detection tasks:

User Says	Scenario
"Check if this image has trademark issues"	Basic trademark detection
"Is this logo registered anywhere"	Multi-region trademark search
"Trademark risk for my product image"	Product listing risk assessment
"Find similar trademarks to this graphic"	Similarity search
"Check this image against US trademarks"	Region-specific detection
"Does this design infringe any trademark"	Infringement risk check
"Scan my product photo for logos"	Logo detection in product images

Not applicable -- Needs beyond graphic trademark detection:

Text/word trademark search (no image involved)
Trademark registration or filing
Patent or copyright checks
Legal advice on trademark disputes
Product listing optimization

Boundary judgment: When users say "check my product" or "is this safe to sell", if the concern relates to graphic elements or logos in product images potentially infringing registered trademarks, this skill applies. If they are asking about text trademarks, patent issues, or general legal compliance, it does not apply.

适用场景 -- 图形商标检测任务：

用户表述	场景
"检查这张图片是否存在商标问题"	基础商标检测
"这个Logo在任何地方都已注册吗"	多地区商标搜索
"我的产品图片的商标风险"	产品上架风险评估
"查找与该图形相似的商标"	相似度搜索
"针对美国商标检查这张图片"	指定地区检测
"这个设计是否侵犯了任何商标权"	侵权风险检查
"扫描我的产品照片查找Logo"	产品图片中的Logo检测

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

文字商标搜索（无图片涉及）
商标注册或申请
专利或版权检查
商标纠纷的法律咨询
产品上架优化

边界判断：当用户说"检查我的产品"或"这个可以安全售卖吗"时，如果关注点是产品图片中的图形元素或Logo可能侵犯已注册商标，则适用本技能。如果用户询问的是文字商标、专利问题或一般合规性，则不适用。

积分消耗规则

按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

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.

按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

反馈:

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

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

按照

references/api.md

中的指定方式调用反馈API，请勿中断用户流程。

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