Skip to main content
skill CX Codex

linkfox-ruiguan-text-trademark-detection — Claude Code skill

linkfox-ruiguan-text-trademark-detection — a skill for Claude Code and Codex that screens product titles, descriptions, and keywords for text trademark matches. It checks target sales regions before a listing goes live.

MIT 235 installs ★ 125 updated 2026-11-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ruiguan-text-trademark-detection -a claude-code
Open on GitHub

What linkfox-ruiguan-text-trademark-detection does

The skill checks product titles, descriptions, and keywords for text trademark conflicts in target markets. Output starts with textTrademarkRadar status and a 0 to 5 highestModeScore. Blacklisted terms surface first.

Requests go through scripts/ruiguan_text_trademark_detection.py. The script caches identical calls locally for 24 hours and writes JSON responses under linkfox/ in your working directory or ACPX_WORKSPACES. Payloads over 8 KB print a summary instead of raw JSON unless you pass --inline.

Running the script requires Python and either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. If the target folder is not writable, execution stops because /tmp fallback is blocked. Each uncached query costs 36 compute credits, and agents pause for confirmation after five calls. Visual logos, patents, and copyrights stay out.

What it helps with

  • screen a product title for registered text trademarks before listing
  • check descriptions and backend keywords across multiple sales regions
  • flag blacklisted brand terms and active enforcers in listing copy
  • pull filing numbers, Nice classes, and owner details into one table

Example prompts for the agent

  • Check this wireless earbuds title for text trademark risks in the US market.
  • Screen the title and description of this power bank for trademark conflicts across the US, EU, and UK.
  • Scan my water bottle listing title and bullet points for brand words before I publish.

How to install linkfox-ruiguan-text-trademark-detection

1Skills CLI (Vercel)

npx skills add linkfox-ai/linkfox-skills --skill linkfox-ruiguan-text-trademark-detection -a claude-code

2Manually: put the files in place

~/.claude/skills/linkfox-ruiguan-text-trademark-detection/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linkfox-ruiguan-text-trademark-detection/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linkfox-ruiguan-text-trademark-detection

How do I install linkfox-ruiguan-text-trademark-detection in Claude Code?

Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-ruiguan-text-trademark-detection -a claude-code in your terminal. Before running queries, set LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY in your environment.

What does linkfox-ruiguan-text-trademark-detection do?

It scans e-commerce titles, descriptions, bullet points, and keywords for text trademark matches across chosen markets. The output includes a 0 to 5 risk score, owner and filing records, and blacklist or whitelist flags.

Does linkfox-ruiguan-text-trademark-detection check logos or provide legal advice?

No. It only screens text and ignores images, logos, patents, and copyrights. Its scores and matched records act as initial screening evidence rather than legal advice or an infringement ruling.

Source text

SKILL.md · MIT
---
name: linkfox-ruiguan-text-trademark-detection
description: 检测电商商品标题、描述、五点描述及关键词中的文字商标风险,返回匹配商标、风险评分、注册信息、权利人和黑白名单。适用于上架前 Listing 商标筛查、品牌词风险检查、多地区文字商标查询和知识产权风险初筛,无需明确提及睿观或 Ruiguan。不适用于图片或 Logo 商标识别、专利或版权检测、法律意见、诉讼策略及商标注册申请。
---

# 睿观文本商标检测

## 适用范围

### 适用

检查商品文本中是否包含可能侵权的商标,帮助卖家在发布 Listing 前识别风险。
支持对产品标题、描述、五点描述和后台关键词做文字筛查,并按目标销售地区展示匹配证据。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 检查这个标题有没有商标问题 | 标题商标扫描。 |
| 这个产品名称可以安全使用吗 | 产品命名风险初筛。 |
| 帮我扫描 Listing 有没有品牌侵权 | 标题与附加文本联合检查。 |
| 检查美国和欧盟的商标风险 | 多地区文字商标筛查。 |
| 这个词是否为注册商标 | 查询该词的商标匹配记录及注册信息。 |
| 我的 Listing 会不会因知识产权被下架 | 提供文字商标风险证据与待核查项。 |
| 这个关键词有没有侵犯品牌 | 关键词商标安全性初筛。 |

## 前置条件

取得用户要检测的完整商品标题,并确认目标销售市场;用户已有描述、五点描述或后台关键词时,一并准备。请求默认值、地区代码、输入长度和返回限制见 `references/api.md`。

## 检测流程

1. 保留用户提供的完整标题,避免仅取片段导致漏检;收集已有的附加商品文本,不编造缺失内容。
2. 按商品计划销售的市场确定检测地区,依照 `references/api.md` 准备请求并检查参数限制。
3. 按潜在匹配数量选用适当的返回数量,优先复用同一参数已取得的结果;调用前遵守成本约束。
4. 根据响应中的整体风险、黑白名单、命中商标、权利人与注册信息组织结果,按下方展示规则解释风险和待核查项。
5. 遇到失败或空结果,按接口参考解释原因,建议核对标题或地区;后续调用遵守成本约束,不自动扩大检测范围。

## 执行方式

- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/ruiguan_text_trademark_detection.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

### 输出策略

