linkfox-zhihuiya-pdf-data

智慧芽专利 PDF 下载器

本技能将指导你如何从智慧芽专利数据库获取专利 PDF 全文的下载链接，支持通过专利 ID 或公开号查询。

核心概念

智慧芽专利 PDF 服务提供全球专利全文 PDF 文档的直接下载链接。你可以通过专利 ID或公开号（也称公告号）查询，并在单次请求中检索最多 100 项专利。

查询优先级：同时提供 patentId 和 patentNumber 时，服务会优先使用 patentId。如果两个标识符都可用，请牢记这一点。

同族替代：如果某项专利没有可用的 PDF，服务可以选择返回相关同族专利的 PDF。

参数指南

参数	类型	必填	描述
patentId	string	有条件必填	专利 ID。必须提供 patentId 或 patentNumber 中的至少一个。多个值以逗号分隔。最多 100 项。
patentNumber	string	有条件必填	公开号／公告号。必须提供 patentId 或 patentNumber 中的至少一个。多个值以逗号分隔。最多 100 项。
replaceByRelated	string	否	原专利 PDF 不可用时，是否替换为同族专利 PDF。1 = 是，0 = 否。默认不替换。

如何选择正确的标识符

• 专利 ID（patentId）：智慧芽系统内的数字标识符。用户提供智慧芽专用 ID 时使用此项。
• 公开号（patentNumber）：面向公众的专利编号（例如，US20230012345A1、CN115000000A）。用户提供标准专利编号时使用此项。

响应字段

字段	描述
total	返回的记录数
data	专利对象数组，每个对象都包含下载信息
data[].patentId	专利 ID
data[].pn	公开号／公告号
data[].pdfPath	PDF 全文下载 URL
data[].pnRelated	替代同族专利的公开号（仅在使用同族替代时出现）
costToken	请求消耗的算力令牌

调用方式

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

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

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

使用示例

1. 通过公开号查询单项专利

Retrieve the PDF for patent publication number US20230012345A1.

参数：{"patentNumber": "US20230012345A1"}

2. 通过公开号查询多项专利

Download PDFs for CN115000000A, CN115000001A, and CN115000002A.

参数：{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}

3. 通过专利 ID 查询单项专利

Get the full-text PDF for patent ID 12345678.

参数：{"patentId": "12345678"}

4. 启用同族替代

Download the PDF for EP4000000A1. If it is unavailable, use a family patent PDF instead.

参数：{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}

5. 按专利 ID 批量下载

Retrieve PDFs for patent IDs 11111111, 22222222, 33333333.

参数：{"patentId": "11111111,22222222,33333333"}

显示规则

1. 清晰展示下载链接：对于每项专利，使用简洁的表格或列表格式展示公开号及其 PDF 下载链接。
2. 突出显示替换情况：如果通过专利族专利替换提供了 PDF，请明确注明，并显示 pnRelated 值，让用户了解使用了哪项专利族专利。
3. 批量结果：返回多项专利时，使用包含以下列的表格：公开号、专利 ID、PDF 链接和替换说明（如适用）。
4. 错误处理：查询失败或没有返回结果时，说明原因，并建议用户核对专利 ID 或公开号。如果未启用 replaceByRelated，建议启用此选项作为替代方案。
5. 没有可用的 PDF：如果返回的专利条目没有 pdfPath，请告知用户该 PDF 不可用，并建议启用专利族替换。

重要限制

• 批量上限：每次请求最多 100 项专利。
• 标识符要求：必须提供 patentId 或 patentNumber 中的至少一个；如果两者都为空，请求将失败。
• 优先级规则：同时提供两个标识符时，patentId 优先于 patentNumber。
• PDF 可用性：并非所有专利都有可用的 PDF。使用 replaceByRelated 选项可回退到专利族专利。

用户表达与场景快速参考

适用 —— 专利 PDF 文档检索任务：

用户说	场景
“下载专利 XX 的 PDF”	检索单项专利 PDF
“获取这些专利的全文文档”	批量下载专利 PDF
“我需要公开号 XX 对应的 PDF”	按公开号查询
“即使专利文档无法直接获取，也能拿到吗？”	专利族替换场景
“批量导出专利 PDF”	多项专利批量下载

不适用 —— 超出专利 PDF 检索范围的需求：

• 专利搜索或发现（按关键词、受让人等查找专利）
• 专利引用或法律状态分析
• 专利权利要求解释或翻译
• 专利组合分析或技术领域图谱绘制

算力消耗规则

按动态规则计费：消耗算力 = 81 × 返回的 data 条数。每条代表 1 项专利 PDF 结果。

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

反馈：

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

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

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

---

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