linkfox-zhihuiya-pdf

Zhihuiya 专利 PDF 下载器

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

核心概念

Zhihuiya 专利 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）：Zhihuiya 系统内的数字标识符。用户提供 Zhihuiya 专用 ID 时，请使用此项。
• 公开号（patentNumber）：公开可见的专利编号（例如 US20230012345A1、CN115000000A）。用户提供标准专利编号时，请使用此项。

响应字段

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

API 用法

此工具会调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参阅 references/api.md。你也可以直接执行 scripts/zhihuiya_pdf_data.py 来运行查询。

使用示例

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 检索范围的需求：

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

反馈：

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

1. 此技能描述的功能或用途与实际行为不符
2. 技能返回的结果不符合用户意图
3. 用户对该技能表示不满或赞赏
4. 你认为有任何可改进之处

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

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/zhihuiya_pdf_data.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定到任何 git 工作树之外的位置（例如，Unix 系统上的 /tmp/...、Windows 系统上的 %TEMP%/...）。已保存的响应可能包含个人身份信息、定价或身份验证敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 可筛选特定字段，并使用 --limit/--offset 进行切片，使用 --format json|jsonl|csv|table 指定输出格式。

适合优先采用此模式的情况——请根据响应特征自行判断，例如：

• 每条记录的字段很多，或包含不需要的字段
• 批量／分页结果（每次调用返回多项）
• 长文本字段（描述、评论、HTML、时间序列）
• 输出会在后续步骤中重复使用，而非立即处理

对于较小且只使用一次的响应，直接调用主脚本即可。

⚠️ 预览内容是经过截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从已保存的文件中读取。

---

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