- 完整响应保存到 `<root>/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-text-trademark-detection-<timestamp>.json`。`<root>` 通常为脚本工作目录下的 `linkfox/`;设置 `ACPX_WORKSPACES` 时优先使用其首个目录下的 `linkfox/`。`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。调用前检查工作目录和输出位置可写;不可写时停止并报错,禁止写入 `/tmp`。脚本的目录选择顺序及保存失败行为见 `references/api.md`,以实际保存提示核对输出文件。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

## 执行规则

### 算力消耗预估

36 算力 / 次

**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

费用复核要求:调用次数将超过 5 次时,必须先通过 `AskUserQuestion` 与用户二次确认,明确告知累计已消耗算力和继续调用预计消耗的算力,由用户决定是否继续。若没有该工具,用当前会话提问完成同等确认;已有明确覆盖该次数及费用范围的用户授权时沿用授权,不重复询问。缓存命中不计为新的付费调用;累计费用优先依据实际返回,尚不明确时标注估算。

### 解决认证和算力问题

出现以下情况时,按 `references/onboarding.md` 的指引处理:

- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

### 约束与建议

- **风险优先展示**:结果开头展示 `textTrademarkRadar` 对应的“低风险”“待人工核查”或“高风险”;缺失或未知值应如实说明,不自行补全。
- **解释风险分数**:`highestModeScore` 为 0–5,分数越高风险越大;0 表示最低风险,5 表示最高风险。整体风险与单条分数分别展示,字段定义见接口参考。
- **突出黑名单**:`blacklistTrademarks` 非空时优先展示并明确警示,提示避用命中的黑名单商标。
- **说明白名单**:`whitelistTrademarks` 中的商标按检测结果标注为安全或豁免项,说明在本次筛查中可忽略;不能据此保证所有地区、所有用途均无风险。
- **使用表格**:命中表至少展示商标名称、地区、风险分数、状态、权利人、申请号、是否著名商标、是否亚马逊热搜品牌及是否活跃维权人。保留注册号、尼斯分类、触发原词、匹配地区状态、兼容性和常用词等返回证据,供进一步核查。
- **区分证据与结论**:命中记录、无命中和风险分数均为筛查线索,不能保证是否构成侵权或是否会被平台下架。始终提示结果仅供参考,不构成法律意见;需要最终商标清查结论时咨询知识产权律师。
- **遵守检测范围**:仅做文本商标检测,不检测图片、Logo、图形商标、专利或版权,也不提供诉讼策略及商标注册申请服务。数据库覆盖和使用限制见接口参考。
- **解释错误**:依据 `references/api.md` 的基础规则和业务规则处理;认证与算力问题按上方引导解决,其他错误给出核对输入的建议。

## 使用示例

### 美国站标题筛查

用户:帮我检查这个无线耳机标题的商标风险。

使用完整标题,按接口参考的默认地区与返回数量准备检测,优先展示整体风险和黑名单,再展示命中证据。

### 多地区商品文本检查

用户:这个充电宝要在美国、欧盟和英国销售,标题和描述都帮我检查。

合并用户已有文本,按目标市场准备多地区请求,分别展示地区、权利人、注册信息与风险。

### 完整 Listing、广泛地区及中国市场检查

用户可要求检查水杯的标题和五点描述、直播灯的多个销售地区,或中文耳机标题的中国市场风险。按实际商品资料与市场选择范围;对应 JSON 示例和参数上限见 `references/api.md`。

## 使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。

---

更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。

© linkfox-ai · MIT · linkfox-ai/linkfox-skills

Similar skills

All skills for Marketing and content →

From the same set74

The whole set →
linkfox-echotik-list-product linkfox-echotik-list-product — a skill for Claude Code searches and compares TikTok Shop products through EchoTik. It supports product discovery by sales, commission, launch date, and creator activity. CX Codex +1 238installs linkfox-amazon-alexa-search The linkfox-amazon-alexa-search Claude Code skill asks Amazon’s Alexa shopping assistant for product recommendations and follow-up suggestions. It handles budget-based picks, comparisons, and questions tied to a specific page. CX Codex +1 237installs linkfox-shopee-store-product linkfox-shopee-store-product — a skill for Claude Code that handles catalog management for authorized Shopee stores. Adjusts SKU details, updates prices, tracks inventory levels, and pulls customer reviews. CX Codex +1 237installs linkfox-google-trend-get-trend-by-time linkfox-google-trend-get-trend-by-time — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Fetches rising Google Trends queries and relative search volume by region. CX Codex +1 237installs linkfox-echotik-list-new-product-rank The linkfox-echotik-list-new-product-rank Claude Code skill fetches EchoTik rankings for new TikTok Shop products by market. It shows sales, prices, and creator, video, and livestream activity. CX Codex +1 234installs linkfox-ruiguan-copyright-detection linkfox-ruiguan-copyright-detection — a skill for Claude Code checks images against registered copyright works. It returns rights-holder details, source records, radar findings, and TRO history. CX Codex +1 234installs linkfox-zhihuiya-description-data-translated linkfox-zhihuiya-description-data-translated — a skill for Claude Code, Codex, and Cursor that retrieves translated patent descriptions from PatSnap in English, Chinese, or Japanese. Queries by patent ID or publication number. CX Codex +1 234installs linkfox-keepa-product-request linkfox-keepa-product-request — a skill for Claude Code, Codex, Cursor, and related agents to pull Amazon product specs via Keepa. It extracts pricing, dimensions, sales history, and FBA fees directly by ASIN. CX Codex +1 233installs

Project sponsors

Companies that keep this analytics open