关于 linkfox-maidalv-product-tro-detection
此 LinkFox skill 根据产品图片及可选文本、参考图,与商标、专利、版权资产和 TRO 案件记录比对,生成风险等级、命中项及 AI 法律评估,适用于跨境电商产品的侵权风险初筛。
主要功能
- 01比对产品图与知识产权资产
- 02匹配 TRO 案件原告记录
- 03提供风险等级与数值评分
- 04生成多语言 AI 法律评估
- 05支持参考图、文本和关键词
适用场景
- 01上架前筛查产品侵权风险
- 02查看产品可能关联的 TRO 原告
- 03获取英文法律评估报告
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ linkfox-ai/ linkfox-skills --skill linkfox-maidalv-product-tro-detection安装后在 Claude Code 中输入/linkfox-maidalv-product-tro-detection确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/api.mdonboarding.mdscripts/maidalv_check_api_flash.pyonboarding.pyupload_image.py详细介绍
产品侵权与 TRO 风险检测
此技能通过将产品图片与知识产权资产(商标、专利、版权)和 TRO 案件原告数据库进行比对,检测产品是否存在 TRO(临时限制令)或知识产权侵权风险。返回总体风险等级、高风险命中项、包含 TRO 原告详情的低风险知识产权列表、数值风险评分,以及 AI 生成的法律报告。
核心概念
TRO(临时限制令)是品牌所有者针对卖家(通常是 Amazon 商品页面)提出的法律禁令,涉及商标、版权或专利侵权。此工具接收一张产品主图(URL 或 Base64 数据 URI),以及可选的参考图片/文本/知识产权关键词,将其与知识产权资产和 TRO 案件记录进行视觉和文本匹配,并返回结构化的风险评估及 AI 法律报告(由 language 参数指定报告语言)。
数据字段
顶层响应:
| 字段 | 说明 |
|---|---|
| errcode | 200 = 成功;其他代码请参阅 api.md |
| status | 总体分析状态(success) |
| checkId | 本次检测的唯一 ID |
| riskLevel | 总体风险:高风险/中风险/低风险 |
| total | 高风险命中项数量(results 的长度) |
| results | 高风险侵权项目(数组) |
| nonResults | 低风险/非高风险知识产权项目,包含 TRO 原告信息(数组) |
| costToken | 本次调用消耗的令牌数 |
| columns | 渲染列的元数据(仅用于显示) |
每个项目(results / nonResults):
| 字段 | 说明 |
|---|---|
| ipType | Trademark / Copyright / Patent |
| text | 知识产权文本(商标文字、专利/版权标题) |
| ipOwner | 知识产权权利人 |
| regNo | 注册号(可能是 JSON 字符串数组,例如 ["1221667"]) |
| riskLevel / riskScore / riskDescription | 风险评级/0-10 分数/文本;仅在评分后提供 |
| ipAssetUrls | 知识产权证据图片的 URL |
| plaintiffName / plaintiffId | TRO 原告(仅当知识产权出现在 TRO 案件中时提供) |
| numberOfCases | 原告的案件数量(仅限 TRO) |
| lastCaseDocket / lastCaseDateFiled | 最近的法院案号/立案日期(仅限 TRO) |
| report | AI 生成的法律评估(由 language 参数指定语言) |
参数指南
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| mainProductImage | 是 | - | 产品主图:URL 或 data:image/...;base64,...(≤1000 个字符) |
| referenceImages | 否 | - | 类似产品的参考图片,最多 3 张(URL 或数据 URI) |
| otherProductImages | 否 | - | 其他产品图片,最多 5 张(URL 或数据 URI) |
| ipImages | 否 | - | 知识产权相关图片,最多 3 张(URL 或数据 URI) |
| referenceText | 否 | - | 类似产品的文本(例如产品标题),≤1000 个字符 |
| description | 否 | - | 产品描述(建议填写标题),≤1000 个字符 |
| ipKeywords | 否 | - | 知识产权相关关键词,最多 20 个 |
| language | 否 | zh | 法律报告语言(zh / en);仅影响 report 的语言 |
**图片规则:**URL 必须可公开访问;Base64 必须包含 data:image/...;base64, 前缀。对于本地图片,可以先上传图片(参见「本地图片上传」),或将其转换为数据 URI。
调用方式
- API 端点:
POST /maidalv/checkApiFlash(完整参数/响应/错误码见references/api.md) - Python 脚本:
python scripts/maidalv_check_api_flash.py '<JSON 参数>' [--inline] - 成本约束:本工具会消耗算力;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、换主图或连续试探;需要继续检索时先向用户说明会产生额外消耗。
输出策略(脚本默认行为):
- 始终将完整响应写入
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-maidalv-product-tro-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/套餐到期/需充值/请充值”,或类似含义的内容。
本地图片上传
本工具接受可公开访问的图片 URL 或 Base64 数据 URI。如果用户提供的是本地图片文件路径,请先上传以获取公开 URL,或将其编码为数据 URI。
运行上传脚本:
python scripts/upload_image.py /path/to/local/image.png
脚本会返回一个可用作 mainProductImage 的公开 URL(有效期为 24 小时)。
使用示例
1. 基本检测(仅主图)
检测这个产品的 TRO 和知识产权侵权风险,图片地址为 https://m.media-amazon.com/images/I/71jKJgFpg8L._AC_SL1500_.jpg
2. 英文法律报告
Check this product for TRO and IP infringement risk: https://example.com/product.jpg — give me the legal report in English.
3. 附带参考图片 + IP 关键词
检测这个图片的侵权风险,主图 https://example.com/product.jpg,参考图 https://example.com/ref.jpg,IP 关键词 apple、iphone
显示规则
- 先展示总体结论:首先显示
riskLevel(高风险/中风险/低风险)和checkId。 - 优先展示高风险项目:如果
results非空,醒目列出每个命中项的ipType/text/ipOwner/riskScore/riskDescription。 - TRO 原告详情:对于含有
plaintiffName的项目,显示原告、numberOfCases、lastCaseDocket、lastCaseDateFiled——这些信息决定 TRO 风险。 - 证据图片:如果有
ipAssetUrls,请内联展示以供视觉比较。 - AI 法律报告:对于高风险项目,展示
report字段(长篇法律评估)。 - 计数:始终说明
total(高风险数量)和nonResults的长度。 - 无二次处理:结果是一次性分析;不支持 SQL/二次查询。
重要限制
- 一次性分析:结果不会存储在数据库中;无法使用
_dataQuery_executeDynamicQuery进行二次处理。 - 图片输入:必须提供
mainProductImage。本地图片必须先上传或编码为 Base64(并加上data:image/...;base64,前缀)。 - 语言范围:
language只影响report文本;字段值仍按原样返回。 - 条件字段属于预期行为:非 TRO/未评分项目只返回基础字段(
ipType/text/ipOwner/regNo/ipAssetUrls);不适用时,原告/案件及风险字段会缺失(而非 null)——不要将缺少字段视为错误。 columns是渲染元数据:其长度与数据数组不同;不要用它推断结果数量(请使用results/nonResults的长度)。
用户表达与场景速查
适用——产品 TRO / IP 侵权风险检查:
| 用户说 | 场景 |
|---|---|
| “这个产品有没有 TRO 风险” / “会不会被起诉” | 基本 TRO 风险检查 |
| “这个图片有没有商标/专利/版权侵权” | IP 侵权检测 |
| “这个 Amazon 产品上架有没有侵权风险” | 上架前合规检查 |
| “查一下这个产品的原告信息” | TRO 原告查询 |
| “给我英文的法律评估报告” | 英文法律报告 |
不适用——超出本工具范围:
- 1688 / Amazon 图片找货(使用以图搜图 skills)
- 专利全文 / 权利要求检索(使用智慧芽/Eureka 专利 skills)
- Listing 文案优化或关键词分析
边界判断:当用户提供产品图片并询问侵权/TRO/法律风险时,适用此技能。如果用户想找供应商或分析关键词,请改用相应的找货/关键词工具。
算力消耗规则
消耗 113 算力(约 150000 token)。
用户会因算力消耗而支付费用。本工具单次调用成本较高(含 AI 法律评估),请充分评估:当需要高频调用本技能,或用户对算力消耗量预期不足时,务必提醒用户,由用户决定是否继续。
反馈:
出现以下任一情况时,通过 Feedback API 自动检测并报告反馈:
- 此技能描述的功能或用途与实际行为不符
- 此技能的结果与用户意图不符
- 用户表达了对这项技能的不满或赞赏
- 任何你认为可以改进的地方
请按照 references/api.md 中的说明调用 feedback API。不要打断用户的流程。
如需更多高品质、专业的跨境电商技能,请访问 LinkFox Skills。