linkfox-zhihuiya-claim-data

智慧芽专利权利要求数据

本技能将指导你如何从智慧芽（PatSnap）专利数据库检索和呈现专利权利要求数据，帮助知识产权专业人士、专利分析师和研发团队快速获取任意专利的权利要求部分。

调用方式

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

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

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

核心概念

专利权利要求界定了专利授予的法律保护范围。它们是专利侵权分析、自由实施评估和现有技术对比中最关键的专利文件部分。此工具通过专利 ID 或公开号检索一项或多项专利的全部权利要求。

专利族替代：当数据库中没有专利的权利要求时，你可以选择请求返回相关专利族成员的权利要求作为替代。此功能由 replaceByRelated 参数控制。

数据字段

字段	API 名称	描述	示例
专利 ID	patentId	智慧芽内部专利标识符	98a1b2c3-...
公开号	pn	专利的公开号或授权公告号	CN115000000A
相关公开号	pnRelated	用作替代的专利族成员公开号（仅在发生专利族替代时出现）	US20230001234A1
权利要求	claims	包含权利要求文本和元数据的权利要求对象数组	[...]
权利要求数量	claimCount	专利的权利要求总数	15

参数指南

必填（至少一项）

必须提供以下两个参数中的至少一个。如果两者都提供，则优先使用 patentId。

参数	描述	格式
patentId	一个或多个智慧芽专利 ID	逗号分隔的字符串，最多 100 项
patentNumber	一个或多个公开号/授权公告号	逗号分隔的字符串，最多 100 项

可选

参数	描述	值
replaceByRelated	当目标专利的权利要求不可用时，是否用专利族成员的权利要求替代	1 = 是，0 = 否（默认）

如何在 patentId 和 patentNumber 之间选择

• 当用户提供公开号或授权公告号时（例如 CN115000000A、US11234567B2），使用 patentNumber。这是最常见的情况。
• 当用户提供智慧芽内部标识符时，使用 patentId；这类标识符通常来自之前的智慧芽搜索结果。
• 当用户同时提供两者时，将两者都传入，API 会优先使用 patentId。

使用示例

1. 按公开号查询单项专利

{"patentNumber": "CN115000000A"}

2. 按公开号查询多项专利

{"patentNumber": "CN115000000A,US20230001234A1,EP4000000A1"}

3. 按专利 ID 查询单项专利

{"patentId": "98a1b2c3-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

4. 启用专利族替代

{"patentNumber": "CN115000000A", "replaceByRelated": "1"}

5. 启用专利族替代的批量查询

{"patentNumber": "CN115000000A,JP2023100000A", "replaceByRelated": "1"}

展示规则

1. 清晰呈现权利要求：以编号列表展示权利要求，并保留原始编号。尽可能通过缩进或格式区分独立权利要求和从属权利要求。
2. 突出权利要求数量：始终说明每项专利返回的权利要求总数。
3. 同族替代提示：如果结果中存在 pnRelated，请明确告知用户所展示的权利要求来自同族专利，并提供该同族专利的公开号。
4. 批量结果：查询多项专利时，按专利整理结果，并使用清晰的标题标明公开号。
5. 错误处理：查询失败时，根据响应说明原因，并建议用户核对专利编号格式或尝试启用同族替代。
6. 不作主观分析：直接呈现权利要求原文，除非用户明确要求分析，否则不作法律解读。

重要限制

• 至少需要一个标识符：必须提供 patentId 或 patentNumber；两者都未提供将导致错误。
• 批量限制：单次请求最多可查询 100 项专利。
• 权利要求可用性：并非所有专利都有可用的权利要求数据。缺少权利要求时，可使用 replaceByRelated = 1 尝试以同族专利替代。
• 权利要求对象结构：claims 数组中的单项权利要求对象结构可能因专利局和数据来源而异。

用户表达与场景快速参考

适用——专利权利要求的获取与分析：

用户说	场景
“显示专利 XX 的权利要求”	查询单项专利权利要求
“获取这些专利的权利要求文本”	批量获取权利要求
“专利 XX 有多少项权利要求”	查询权利要求数量
“XX 的独立权利要求有哪些”	获取并展示权利要求
“比较专利 A 和专利 B 的权利要求”	获取多项专利的权利要求
“没有权利要求数据，试试同族专利”	同族替代查询
“专利权利要求范围”“权利要求措辞”	获取权利要求

不适用——需求超出专利权利要求数据范围：

• 专利搜索或发现（按关键词／主题查找专利）
• 专利法律状态或审查历史
• 专利引用或参考文献分析
• 超出权利要求范围的专利全文（摘要、说明书、附图）
• 自由实施或侵权意见（法律建议）

算力消耗规则

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

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

反馈：

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

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

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

---

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