linkfox-zhihuiya-pdf-data

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Zhihuiya Patent PDF Downloader

智慧芽专利PDF下载工具

This skill guides you on how to retrieve patent PDF full-text download links from the Zhihuiya patent database, supporting lookup by patent ID or publication number.

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

Core Concepts

核心概念

The Zhihuiya Patent PDF service provides direct download links to the full-text PDF documents of patents worldwide. You can query by patent ID or publication number (also called public announcement number), and retrieve up to 100 patents in a single request.

Lookup priority: When both

patentId

and

patentNumber

are supplied, the service uses

patentId

first. This is important to remember when both identifiers are available.

Family substitution: If a patent's own PDF is unavailable, the service can optionally return the PDF of a related family patent instead.

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

查询优先级：当同时提供

patentId

和

patentNumber

时，服务将优先使用

patentId

。当两种标识符都可用时，请务必记住这一点。

家族替代：如果某专利自身的PDF不可用，服务可选择返回相关家族专利的PDF作为替代。

Parameter Guide

参数指南

Parameter	Type	Required	Description
patentId	string	Conditionally	Patent ID(s). At least one of `patentId` or `patentNumber` must be provided. Separate multiple values with commas. Max 100 entries.
patentNumber	string	Conditionally	Publication/announcement number(s). At least one of `patentId` or `patentNumber` must be provided. Separate multiple values with commas. Max 100 entries.
replaceByRelated	string	No	Whether to substitute with a family patent PDF when the original is unavailable. `1` = yes, `0` = no. Defaults to no substitution.

参数	类型	是否必填	描述
patentId	string	可选（二选一）	专利ID。必须提供 `patentId` 或 `patentNumber` 中的至少一个。多个值用逗号分隔，最多支持100条。
patentNumber	string	可选（二选一）	公开/公告号。必须提供 `patentId` 或 `patentNumber` 中的至少一个。多个值用逗号分隔，最多支持100条。
replaceByRelated	string	否	当原始专利PDF不可用时，是否使用家族专利PDF替代。 `1` =是， `0` =否，默认不替代。

How to Choose the Right Identifier

如何选择合适的标识符

Patent ID (
```
patentId
```
): An internal numeric identifier within the Zhihuiya system. Use this when the user provides Zhihuiya-specific IDs.
Publication Number (
```
patentNumber
```
): The public-facing patent number (e.g.,
```
US20230012345A1
```
,
```
CN115000000A
```
). Use this when the user provides standard patent numbers.

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

Response Fields

响应字段

Field	Description
total	Number of records returned
data	Array of patent objects, each containing download information
data[].patentId	The patent ID
data[].pn	The publication/announcement number
data[].pdfPath	The PDF full-text download URL
data[].pnRelated	Publication number of the substitute family patent (only present when family substitution is used)
costToken	Tokens consumed by the request

字段	描述
total	返回的记录数量
data	专利对象数组，每个对象包含下载信息
data[].patentId	专利ID
data[].pn	公开/公告号
data[].pdfPath	PDF全文下载链接
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 进入上下文。

