SuperAPI AI 工具集

linkfox-zhihuiya-claim-data

写作与研究

查看项目

更新于 10-15 09:05

技能介绍

用途

本技能用于从智慧芽(PatSnap)专利数据库检索并呈现专利权利要求数据,面向知识产权从业者、专利分析师和研发团队,帮助其快速获取任意专利的权利要求部分。权利要求界定专利授予的法律保护范围,是侵权分析、自由实施评估和现有技术对比中最关键的专利文件部分。

主要能力

  • 按专利 ID 或公开号检索一件或多件专利的完整权利要求集合。
  • 同族替代:当目标专利的权利要求在数据库中不可用时,可通过 replaceByRelated 参数请求返回相关同族专利的权利要求作为替代。
  • 返回数据字段包括:专利 ID(patentId)、公开号(pn)、同族替代公开号(pnRelated,仅在同族替代发生时出现)、权利要求数组(claims)、权利要求总数(claimCount)。

使用方式

调用方式有两种:

  • API 端点:POST /zhihuiya/claimData(完整参数、响应与错误码见 references/api.md)。
  • Python 脚本:python scripts/zhihuiya_claim_data.py '<JSON 参数>' [--inline]。

必填参数(至少提供一个,两者都提供时 patentId 优先):

  • patentId:一个或多个智慧芽专利 ID,逗号分隔字符串,最多 100 条。
  • patentNumber:一个或多个公开号/授权号,逗号分隔字符串,最多 100 条。

可选参数:

  • replaceByRelated:当目标专利权利要求不可用时是否用同族成员的权利要求替代,1 = 是,0 = 否(默认)。

参数选择建议:用户提供公开号或授权号(如 CN115000000A、US11234567B2)时使用 patentNumber,这是最常见场景;用户提供智慧芽内部标识(通常来自此前的智慧芽检索结果)时使用 patentId;两者都提供时 API 优先使用 patentId。

调用示例:

  • 按公开号查询单件专利:{"patentNumber": "CN115000000A"}
  • 按公开号查询多件专利:{"patentNumber": "CN115000000A,US20230001234A1,EP4000000A1"}
  • 按专利 ID 查询单件专利:{"patentId": "98a1b2c3-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}
  • 启用同族替代:{"patentNumber": "CN115000000A", "replaceByRelated": "1"}
  • 批量查询并启用同族替代:{"patentNumber": "CN115000000A,JP2023100000A", "replaceByRelated": "1"}

输出策略(脚本默认行为):

  • 始终将完整响应写入 <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 进入上下文。

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

认证与算力问题处理:发生以下异常情况时,采用 references/onboarding.md 引导解决——未配置 API Key(环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY);响应 401 或 402 状态码;响应提示算力或余额不足(消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"或类似含义内容)。

展示规则

  • 清晰呈现权利要求:以编号列表显示,保留原始权利要求编号;尽可能用缩进或格式区分独立权利要求与从属权利要求。
  • 突出权利要求数量:始终说明每件专利返回的权利要求总数。
  • 同族替代提示:若结果中出现 pnRelated,明确告知用户所显示的权利要求来自同族专利,并提供该同族专利的公开号。
  • 批量结果:查询多件专利时,按专利组织结果,用清晰标题显示公开号。
  • 错误处理:查询失败时,根据响应解释原因,并建议用户核实专利号格式或尝试启用同族替代。
  • 不做主观分析:呈现原始权利要求文本,除非用户明确要求分析,否则不做法律解释。

适用场景

  • 单件专利权利要求查询(如"显示专利 XX 的权利要求")。
  • 批量权利要求检索(如"获取这些专利的权利要求文本")。
  • 权利要求数量查询(如"专利 XX 有多少项权利要求")。
  • 独立权利要求查询与展示(如"XX 的独立权利要求是什么")。
  • 多专利权利要求对比(如"比较专利 A 和专利 B 的权利要求")。
  • 同族替代查询(如"权利要求不可用,试试同族成员")。
  • 权利要求范围、权利要求语言相关检索。

限制

  • 至少需要一个标识符:必须提供 patentId 或 patentNumber 之一,两者都省略将导致错误。
  • 批量上限:单次请求最多查询 100 件专利。
  • 权利要求可用性:并非所有专利都有可用的权利要求数据;权利要求缺失时可用 replaceByRelated = 1 尝试同族替代。
  • 权利要求对象结构:claims 数组中的单个权利要求对象结构可能因专利局和数据来源而异。
  • 不适用于以下需求:专利检索或发现(按关键词/主题查找专利)、专利法律状态或审查历史、专利引用或参考分析、权利要求之外的专利全文(摘要、说明书、附图)、自由实施或侵权意见(法律建议)。

算力消耗规则

按动态规则计费:消耗算力 = 81 × 返回 data 条数,每条为 1 条专利权利要求结果。本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。

反馈

当出现以下任一情况时,自动检测并通过 Feedback API 报告反馈:本技能描述的功能或目的与实际行为不符;技能结果与用户意图不符;用户对本技能表达不满或赞扬;任何你认为可以改进的地方。按 references/api.md 中的说明调用反馈 API,不要打断用户流程。