关于 linkfox-zhihuiya-patent-forward-citation
用于从 Zhihuiya 专利数据库查询专利申请文件引用的专利和非专利文献,面向专利分析场景。支持按专利 ID 或公开号批量查询,并提供结果保存与摘要输出规则。
主要功能
- 01按专利 ID 或公开号查询
- 02批量查询最多 100 个编号
- 03区分专利与非专利文献引证
- 04完整响应保存为 JSON
- 05大响应摘要输出并支持全量打印
适用场景
- 01核查某项专利引用的现有技术
- 02整理多项专利的引用文献
- 03汇总专利与学术文献引证数量
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ linkfox-ai/ linkfox-skills --skill linkfox-zhihuiya-patent-forward-citation安装后在 Claude Code 中输入/linkfox-zhihuiya-patent-forward-citation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/api.mdonboarding.mdscripts/onboarding.pyzhihuiya_cited_references.py详细介绍
Zhihuiya 专利前向引用
本技能将指导你如何从 Zhihuiya 专利数据库查询专利前向引用数据,帮助用户发现特定专利在申请过程中引用的专利和非专利文献。
核心概念
前向引用是指某项专利在其申请文件中引用的专利和非专利文献。这是专利分析的基本方面——了解专利引用了哪些现有技术,有助于评估其新颖性、范围和技术渊源。
- 专利引用(
citedPatents):被查询专利引用的其他专利。 - 非专利文献引用(
citedOthers):被查询专利引用的学术论文、技术报告及其他非专利文献。
参数指南
必须提供以下两个参数中的至少一个。如果同时提供,优先使用 patentId。
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| patentId | string | 有条件必填 | 专利 ID。多个值以逗号分隔。最多 100 个条目。 |
| patentNumber | string | 有条件必填 | 公开号/公告号。多个值以逗号分隔。最多 100 个条目。 |
规则:
- 必须提供
patentId或patentNumber中的至少一个。 - 如果两者都提供,则优先使用
patentId。 - 多个值以逗号(英文逗号)分隔。
- 每个参数每次请求最多支持 100 个条目。
响应字段
| 字段 | 类型 | 描述 |
|---|---|---|
| total | integer | 返回的记录总数 |
| data | array | 专利引用结果列表 |
| data[].patentId | string | 被查询专利的专利 ID |
| data[].pn | string | 公开号/公告号 |
| data[].citedPatents | array | 被引用专利文献列表 |
| data[].citedOthers | array | 被引用非专利文献列表 |
| columns | array | 用于渲染的列定义 |
| costToken | integer | 查询消耗的算力令牌数 |
| type | string | 渲染样式提示 |
调用方式
- API 端点:
POST /zhihuiya/patentForwardCitation(完整参数/响应/错误码见references/api.md) - Python 脚本:
python scripts/zhihuiya_cited_references.py '<JSON 参数>' [--inline] - 成本约束:本工具会消耗算力;同一会话使用相同参数组合时,默认只调用一次,脚本带有 24h 本地缓存。失败或结果为空时,不得自动更换关键词、翻页或修改邮编进行连续试探;需要继续检索时,先向用户说明会产生额外消耗。
输出策略(脚本默认行为):
- 始终将完整响应写入
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-forward-citation-<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/套餐到期/需充值/请充值”,或表达类似含义。
使用示例
1. 按公开号查询前向引用
Look up the forward citations for patent US10000000B2.
参数:{"patentNumber": "US10000000B2"}
2. 查询多项专利的前向引用
Find all citations for patents US10000000B2, US9876543B1, and EP3456789A1.
参数:{"patentNumber": "US10000000B2,US9876543B1,EP3456789A1"}
3. 按专利 ID 查询前向引用
Retrieve the cited references for patent ID 12345678.
参数:{"patentId": "12345678"}
4. 同时使用两个标识符查询前向引用
Look up citations for patent ID 12345678 (publication number US10000000B2).
参数:{"patentId": "12345678", "patentNumber": "US10000000B2"}(优先使用 patentId)
展示规则
- 清晰呈现数据:使用结构清晰的表格展示引证结果,并将专利引证与非专利文献引证分开。
- 汇总数量:始终说明被引专利和非专利文献项目的总数。
- 不得编造:仅展示 API 返回的数据。不要推断或编造引证详情。
- 错误处理:查询失败时,根据错误响应说明原因,并建议用户核实专利 ID 或公开号。
- 批量结果:查询多项专利时,按专利整理结果,清楚地分组展示每项专利的引证。
- 无结果:如果专利没有引证,请明确告知用户,而不是展示空表格。
用户表达与场景快速参考
适用——专利引证查询:
| 用户表达 | 场景 |
|---|---|
| “XX 引用了哪些专利?” | 前向引证查询 |
| “显示专利 XX 的参考文献” | 引证详情检索 |
| “XX 引用了哪些现有技术?” | 现有技术文献查询 |
| “列出 XX 引用的文献” | 非专利文献查询 |
| “分析专利 XX 的引证” | 专利与文献引证综合查询 |
| “专利 XX 引用了哪些文件?” | 通用引证查询 |
不适用——超出前向引证数据范围的需求:
- 后向/反向引证(哪些专利引用了该专利)
- 专利有效性或法律状态
- 专利族分析
- 专利全文搜索
- 专利分类或专利布局分析
算力消耗规则
按动态规则计费:消耗算力 = 81 × 返回data条数。每条为 1 条专利引证文献结果
重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
反馈:
出现以下任一情况时,通过 Feedback API 自动检测并提交反馈:
- 此技能描述的功能或用途与实际行为不符
- 技能结果与用户意图不符
- 用户对这项技能表示不满或赞扬
- 你认为有任何可以改进之处
按照 references/api.md 中的说明调用反馈 API。不要中断用户的操作流程。
如需获取更多高质量、专业的跨境电商技能,请访问 LinkFox Skills。