linkfox-zhihuiya-patent-family

智慧芽专利族探索器

本技能将指导你如何通过智慧芽（PatSnap）平台查询专利族信息，帮助用户查找给定专利的简单同族、INPADOC 同族和 PatSnap 同族成员。

调用方式

• API 端点：POST /zhihuiya/patentFamily（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/zhihuiya_patent_family.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-family-<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/套餐到期/需充值/请充值”，或类似含义的内容。

核心概念

专利族是指一组通过优先权声明彼此关联的专利文献。不同的专利族定义所涵盖的关联范围各不相同：

• 简单同族：具有完全相同优先权申请集合的专利。这些通常是在不同国家提交的直接等同专利。
• INPADOC 同族：由欧洲专利局定义的较宽泛分组，将至少共享一项共同优先权（包括间接共享）的专利关联起来。
• PatSnap 同族：PatSnap（智慧芽）专有的专利族定义，在 INPADOC 逻辑基础上增加了启发式规则，以涵盖继续申请、分案申请和其他相关申请。

响应中的每件专利都包含其自身的 simpleFamilyId、inpadocFamilyId 和 patsnapFamilyId，这些字段分别作为各定义下专利族分组的唯一标识符。

参数指南

必须至少提供两个查询参数中的一个。如果两者都提供，则优先使用专利 ID。

参数	类型	必填	描述
patentId	字符串	有条件必填	专利 ID。多个值以逗号分隔。最多 100 项。
patentNumber	字符串	有条件必填	公开号/公告号。多个值以逗号分隔。最多 100 项。

规则：

1. 必须至少提供 patentId 或 patentNumber 中的一个。
2. 如果两者都提供，API 将使用 patentId 并忽略 patentNumber。
3. 多个值以逗号分隔（例如，"US10000001B2,EP3000001A1"）。
4. 每次请求最多可查询 100 件专利。

响应字段

字段	类型	描述
total	整数	返回的专利记录数
data	数组	专利族结果对象列表
data[].patentId	字符串	此记录的专利 ID
data[].pn	字符串	公开号/公告号
data[].simpleFamilyId	整数	简单同族分组的唯一标识符
data[].simpleFamily	数组	简单同族成员专利列表
data[].inpadocFamilyId	整数	INPADOC 同族分组的唯一标识符
data[].inpadocFamily	数组	INPADOC 同族成员专利列表
data[].patsnapFamilyId	整数	PatSnap 同族分组的唯一标识符
data[].patsnapFamily	数组	PatSnap 同族成员专利列表
columns	数组	用于呈现的列定义
costToken	整数	此请求消耗的 Token 数
type	字符串	呈现样式提示

使用示例

1. 按公开号查询专利同族

“查找 US10000001B2 的专利同族”

调用：

{"patentNumber": "US10000001B2"}

2. 一次查询多项专利的同族

“显示以下专利的 INPADOC 同族：EP3000001A1、CN112345678A、JP2020123456A”

调用：

{"patentNumber": "EP3000001A1,CN112345678A,JP2020123456A"}

3. 按专利 ID 查询

“获取专利 ID 5af83e12-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的专利同族”

调用：

{"patentId": "5af83e12-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

4. 比较同族范围

“我想了解 US20200012345A1 的 Simple Family 和 INPADOC Family 有何不同”

调用：

{"patentNumber": "US20200012345A1"}

然后比较响应中的 simpleFamily 和 inpadocFamily 数组。

显示规则

1. 清晰呈现数据：以结构清晰的表格展示专利同族结果。用户要求比较时，按同族类型（Simple、INPADOC、PatSnap）分组。
2. 汇总数量：始终说明每种同族类型下找到的同族成员数量，方便用户快速了解其地域覆盖范围。
3. 突出司法辖区：列出同族成员时，注明覆盖的国家/地区，帮助用户了解该专利的地域保护范围。
4. 错误处理：API 返回错误或结果为空时，说明可能的原因（专利号格式无效、数据库中未找到专利等），并建议如何更正。
5. 整理批量查询结果：查询多项专利时，按专利分别整理结果，方便用户查找。
6. 不提供主观法律建议：仅呈现客观的同族数据。不得就专利范围、有效性或侵权问题提供法律意见。

重要限制

• 仅支持查询：此工具可检索已知专利的同族信息，无法按关键词搜索专利或进行全文查询。
• 批量限制：每次请求最多可查询 100 个专利 ID 或公开号。
• 数据来源：同族数据来自智慧芽（PatSnap）数据库，可能略晚于专利局最新公布的数据。
• 同族成员详情：同族成员数组包含摘要对象。如需获取特定同族成员的完整书目信息，可能需要单独查询。

用户表达与场景速查

适用 -- 专利同族及等同专利查询：

用户说法	场景
“XX 的专利同族”	直接查询同族
“这项专利有哪些等同专利”	Simple 同族搜索
“这项专利在哪些国家提交了申请”	通过同族查询地域覆盖范围
“INPADOC 同族成员”	广泛查询同族
“相关专利／同族专利”	探索专利同族
“比较简单同族和扩展同族”	比较多种定义
“批量查询这些专利的同族”	批量查询同族

不适用 -- 需求超出专利同族查询范围：

• 按关键词或分类代码进行专利全文搜索
• 专利估值或诉讼数据
• 自由实施或侵权分析
• 专利申请提交或审查程序

算力消耗规则

按动态规则计费：消耗算力 = 81 × 返回 data 条数。每条为 1 条专利同族结果

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

反馈：

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

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

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

---

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