API 端点：
```
POST /zhihuiya/pdfData
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/zhihuiya_pdf_data.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时需先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<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 引导解决问题：

发生以下异常情况时，请采用

references/onboarding.md

中的指引解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"或类似含义的内容。

Usage Examples

使用示例

1. Single Patent by Publication Number

Retrieve the PDF for patent publication number US20230012345A1.

Parameters:

{"patentNumber": "US20230012345A1"}

2. Multiple Patents by Publication Number

Download PDFs for CN115000000A, CN115000001A, and CN115000002A.

Parameters:

{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}

3. Single Patent by Patent ID

Get the full-text PDF for patent ID 12345678.

Parameters:

{"patentId": "12345678"}

4. With Family Substitution Enabled

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

Parameters:

{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}

5. Batch Download by Patent IDs

Retrieve PDFs for patent IDs 11111111, 22222222, 33333333.

Parameters:

{"patentId": "11111111,22222222,33333333"}

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

获取专利公开号US20230012345A1的PDF文档。

参数：

{"patentNumber": "US20230012345A1"}

2. 通过公开号批量查询多个专利

下载CN115000000A、CN115000001A和CN115000002A的PDF文档。

参数：

{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}

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

获取专利ID为12345678的全文PDF文档。

参数：

{"patentId": "12345678"}

4. 启用家族替代功能

下载EP4000000A1的PDF文档。若该文档不可用，则使用家族专利的PDF替代。

参数：

{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}

5. 通过专利ID批量下载

获取专利ID为11111111、22222222、33333333的PDF文档。

参数：

{"patentId": "11111111,22222222,33333333"}

Display Rules

展示规则

Present download links clearly: For each patent, show the publication number and its PDF download link in a clean table or list format.
Highlight substitutions: If a PDF was provided via family patent substitution, explicitly note this and show the
```
pnRelated
```
value so the user knows which family patent was used.
Batch results: When multiple patents are returned, present them in a table with columns: Publication Number, Patent ID, PDF Link, and Substitution Note (if applicable).
Error handling: When a query fails or returns no results, explain the reason and suggest the user verify the patent ID or publication number. If
```
replaceByRelated
```
was not enabled, suggest enabling it as an alternative.
No PDF available: If a patent entry is returned without a
```
pdfPath
```
, inform the user that the PDF is not available and suggest enabling family substitution.

清晰展示下载链接：对于每个专利，以简洁的表格或列表格式显示公开号及其PDF下载链接。
突出替代说明：若PDF是通过家族专利替代提供的，请明确标注并显示
```
pnRelated
```
值，让用户了解使用的是哪个家族专利。
批量结果展示：当返回多个专利时，以表格形式展示，列包括：公开号、专利ID、PDF链接、替代说明（如有）。
错误处理：当查询失败或无结果返回时，说明原因并建议用户验证专利ID或公开号。若未启用
```
replaceByRelated
```
，建议启用该功能作为替代方案。
无可用PDF：若返回的专利条目没有
```
pdfPath
```
，告知用户该专利的PDF不可用，并建议启用家族替代功能。

Important Limitations

重要限制

Batch limit: A maximum of 100 patents per request.
Identifier requirement: At least one of
```
patentId
```
or
```
patentNumber
```
must be provided; the request will fail if both are empty.
Priority rule: When both identifiers are provided,
```
patentId
```
takes precedence over
```
patentNumber
```
.
PDF availability: Not all patents have PDFs available. Use the
```
replaceByRelated
```
option to fall back to family patents.

批量限制：单次请求最多支持100项专利。
标识符要求：必须提供
```
patentId
```
或
```
patentNumber
```
中的至少一个；若两者均为空，请求将失败。
优先级规则：当同时提供两种标识符时，
```
patentId
```
优先级高于
```
patentNumber
```
。
PDF可用性：并非所有专利都有可用的PDF文档。可使用
```
replaceByRelated
```
选项 fallback 到家族专利。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Patent PDF document retrieval tasks:

User Says	Scenario
"Download the PDF for patent XX"	Single patent PDF retrieval
"Get full-text documents for these patents"	Batch patent PDF download
"I need the PDF for publication number XX"	Lookup by publication number
"Can I get the patent document even if it's not directly available"	Family substitution scenario
"Batch export patent PDFs"	Multi-patent batch download

Not applicable -- Needs beyond patent PDF retrieval:

Patent search or discovery (finding patents by keyword, assignee, etc.)
Patent citation or legal status analysis
Patent claim interpretation or translation
Patent portfolio analytics or landscape mapping

适用场景 -- 专利PDF文档检索任务：

用户表述	场景
"下载专利XX的PDF文档"	单个专利PDF检索
"获取这些专利的全文文档"	批量专利PDF下载
"我需要公开号为XX的PDF文档"	通过公开号查询
"如果专利文档无法直接获取，我还能拿到吗"	家族替代场景
"批量导出专利PDF"	多专利批量下载

不适用场景 -- 超出专利PDF检索的需求：

专利搜索或发现（通过关键词、申请人等查找专利）
专利引用或法律状态分析
专利权利要求解读或翻译
专利组合分析或态势图谱

积分消耗规则

按动态规则计费：消耗积分 = 81 × 返回data条数。每条为 1 条专利 PDF 结果

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

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

按动态规则计费：消耗积分 = 81 × 返回data条数。每条为1条专利PDF结果

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

反馈：

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

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不符
用户表达了对本技能的不满或赞扬
任何您认为可以改进的地方

按照

references/api.md

中的指定方式调用反馈API，请勿中断用户流程。

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