用途
本技能用于从智慧芽(Zhihuiya)专利数据库查询专利的简要著录(书目)数据,帮助用户高效获取结构化的专利元数据。当用户需要查询专利著录信息、专利基本信息、专利书目数据、专利公开详情,或按专利号查询发明人、申请人信息、专利摘要、分类号(IPC/CPC)、引用文献等,均可使用本技能。
主要能力
给定一个或多个专利 ID 或公开号,返回结构化元数据,包括:标题、摘要、申请人、发明人、专利权人、分类号、申请日、优先权、引用文献等。
查询模式:可按 patentId(智慧芽内部专利 ID)或 patentNumber(公开/授权号)查询。两者同时提供时,patentId 优先。多个值以逗号分隔,单次最多 100 个。
返回数据字段包括:
- 专利 ID(patentId)
- 标题(title)
- 摘要(abstractContent)
- 公开号(publicationNumber)
- 完整公开/授权号(pn)
- 国家代码(country)
- 公开国家(publicationCountry)
- 公开日(publicationDate)
- 公开类型(publicationKind)
- 专利类型(patentType)
- 类型代码(kind)
- 申请号(applicationNo)
- 申请日(applicationDate)
- 申请人(applicants)
- 发明人(inventors)
- 专利权人(assignees)
- 专利权人地址(assigneeAddresses)
- IPC 主分类(ipcMain)
- IPC 附加分类(ipcFurther)
- CPC 主分类(cpcMain)
- CPC 附加分类(cpcFurther)
- LOC 分类(loc,外观设计专利)
- GBC 分类(gbc)
- 优先权声明(priorityClaims)
- PCT 申请号(pctApplicationNo)
- PCT 申请日(pctFilingDate)
- PCT 进入国家阶段日期(pctEntryDate)
- 引用专利(citedPatents)
- 引用非专利文献(citedNonPatents)
使用方式
API 端点:POST /zhihuiya/simpleBibliography(完整参数、响应与错误码见 references/api.md)。
Python 脚本:python scripts/zhihuiya_simple_bibliography.py '<JSON 参数>' [--inline]
参数说明:
- patentId(字符串,条件必填):智慧芽内部专利 ID,逗号分隔,最多 100 个。patentId 与 patentNumber 至少提供一个。
- patentNumber(字符串,条件必填):公开/授权号(如 US11234567B2、CN115000000A),逗号分隔,最多 100 个。patentId 与 patentNumber 至少提供一个。
优先级规则:当 patentId 与 patentNumber 同时存在时,API 使用 patentId 并忽略 patentNumber。
成本约束:本工具会消耗算力;同一会话同一参数组合默认只调用一次,脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。
输出策略(脚本默认行为):
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-simple-bibliography-<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 查询书目。
- 检索发明人与申请人信息。
- 查询专利分类号(IPC/CPC)。
- 获取专利摘要与引用文献。
- 查询申请日、公开日等日期信息。
- 批量书目查询。
限制
- 单次最多 100 个专利 ID 或公开号。
- 必须提供 patentId 或 patentNumber 之一,两者都省略会报错。
- patentId 优先:若同时提供两个参数,仅使用 patentId。
- 数据范围:本工具仅返回简要著录数据,不返回全文权利要求、详细说明书、法律状态或专利族信息。
- 不适用于:专利全文权利要求或详细说明书、专利法律状态或审查历史、专利族/同族分析、专利估值或专利地图、自由实施(FTO)或侵权分析、按关键词或语义检索专利(本工具需要具体专利标识符)。
算力消耗规则
按动态规则计费:消耗算力 = 81 × 返回 data 条数。每条为 1 条简版专利著录项结果。
重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
反馈
当出现以下情况时,自动检测并通过 Feedback API 报告反馈:
- 本技能描述的功能或目的与实际行为不符。
- 技能结果与用户意图不符。
- 用户对本技能表达不满或赞扬。
- 任何你认为可以改进的地方。
按 references/api.md 中的说明调用反馈 API,不要打断用户流程。