用途
本技能用于从智慧芽(PatSnap)数据库查询专利法律状态信息,帮助用户快速确定一件或多件专利的当前法律地位与法律事件历史。适用于专利法律状态查询、专利有效性核查、专利状态查询、专利事件历史查询,以及转让、许可、质押、异议、诉讼、复审等法律事件的排查。
主要能力
该工具为每件专利返回三层法律信息:
- 简单法律状态(Simple Legal Status):专利当前地位的高层摘要,例如有效(Active)、无效(Inactive)、审查中(Pending)、未确定(Undetermined)、PCT 指定期(PCT designated period)、PCT 指定期满(PCT designated expiration)。
- 法律状态(Legal Status):描述专利生命周期阶段的详细状态,例如已公布(Published)、审查中(Examining)、已授权(Granted)、放弃(Abandoned)、撤回(Withdrawn)、驳回(Rejected)、期满(Expired)、撤销(Revoked)、终止(Ceased)、恢复(Restoration)等。
- 法律事件(Legal Events):专利上已发生的具体法律行为,例如转让(Transfer)、许可(License)、质押(Pledge)、异议(Opposition)、诉讼(Litigation)、复审(Re-examination)、海关(Customs)、保全(Preservation)、无效程序(Invalid-procedure)、口头程序(Oral-procedure)、解密(Declassification)、重复申请(Double application)、信托(Trust)。
专利识别方式:可通过专利 ID 或公开(公告)号查询。两者同时提供时,专利 ID 优先。单次请求可提交多个值(逗号分隔,最多 100 个)。
使用方式
调用方式有两种:
- API 端点:POST /zhihuiya/legalStatus(完整参数、响应与错误码见 references/api.md)
- Python 脚本:python scripts/zhihuiya_legal_status.py '<JSON 参数>' [--inline]
参数说明:
- patentId(条件必填):专利 ID。patentId 与 patentNumber 至少提供一个。逗号分隔可传多个,最多 100 个。
- patentNumber(条件必填):公开(公告)号。patentId 与 patentNumber 至少提供一个。逗号分隔可传多个,最多 100 个。
若用户提供公开(公告)号(如 CN115xxxxxxA、US11xxxxxxB2、EP3xxxxxxA1),使用 patentNumber;若提供内部专利 ID,使用 patentId;两者同时提供时 patentId 优先。
响应字段包括:patentId(专利内部 ID)、pn(公开/公告号)、simpleLegalStatus(高层状态)、legalStatus(详细生命周期状态)、eventStatus(法律事件)、legalDate(最近一次法律状态更新日期)。
输出策略(脚本默认行为):
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-legal-status-<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/套餐到期/需充值/请充值”或类似含义的内容)。
适用场景
- 判断某专利是否仍然有效/有效(简单法律状态检查)
- 查询某专利的详细法律状态
- 查询专利是否发生过转让或许可(法律事件查询)
- 批量核查专利是否期满
- 查询专利是否存在诉讼(法律事件筛选)
- 直接按公开号查询专利法律状态
限制
- 单次请求最多 100 件专利:单次调用中专利 ID 或公开号的最大数量为 100。
- 至少需要一个标识:patentId 或 patentNumber 必须提供其一;两者均为空时请求会失败。
- 专利 ID 优先:同时提供 patentId 与 patentNumber 时,系统使用 patentId 并忽略 patentNumber。
- 数据覆盖范围:结果取决于智慧芽(PatSnap)数据库覆盖范围;部分非常新的申请可能尚未反映。
- 不适用于:按关键词、分类或申请人名称进行专利检索;专利全文或权利要求获取;专利价值评估或商业分析;自由实施(FTO)分析;专利同族或引用分析。
算力消耗规则
按动态规则计费:消耗算力 = 81 × 返回 data 条数,每条为 1 条专利法律状态结果。本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
展示规则
- 清晰呈现数据:以结构化表格展示结果,包含每件专利的公开号、简单法律状态、详细法律状态和法律事件。
- 翻译状态值:当用户语言偏好明确时,用该语言呈现状态标签,同时在括号中保留规范英文值以保证精确。
- 突出关键发现:若用户核查有效性,在响应顶部显著说明每件专利是有效、无效还是审查中。
- 法律日期上下文:当 legalDate 可用时一并展示,让用户了解状态信息的新近程度。
- 错误处理:若查询失败或无结果,说明可能原因(专利号格式无效、数据库中未找到该专利)并建议用户复核输入。
- 数量提示:查询大量专利时,展示汇总表并注明返回总数。
反馈
在以下任一情况发生时,自动检测并通过 Feedback API 报告反馈:本技能描述的功能或目的与实际行为不符;技能结果与用户意图不符;用户对本技能表达不满或赞扬;任何你认为可以改进的地方。按 references/api.md 中的说明调用反馈 API,不要打断用户流程。