linkfox-zhihuiya-pdf-data — Claude Code skill: install
The linkfox-zhihuiya-pdf-data Claude Code skill finds full patent PDF links from an ID or publication number. It handles single and batch lookups, with a related-family document as a fallback.
MIT 230 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a claude-codeWhat linkfox-zhihuiya-pdf-data does
Give it an internal patent ID or a publication number such as US20230012345A1; comma-separated values allow batch retrieval. The result contains a PDF link for each requested item.
If the original file cannot be returned, replaceByRelated allows a document from the same patent family to be used instead. The output identifies that source as a substitute, so it is not confused with the requested patent’s own text. Empty and failed results are also described.
The recommended runner is python scripts/zhihuiya_pdf_data.py '<JSON parameter>' [--inline]. Responses are stored under linkfox/<YYYY-MM-DD>/<session>/data/; output switches to a summary above 8000 UTF-8 bytes. A LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY is required, and an unset key causes authentication failure.
What it helps with
- fetch a full PDF from a known publication number
- collect document links for several patents
- fall back to a related-family document
- record link availability and document source
- separate an original PDF from a family substitute
Example prompts for the agent
- Find the full PDF for patent
US20230012345A1. - Collect PDF links for
CN115000000A,CN115000001A,CN115000002A. - For
EP4000000A1, use a related-family document when the original is unavailable.
How to install linkfox-zhihuiya-pdf-data
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-zhihuiya-pdf-data/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-zhihuiya-pdf-data/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a codex2Manually: put the files in place
.agents/skills/linkfox-zhihuiya-pdf-data/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a cursor2Manually: put the files in place
.cursor/skills/linkfox-zhihuiya-pdf-data/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-zhihuiya-pdf-data2Manually: put the files in place
.github/skills/linkfox-zhihuiya-pdf-data/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-zhihuiya-pdf-dataManually: put the files in place
.devin/skills/linkfox-zhihuiya-pdf-data/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-zhihuiya-pdf-data
How do I install linkfox-zhihuiya-pdf-data in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-pdf-data -a claude-code, then check ~/.claude/skills/linkfox-zhihuiya-pdf-data/SKILL.md.
What does linkfox-zhihuiya-pdf-data do?
It retrieves full patent PDF links from internal IDs or publication numbers and supports batch requests. When the original document cannot be returned, it can provide a clearly marked file from the same patent family.
Which identifiers and options does it accept?
Use patentId for an internal patent identifier or patentNumber for a public publication number. Comma-separated values support batches, while replaceByRelated: "1" enables a family-document substitute.
Source text
SKILL.md · MIT
---
name: linkfox-zhihuiya-pdf-data
description: 根据专利 ID 或公开公告号获取智慧芽(PatSnap)专利 PDF 全文下载链接,支持批量获取及原文不可用时的同族专利替代。适用于下载、查看或批量导出已知专利的全文文档,无需明确提及智慧芽;不适用于按关键词或申请人发现专利、引证与法律状态分析、权利要求解读翻译或专利组合及技术布局分析。
---
# 智慧芽专利 PDF 全文获取
## 适用范围
### 适用
用户已知专利标识,希望获取单件或多件专利的 PDF 全文下载链接,或在原文不可用时获取同族专利文档。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 下载这个专利的 PDF | 根据已知标识获取单件专利全文。 |
| 获取这些专利的全文文档 | 批量获取专利 PDF 链接。 |
| 我有公开号,想查看全文 | 根据公开公告号获取文档。 |
| 原文没有 PDF,能否找同族文档 | 按用户意图使用同族专利替代。 |
| 批量导出这些专利 PDF | 汇总已知专利的文档链接与可用情况。 |
## 前置条件
**先确定专利标识与替代意图**:取得用户提供的智慧芽专利 ID 或公开公告号;是否接受同族文档应以用户要求为准。具体参数约束见 `references/api.md`。
## 获取专利全文流程
1. 整理用户提供的专利标识,区分智慧芽 ID 和公开公告号;按 `references/api.md` 准备请求,并核对是否允许同族替代。
2. 根据所需请求次数预估算力消耗;超过单次 100 件上限时按批次计费。已有明确授权时按授权范围执行。
3. 优先复用相同参数的已有结果,按需获取 PDF 链接。失败或空结果时先解释原因,建议核对标识或考虑同族替代,后续请求遵守成本约束。
4. 展示每件专利的文档链接及来源,说明原文不可用、缺失结果和同族替代情况。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/zhihuiya_pdf_data.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-pdf-data-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 序列化响应不超过 8000 个 UTF-8 字节:保存后,将完整 JSON 打印到标准输出。
- 序列化响应超过 8000 个 UTF-8 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
3 算力/次。按需请求次数预估,单次请求内不按返回的 `data` 条数倍增;拆分批次或重新请求会分别计费,本地缓存命中不发起请求。
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **区分标识概念**:专利 ID 是智慧芽内部数字标识;公开公告号是公开使用的专利编号,例如 `US20230012345A1`、`CN115000000A`。标识选择与批量限制见 `references/api.md`。
- **理解同族替代**:同族专利的 PDF 可帮助获取相关文档,不能把它标成所查询专利自身的原文;并非所有专利都有可用 PDF。
- **清晰展示链接**:单件结果可用列表;批量结果用表格,列出公开号、专利 ID、可点击的 PDF 链接及替代说明。
- **标明文档来源**:使用同族替代时明确写明替代来源的公开号,让用户区分原专利与同族文档。相关字段见 `references/api.md`。
- **解释不可用结果**:未返回文档链接时,说明 PDF 暂不可用;失败或空结果按实际错误解释,建议核对专利 ID 或公开号。尚未使用同族替代时,可建议用户考虑该选项,不自动追加请求。
## 使用示例
### 按公开公告号获取单件专利
```json
{"patentNumber": "US20230012345A1"}
```
### 按公开公告号批量获取
```json
{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}
```
### 按智慧芽专利 ID 获取
```json
{"patentId": "12345678"}
```
### 原文不可用时使用同族文档
```json
{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}
```
### 按专利 ID 批量获取
```json
{"patentId": "11111111,22222222,33333333"}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills