智慧芽专利全文下载

技能文档

---
name: linkfox-zhihuiya-pdf
title: 智慧芽专利全文下载
category: 法律合规
description: 通过专利 ID 或公开号从智慧芽专利数据库下载专利 PDF 全文文档，支持中国、美国、欧洲、PCT 等多国专利，单次最多批量 100 条，支持同族专利 PDF 替代。当用户需要下载专利 PDF、查询专利全文、获取专利文件、批量导出专利文档时触发。触发词：专利下载、专利PDF、专利全文、公开号查询、专利文件获取、智慧芽。
---

# 智慧芽专利全文下载

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

## 核心概念

智慧芽专利 PDF 服务提供全球专利全文 PDF 文档的直接下载链接。可以按**专利 ID** 或**公开（公告）号**查询，单次请求最多检索 **100 条**专利。

**查询优先级**：当 `patentId` 与 `patentNumber` 同时提供时，服务优先使用 `patentId`。两个标识都可用时务必记住这一点。

**同族替代**：当某件专利自身的 PDF 不可用时，服务可选择性返回其同族专利的 PDF 作为替代。

## 技能工作流

接收专利查询需求 → 确定查询标识 → 组装参数调用 API → 解析结果并展示 → 异常处理

### 步骤1：确定查询标识

| 标识 | 说明 | 适用场景 |
|------|------|----------|
| patentId | 智慧芽系统内部数字标识 | 用户直接提供智慧芽专利 ID 时使用 |
| patentNumber | 公开的专利公开/公告号（如 `US20230012345A1`、`CN115000000A`） | 用户提供标准专利号时使用 |

两者至少提供一个；同时提供时以 `patentId` 为准。

### 步骤2：组装请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| patentId | string | 条件必填 | 专利 ID，多个用英文逗号隔开，上限 100 条 |
| patentNumber | string | 条件必填 | 公开/公告号，多个用英文逗号隔开，上限 100 条 |
| replaceByRelated | string | 否 | 原始专利 PDF 不可获取时是否用同族专利 PDF 替代：`1` 是，`0` 否，默认不替代 |

### 步骤3：调用 API

本技能通过工具网关 API 查询。调用规范、请求参数与响应结构详见 [references/api.md](references/api.md)。也可直接执行脚本：

```bash
python3 scripts/zhihuiya_pdf_data.py '{"patentNumber": "US20230012345A1"}'
```

认证使用环境变量 `LINKFOXAGENT_API_KEY`，未配置时提示用户按 [references/api.md](references/api.md) 中的方式申请并配置。

### 步骤4：解析与展示结果

响应字段说明：

| 字段 | 说明 |
|------|------|
| total | 返回记录数 |
| data | 专利对象数组，每项含下载信息 |
| data[].patentId | 专利 ID |
| data[].pn | 公开（公告）号 |
| data[].pdfPath | PDF 全文下载地址 |
| data[].pnRelated | 替代专利的公开号（仅同族替代时提供） |
| costToken | 本次请求消耗的 token |

展示规则：

1. **清晰呈现下载链接**：每件专利以表格或列表形式展示公开号与 PDF 下载链接
2. **突出替代情况**：若 PDF 来自同族专利替代，须明确说明并展示 `pnRelated` 的值
3. **批量结果**：多件专利时用表格展示，列包括：公开号、专利 ID、PDF 链接、替代说明（如有）
4. **无 PDF 可用**：若返回条目无 `pdfPath`，告知用户该专利 PDF 不可用，并建议开启同族替代

### 步骤5：异常处理

- 查询失败或无结果时，解释原因并建议核对专利 ID / 公开号
- 未开启 `replaceByRelated` 时，可建议开启后重试
- 认证失败（errorCode 401）时，提示检查 `LINKFOXAGENT_API_KEY` 配置
- 错误码与处理建议详见 [references/api.md](references/api.md)

## 使用示例

**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"}`

## 重要限制

- **批量上限**：单次请求最多 100 件专利
- **标识要求**：`patentId` 与 `patentNumber` 至少提供一个，均为空时请求失败
- **优先级**：两者同时提供时 `patentId` 优先于 `patentNumber`
- **PDF 可用性**：并非所有专利都有 PDF 可下载，可用 `replaceByRelated` 回退到同族专利

## 适用与不适用场景

**适用**——专利 PDF 文档获取类任务：

| 用户说法 | 场景 |
|----------|------|
| "下载专利 XX 的 PDF" | 单件专利 PDF 获取 |
| "获取这些专利的全文文档" | 批量专利 PDF 下载 |
| "我需要公开号 XX 的 PDF" | 按公开号查询 |
| "专利原文拿不到也行，用同族的代替" | 同族替代场景 |
| "批量导出专利 PDF" | 多专利批量下载 |

**不适用**——超出专利 PDF 获取范围的需求：

- 专利检索与发现（按关键词、申请人等查找专利）
- 专利引用或法律状态分析
- 专利权利要求解读或翻译
- 专利组合分析或技术全景图

使用说明

# 智慧芽专利全文下载

通过专利 ID 或公开号从智慧芽专利数据库获取专利 PDF 全文下载链接，支持中、美、欧、PCT 等多国专利，单次最多批量 100 条，支持同族专利 PDF 替代。

## 使用

对 Agent 说：

```
帮我下载公开号为 US20230012345A1 的专利 PDF
```

或直接执行脚本：

```bash
python3 scripts/zhihuiya_pdf_data.py '{"patentNumber": "CN115000000A,CN115000001A"}'
```

## 工作原理

技能读取环境变量 `LINKFOXAGENT_API_KEY` 进行认证，调用智慧芽工具网关 API（POST JSON），传入 `patentId` 或 `patentNumber`（可多个，逗号分隔，上限 100 条），返回各专利的 `pdfPath` 下载地址；当原专利 PDF 不可用时，可开启 `replaceByRelated=1` 用同族专利 PDF 替代。

调用规范、请求参数、响应字段与错误码详见 `references/api.md`。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。