patentmax-patent-search

---
name: patentmax-patent-search
description: 全球专利检索与统计分析。当用户提到专利检索、找专利、现有技术、相似专利、引证分析、某家公司有多少专利、某个领域谁在申请、技术趋势分布，或直接给出一个专利号、公开号时使用。Use when the user asks to search patents, look up a patent, find similar patents, analyse citations, or profile a company patent portfolio. Requires a PatentMax API key.
version: "3.2.1"
user-invocable: true
argument-hint: "[专利号 / 检索式 / 企业名称]"
allowed-tools: Bash, Read, Write, WebFetch
---

# PatentMax 专利检索

直连 iprdb 全球专利库，覆盖 CN / US / EP / JP / KR / WIPO，中国专利收录最完整。

接口与控制台：**https://api.ip930.com**

**每天前 30 次检索/查专利免费**，注册再送 ¥50 体验额度，不用绑卡、不用先充值。

## 快速参考

> 时间紧就先看这张表。

| 我要… | 怎么做 | 花费 |
| --- | --- | --- |
| 给一段方案/配方，找类似专利 | `search` 提炼特征 → `similar --patent <号>` | **¥0.20** |
| 看某个主题有哪些专利 | 最小检索集，见「快速摸底该怎么跑」 | ¥0.40-0.50 |
| 看某一篇专利讲了什么 | `brief --patent <号>` | **¥0.10** |
| 要实施例、配比、参数 | 上面那条加 `--fulltext` | **不加钱** |
| 它还有没有效 | 看检索结果里的法律状态；要完整流水才 `--legal` | +¥0.05 |
| 某公司有多少专利、做什么方向 | `company`（¥0.30，先问用户） | ¥0.30 |
| 谁在领先 / 年份趋势 / IPC 分布 | 先换检索式比命中数；真要统计才 `stats`（¥0.30/维度） | ¥0.10 vs ¥0.30 |
| 检索命中 0 条或全是无关 | **别收尾**，看「检索空转 = 假阴性闸门」 | — |
| 命中几万条 | 加 IPC/日期/申请人收窄，别翻页硬啃 | — |
| 怎么写检索式 | `references/query-construction.md` | — |
| 拿密钥 / 配环境 | `INSTALL.md` | — |

**一篇专利 = 一次调用 = ¥0.10**，著录项、权利要求、说明书全文全在里面，不按字段另收。

**贵的三样**：`stats`、`company`、`pdf` 各 ¥0.30，是检索的 3 倍。用之前先跟用户说一声。

**每天前 30 次 `search` / `brief` 不扣钱**（生产密钥，北京时间零点重置）。所以摸底阶段
基本是免费的——**不要因为怕花钱而少检索**，该跑的检索式一条都不要省。
免费额度用完会自动转为正常计费，不会中断。

## 核心原则

**每一条专利信息必须来自接口返回值。** 不确定就说不确定，不得凭记忆补公开号、申请日、申请人或法律状态——编一个格式正确的公开号出来，比查不到糟得多。

**检索不等于查新。** 用户要的是「有没有类似的」就用检索；要「能不能申请」的结论，那是查新任务，不在本 Skill 范围内——见「相关能力」。

**费用要先讲清楚，再花。** 本 Skill 每一次调用都在扣用户的真金白银（检索 ¥0.10 / 次，单篇精读 ¥0.10 / 篇，每天前 30 次免费）。开跑前给出深度选项和预计花费（见「检索深度与费用」），筛选阶段严禁逐篇取正文（见「先筛后读」）。

**但不要把"省钱"变成"少干活"。** 单价已经很低、摸底基本免费，**该跑的检索式、该做的语义扩展一条都不要省**——漏检的代价远大于多花的两毛钱。要控制的是"对上百篇逐篇取正文"这种量级的浪费，不是省掉一次 ¥0.10 的检索。

**不把相似度、命中数或模型判断当作法律结论。** 交付时报告用过的检索式、覆盖范围和未覆盖来源，保证结论可复核。

**密钥失效（401 / 402 / 403）时停止检索并询问用户**，禁止自行转向公开网页检索专利来凑答案。

## 能做什么

**检索**

| 功能 | 怎么做 |
| --- | --- |
| 关键词检索 | `search --q "固态电池 AND 电解质"`，支持 `AND` / `OR` / `NOT` 与括号 |
| 按公开号精确查 | `--q "documentNumber:CN106328959A"` |
| 按标题查 | `--q "t:区块链"` |
| 按法律状态筛 | `--q "t:区块链 AND legalStatus:有效专利"` |
| 按专利类型筛 | `--q "石墨烯 AND type:发明授权"` |
| 按年份范围筛 | `--q "石墨烯 AND applicationYear:[2024 TO 2024]"`，公开年用 `documentYear` |
| 限定库 | `--scope cn` 仅中国、`--scope all` 全球 |
| 排序 | `--sort relation` 相关度、`!applicationDate` 申请日降序、`documentDate` 公开日升序、`rank` 综合 |
| 关键词高亮 | `--highlight` |

**单篇深入**

一条 `brief` 就是一次调用 ¥0.10，**著录项 + 权利要求 + 说明书全文一起回来**：

| 功能 | 怎么做 | 另外花钱吗 |
| --- | --- | --- |
| 著录项目、摘要、权利要求 | `brief --patent CN109761224A` | ¥0.10 一口价 |
| 说明书全文 | 加 `--fulltext` | **不加钱**，只是输出变长 |
| 少回一点省上下文 | 加 `--no-claims` | **不省钱**，纯显示开关 |
| 法律事件流水 | 加 `--legal` | +¥0.05（单独的接口） |
| 引证与被引、非专利文献 | `citation --patent CN109761224A` | ¥0.05 |
| 语义相似专利 | `similar --patent CN109761224A --limit 10` | ¥0.10 |
| 摘要附图存成文件 | `figure --patent CN109761224A --out fig.png` | ¥0.05 |

**`--fulltext` 和 `--no-claims` 是上下文开关，不是省钱开关。** 这三块内容在同一次调用里
已经一起取回来了，关掉一分钱都不省。要看实施例、配比、参数就放心加 `--fulltext`。

**统计分析** — `stats --q "固态电池" --dimension applicant`，每个维度返回 Top 20

| 维度 | 看什么 |
| --- | --- |
| `applicant` / `inventor` | 谁在申请、谁在发明 |
| `applicationYear` / `documentYear` | 申请趋势、公开趋势 |
| `ipc` / `ipc1` / `ipc2` / `ipc3` / `ipc4` | 技术分类分布，四级粒度可选 |
| `countryCode` / `province` / `city` | 地域分布 |
| `legalStatus` | 有效、失效、审中的构成 |
| `type` | 发明、实用新型、外观的构成 |
| `loc` | 外观设计分类 |

**企业画像** — `company --name "宁德时代新能源科技股份有限公司"`，看一家企业的专利总量、类型构成、技术方向


## 用户想要什么，走哪条

| 用户目的 | 怎么做 |
| --- | --- |
| 某个主题有哪些专利、现有技术摸底 | 分轮检索，见「分轮检索」 |
| 某家公司有多少专利、在做什么方向 | `company` 企业画像，或 `stats --dimension applicant` |
| 某个领域谁在做、趋势如何、技术怎么分布 | `stats` 换维度看，申请人 / 年份 / IPC 各跑一次 |
| 已知公开号，想看这件专利 | `brief` → `citation` → `similar` |
| 手上有个想法，想知道有没有人做过 | `search` + `similar` 摸底。要正式的可专利性结论，走查新任务 |

**FTO / 侵权风险、专利无效检索不在本 Skill 范围内**——那需要代理人签字的法律意见。用户提这类需求时说明边界，可以用检索帮他摸底，但不出结论。

**商标、软件著作权、作品著作权不在覆盖范围内。** 正式专利族数据（族 ID、成员列表、同族类型）也没有——`similar` 的相似专利和优先权号可以辅助归并，但不能当专利族用。

## 执行前检查

信息不足时先问，不要急着跑。问两三个问题的成本，远低于跑一次没用的检索。

| 检查项 | 必须确认的内容 |
| --- | --- |
| 任务 | 找专利、看某一件、还是做统计分析 |
| 对象 | 产品 / 方法、必要技术特征、部件关系、参数和效果 |
| 日期 | 需要限定申请年或公开年范围吗 |
| 地域 | 全球还是仅中国；涉及多国时分别说明覆盖情况 |
| 范围 | 全球还是仅中国 |
| 保密 | 是否包含未申请的关键参数、配方、源代码或商业秘密；技术方案会发送到服务端 |
| 规模 | 预计结果量级，过宽要先收窄，见「检索式构造」|

## 检索深度与费用（必做）

确认完上面的信息后、**开始任何付费检索之前**，把深度选项和预计花费一次性摆给用户，让他选：

```
本次检索范围：[对象 × 机制 × 关键特征；库 = 全球/仅中国；年份 = ...]
请选择检索深度：
  1. 快速摸底 —— 5 次检索，3-5 分钟，**约 ¥0.50（多数情况走每日免费额度，实收 ¥0）**
     适用：摸底、初筛、时间紧、非正式了解
     产出：**一份检索报告**（命中规模 / 头部申请人 / IPC 分布 / 候选清单 / 下一步建议）
     不含权利要求级分析——那要取单篇正文，见第 2 档
  2. 标准检索 —— 8-10 次检索 + 精读 3 篇，8-15 分钟，**约 ¥1.30**
     适用：想看清几篇代表性专利到底写了什么
     产出：报告 + **3 篇代表专利的权利要求解析**
  3. 完整检索 —— 10-12 次检索 + 精读 10-15 篇，20-35 分钟，**约 ¥2.70**
     适用：正式结论、申请前决策、需要可复核的证据链
     产出：报告 + 逐条特征比对 + 完整证据链
```

**报价时把免费额度算进去。** `search` 和 `brief` 每天前 30 次不扣钱，而上面三档
分别只用掉 5 / 13 / 27 次——**当天第一次跑的话，三档基本都是 ¥0**。
按上面的数字报价永远不会报低，报完实收更少，用户只会更满意。

**默认推荐第 1 档。** 绝大多数「帮我看看有没有类似的」用快速摸底就够了；摸完再问用户要不要往下走，比一上来就跑完整检索省得多。

**合并成一次确认**——深度和费用一起问，不要问完深度再问预算，打断两次体验很差。

### 两道闸门

```bash
python scripts/patentmax_client.py budget start --limit 5 --searches 15
python scripts/patentmax_client.py budget status      # 看用了多少钱、跑了几次检索
```

| 闸 | 拦什么 | 默认 |
| --- | --- | --- |
| 金额闸 | 总花费要超上限 | 不设就不拦 |
| **检索次数闸** | 同一任务 `search` 次数到顶 | **15 次，默认就生效** |

次数闸**不需要你先设预算**，客户端一直在数。两道闸都**只拦、不改参数**，
退出码都是 3，被拦的请求不会打接口、不会计费。

**为什么要有次数闸**：金额闸拦不住"跑了 49 次检索"——单次才 ¥0.10，跑到 49 次
也就 ¥4.9，多数预算都装得下。**失控的形式是次数，不是单价。**
实测教训：一次任务 2 分钟内连着跑了 22 次检索，就是在不停换同义词空转。

`budget status` 看还剩多少。**闲置 1 小时自动失效**，不会把上一个任务的计数带到新对话里。

> 被拦时（退出码 3）**停下来**，把已有结果先交给用户，告诉他继续大概要花多少，让他选：
> 换个思路继续 / 用现有候选收尾 / 就此结束。
> **不要自行降级参数硬凑，不要改个词重试，更不要靠拆命令绕开。**

**闸门是内务，不要播报。** 「护栏已就位（上限 ¥5.00 / 15 式检索）」「已设置预算」
这类话一句都不要说——用户要的是检索结果，不是听你汇报自己做了什么准备工作。
设了就设了，**只有真被拦下来的时候才需要开口**。

### 省钱的默认动作（比拦截更重要）

**默认值决定了绝大部分花费，闸门只是兜底。** 按收益排序，每次任务都该默认这么做：

1. **筛选阶段一律不取单篇正文。** 检索结果每行自带标题、摘要、申请人、申请日、IPC、
   法律状态——判断"相不相关"这些就够了。一次 `search --size 50` ¥0.10 = 每篇 ¥0.002，
   而 `brief` 每篇 ¥0.10，**差 50 倍**。这一条是量级差异，任何时候都成立。
2. **`brief` 一次取齐，不要拆成多条命令。** 著录、权项、全文本来就在同一次调用里，
   `--fulltext` 加不加都是 ¥0.10。唯一真的另外花钱的是 `--legal`，而法律状态
   在检索结果里已经有了——要完整事件流水时才加。
3. **`stats` / `company` / `pdf` 默认不用。** 每次 ¥0.30，是检索的 3 倍。
   想知道"谁在做、哪年多"，换个检索式比命中数就行。
4. **别为省钱而漏检。** 前 30 次免费、之后每次一毛，多跑一式检索的代价可以忽略；
   漏掉一篇关键对比文件的代价不可挽回。省的对象是"逐篇取正文"，不是"多跑一次检索"。
5. **关键词跑不动就换语义扩展，不要堆同义词。** 一次 `similar`（¥0.10）
   能顶二十几式同义词轮换，而且捞得到关键词根本覆盖不到的表述。
   **连续换 3 式检索式而前排质量没提升，就该换招了。**

### 记账口径

- 实际花费以命令返回的 **`_spent`** 为准（服务端的真实扣费），不要凭印象估，也不要自己按单价表算。
- **报错不扣费**（401/402/403/429/5xx），**走每日免费额度的调用不扣费**——这两种不会进账单。
- 试验性检索、跑完丢弃的检索**一样扣费**，一样要计数。漏计的大头就是这些。

### 检索式预算与停止条件（硬规则）

**每一档都有明确的检索式次数预算，不是"差不多就行"：**

| 档位 | Bool 检索预算 | 说明 |
| --- | --- | --- |
| 快速摸底 | **4-5 式** | 见下面「最小检索集」，照着跑，不加戏 |
| 标准检索 | **8-10 式** | 分 2 轮 |
| 完整检索 | **10-12 式** | 分 2-3 轮 |

超出预算要继续，**必须先问用户**，并在报告里标注"超出预算 X 式"。

**两个停止条件，满足任一就停，不要跑满预算：**

1. **饱和**：连续两轮不再出现新的分类号、申请人、技术特征或引证线索 → 停。
   **预算内跑不满不算失败**，恰恰说明这个主题已经检索透了。
2. **空转**：连着换同义词重检但前排质量没有提升 → 停，换策略（语义扩展、
   改 IPC 切角），而不是继续堆同义词。

> **反面实测**：一次任务跑了 49 式检索，其中 2 分钟内连着 22 式，全是同义词轮换。
> 起因是语义扩展当时有 bug 返回 0 条，于是拿关键词硬凑——**一次 `similar`（¥0.10）
> 本该替掉这二十几式**。次数闸现在会在第 15 式拦下来。

### 每轮结束必须向用户汇报（标准档 / 完整档）

**不得连续自行跑完所有预算。** 每一轮检索结束、抽查并标注强相关/弱相关/不相关之后，
把这一轮的结果呈给用户，等他选：

```
第 1 轮跑完：3 式检索，命中 XXX 条，强相关 5 篇（列出来）
  A. 继续下一轮（还剩 N 式预算）
  B. 就用现在这些收尾出报告
  C. 换个方向重来
```

快速摸底档不分轮，一口气跑完 4-5 式即可，但**跑完同样要停下来**，
不要自动升级到深度检索。

### 快速摸底该怎么跑

**上面那三档是给用户看的预估，不是系统配额。** 报给用户的价要准，靠的是你自己按档位克制——
客户端的两道闸只是兜底，**到第 15 式才出手，那时候早就该停了**。

#### 最小检索集（固定 4-5 次检索，¥0.40-0.50）

快速摸底**照这个顺序跑，不加戏**：

1. **主检索一式**：对象 × 机制 × 1-2 个高区分特征。前排结果同时用来校准术语和判断规模，
   **不另跑"试验性检索"**——第一式本身就兼任这个角色。
2. **IPC 预检 0-1 次（按需）**：要用 IPC 限定时才单独验一次格式，0 条先修格式再用。
3. **第二式**：对象 × 机制 × 技术问题/效果，换个角度覆盖同一主题。
4. **收窄或换切角 0-1 次（按需）**：前两式噪声明显时，从强相关结果里提取新术语重检。
5. **语义扩展 1 次**：拿前面最接近的一篇，`similar --patent <公开号>`（¥0.10）。
   这一步**便宜又补盲**，关键词漏掉的同义表述靠它捞回来。

**不做**：`stats`、`company`、`pdf`、逐篇 `brief`。

#### 结论降级（强制）

快速摸底只输出**初步印象 + 候选清单**，必须明确写：

> 本结果来自快速摸底，未做饱和检索，**不构成新颖性/创造性结论**。

**禁止**套用正式查新的结论口径——「未发现单篇文献公开全部必要特征」「发现可能破坏新颖性的文献」
这类话一句都不能出现。快速摸底的产出是**筛查结果，不是法律结论**。

#### 收尾必给「深入建议」

快速摸底结束时**必须**交代两件事，让用户自己决定要不要继续，**不要自动转入深度检索**：

- **哪些没覆盖**：未做扩展轮、未做全文比对、未覆盖海外库等
- **最值得深入的方向**：具体到"用已验证的 IPC 加限定"或"对前排 X 篇做权利要求比对"

**不要列成带价目的可选项清单**（「看引证 ¥0.05 / 找相似 ¥0.10 / 企业画像 ¥0.30」）——
那读起来像加购菜单。说清楚"还有哪块没看、往哪走最值"就够了，价钱等他问再说。

#### 升级触发（硬约束）

出现以下任一情况，**停止快速摸底、转完整流程**：

- 发现强相关候选（覆盖 ≥70% 必要特征，或命中核心技术关系）
- 用户表示结果要用于正式决策
- **检索空转**（见下）

**命中过宽先收窄，不要急着升级**：任一式命中 ≥5,000 条时，**先做 1 次收窄**
（加已验证 IPC、日期或申请人限定，或换切角）。收窄后仍 ≥5,000 条、或前排质量没提升，才升级。
这次收窄就是最小检索集第 4 步，不额外加预算。

#### ⚠️ 检索空转 = 假阴性闸门（最危险的一种错误）

**关键词检索在某些技术领域会系统性失效。** 这时按常规收尾会写出「未检索到相关文献」，
而真实情况可能是该领域专利密集——**用户会以为自己的方案全新，这是检索报告里后果最严重的错误。**

**判定（满足任一即触发）**：

1. 两式主检索的命中数**都 < 20 条**；或
2. 已跑的检索式中**≥2 式返回 0 条**，且已排除语法/字段写错；或
3. 抽查前 10 篇，**强相关为 0**（全是无关领域）

**触发后必须做，不得直接收尾**：

1. **至少做一次 `similar --patent` 语义扩展**（¥0.10）。找不到锚点专利时，
   放宽关键词先捞一篇最接近的当锚。
2. 报告里**显著标注**：关键词检索在本领域效果不佳，本轮证据以语义结果为准。
3. 初步印象**不得表述为「未检索到相关文献」**，要说明这是路径受限的结果。

> 我们在这一点上有成本优势：语义扩展 `similar` 只要 **¥0.10**，
> 所以怀疑空转时**尽管跑**，不用犹豫成本。

**为什么摸底阶段不需要它们**：检索结果本身就带标题、摘要、申请人、申请日、IPC、法律状态和**命中总数**。头部申请人分布、年份趋势、技术方向占比，全都能从「换个检索式看命中数」推出来——**一次 ¥0.10（且多数落在免费额度里），而 `stats` 一次 ¥0.30**。

**但报告照出。** 写文件是本地操作，**不花钱**——5 次检索拿到的信息足够撑起一份有命中规模、头部申请人、IPC 分布、候选清单和下一步建议的报告。**任何一档都要出报告文件**，档位之间差的是证据深度，不是给不给报告。

摸底跑完，把「还有哪些没覆盖、值得往哪深入、各自大概多少钱」列给用户，由他决定要不要升档。**不要自作主张替他多花钱**——哪怕只多花 ¥1，他看到账单的感受也是"说好 ¥0.5 怎么扣了这么多"。

**怎么选**：方向已明确、要一次到位 → 完整检索；时间紧或只想摸个底 → 快速摸底，跑完会给出「还有哪些没覆盖、值得往哪深入、大概再花多少」，由用户决定要不要继续。

**不触发这一步的场景**：已知公开号看单篇、单一申请人盘点、宏观统计；同一任务的后续轮次不重复询问。

### 费用护栏

按**预估金额**决定打扰程度，小额不要啰嗦：

| 预估 | 怎么做 |
| --- | --- |
| ≤ ¥5 | 静默执行，结束时报一次账 |
| ¥5 - ¥20 | 先给预估表再跑，**不阻断** |
| > ¥20 | **必须取得用户同意才能开始** |

### 花费怎么报（位置和措辞都有讲究）

**放在回答的最前面，单独一行，先说钱再说结果。** 用户最想立刻确认的就是这次花了多少；
埋在长篇结论的末尾，他得翻到底才看得到。

```
本次查询花费 ¥0.00（每日免费额度）

（空一行，然后才是检索结论）
```

**只说本次，不要说累计。** 「累计已消耗 ¥X.XX」「本次会话共花费」这类对用户没有用——
他要么关心这一次，要么去控制台看总账，中间态没人需要。余额也不用每次都报，
只有 `_balance_warning` 出现（余额不足 ¥5）时才提一句。

**一句话说完**，不要附带和预估的对比、不要解释档位约束、不要列调用明细、
不要写"检索了 N 次"。金额就是金额。

跑的过程中**每轮结束核对一次实际花费**。每个命令的输出都带三个字段，直接读就行，**不要自己跨调用做算术**：

| 字段 | 含义 |
| --- | --- |
| `_spent` | 本次命令实扣合计（`brief --legal` 这种含两次调用的已经加好） |
| `_balance` | **服务端返回的权威余额**，不是本地算的 |
| `_balance_warning` | 余额低于 ¥5 时才出现，出现了就停下来提醒用户充值 |
| `_free_remaining` | 今天还剩几次免费调用（仅 `search` / `brief`） |

**这些数全部来自服务端，直接读、直接报，不要自己按单价表算一遍。** 客户端刻意不再输出
本地估价：历史上估算会系统性偏低（实测自报 ¥2.80、实扣 ¥3.50，漏掉 7 次调用——
试探性检索、重试、跑完丢弃的都容易忘记计数），而一旦两个数字同时出现在用户面前，
"你说花了 2.8 怎么扣了 3.5"这种质疑一次就足以毁掉信任。**以 `_spent` 为唯一口径。**

这个口径问题**只在对话里提一句**（「以密钥消费记录为准」），**绝不写进报告文件**——交付物里不该出现我们自己账目不准的声明。

盯 `_balance` 比盯 `_spent` 有用：它是真值，而且直接告诉你还能跑多久。实际花费超出预估 1.5 倍时停下来请示，给三个选项：**A 追加预算继续 / B 缩小范围收尾 / C 就此结束**。不要自行决定继续。

余额不足会返回 402；此时停止检索并引导用户充值，**不要转向公开网页凑答案**。

## 先筛后读（硬规则）

**这是本 Skill 最省钱的一条，违反它会让费用翻十倍以上。**

检索结果里**每一条已经包含**：公开号、标题、**摘要**、申请人、发明人、申请日、公开日、主分类号、**法律状态**。一次 `search --size 50` 只要 ¥0.10，折合**每篇 ¥0.002**。

而 `brief` 取单篇是 ¥0.10——**每篇贵 50 倍**。降价之后倍数从 200 倍缩到 50 倍，
但这仍然是量级差异：**判断"相不相关"永远用摘要，不用正文。**

所以：

| 阶段 | 用什么 | 规矩 |
| --- | --- | --- |
| 初筛 | 检索结果里的标题 + 摘要 + 法律状态 | **禁止**逐篇 `brief`。判断"相不相关"靠摘要就够 |
| 精读 | `brief` | 只对**进入最终候选池**的那些用，通常 10-15 篇 |

**典型错误**：拿到 100 多篇候选，对每一篇都 `brief` 去判断相关性。那是 100 × ¥0.10 = **¥10**；而正确做法是检索 3 页（¥0.30）读摘要筛到 15 篇，再对这 15 篇精读（¥1.50），**合计 ¥1.80**。

钱之外还有一层：100 次 `brief` 会把上下文塞满，模型反而读不完、抓不住重点。**先筛后读省的不只是钱，还有注意力。**

**什么时候才必须精读**：摘要读着像、要判断技术特征是否落入保护范围时——**判断新颖性看权利要求，不看摘要**（见「候选与证据核对」）。但这一步只对筛完剩下的少数几篇做。

### 用户给的是一段方案/配方文字，要找类似专利 —— **¥0.20 就够**

这是最常见也最容易跑贵的场景。**正确做法两步：**

```bash
# ① 从方案里提炼 2-3 个核心技术特征，检索一次（¥0.10）
python scripts/patentmax_client.py search --q "(特征A OR 同义词) AND 特征B" --size 30

# ② 从结果里挑最接近的一篇，用它的公开号做语义扩展（¥0.10）
python scripts/patentmax_client.py similar --patent <上一步结果里的 patent_number> --limit 20
```

`similar` 是**语义相似**，不是关键词匹配——以一篇专利为锚，把技术方案接近的都捞出来，
正好补上关键词检索漏掉的同义表述。两步合计 **¥0.20**，拿到几十篇候选。

**直接用公开号就行。** 所有按篇取数的命令（`brief` / `similar` / `citation` / `figure`）
都认公开号，服务端自己完成内部寻址，不额外收钱。
（v2 时代要先检索换一个 60 分钟过期的临时 id，还要靠本地缓存躲开那笔 ¥0.10 过路费——
那套机制连同过路费一起取消了，现在不需要再关心 id。）

**错误做法**（实测有用户这么干，烧掉 ¥30+）：把检索到的上百篇**逐篇取权利要求**去人工比对。
判断"像不像"看摘要就够，摘要检索结果里就有；**只有进入最终候选池的少数几篇才值得取正文**。

### 查一篇专利：默认只给 brief，别拆成多条命令

用户说「帮我看看 CN1234567A」时，**默认只跑一条 `brief --patent <号>`（¥0.10）**。
著录、权利要求、说明书全文都在这一次里，够回答「这篇讲了什么」。

**引证（`citation`）和相似专利（`similar`）默认不查。** 它们回答的是"这篇专利的技术来源和周边布局"，和"这篇专利讲了什么"是两个问题——用户没问就不要替他花钱。

**也不要在结尾列一串"还能再查什么，各多少钱"。** 那读起来像加购菜单，
用户要的是答案不是价目表。他想继续自然会说，到时候再跑。

**法律事件（`--legal`）也默认不加。** 判断"还有没有效"看检索结果里的法律状态字段就够；完整的法律事件流水只在追溯历史时才需要。这是 `brief` 里唯一真的另外收钱的开关。

实测教训（v2 时代）：查一篇专利跑了 `brief --claims --legal` + `citation` + `similar` 三条命令，**¥0.90**。其中 ¥0.30 纯粹是同一个公开号换了三次 id。现在换 id 的钱没有了，同样这三条是 ¥0.25——但**能一条 `brief` 带齐的，仍然不要分几次调**。

| 用户说什么 | 跑什么 | 花费 |
| --- | --- | --- |
| 「看看这篇专利」 | `brief --patent X` | ¥0.10 |
| 「它还有效吗」 | 同上，看结果里的法律状态；要完整流水才加 `--legal` | ¥0.10 / +¥0.05 |
| 「它的实施例/配比」 | 加 `--fulltext` | **还是 ¥0.10** |
| 明确要引证或相似专利 | 再单独跑，**先说价** | ¥0.05 / ¥0.10 |

**不要为了"省钱"分两次调 `brief`。** 第一次不加 `--fulltext`、回头又要全文，就是白花第二个 ¥0.10——
而一次带上全文并不多收钱。拿不准要不要全文时，**直接带上**。

### ¥0.30 那一档：`stats` / `company` / `pdf`

**这三个每次 ¥0.30，是检索的 3 倍。** 实测教训：对「锂电池」这种宽词跑了 applicant / applicationYear / legalStatus / ipc 四个维度的 `stats`，**四次就是 ¥1.20**，而这些信息摸底根本用不上。

规矩：

- **摸底阶段一次都不要用。** 想知道「谁在做、哪年多、什么方向」，换检索式看**命中总数**即可——`search --q "A AND B"` 和 `search --q "A AND C"` 比一下命中量，¥0.20 就能得到方向对比，而且多半还落在免费额度里。
- **用户明确要统计分布时才用，而且要先说价。** 「这个要调统计分析接口，一个维度 ¥0.30，你要看几个维度？」
- **多维度必须合并确认。** 四个维度就是 ¥1.20，不要一个一个跑完才报账。
- `pdf` 同理：要专利原文 PDF 才用，判断技术内容看权利要求就够了。

另外三条省钱细节：

- **要更多结果用 `--page` 翻页，不要换个说法重跑整条检索式**。换一次检索式就是一次新扣费，而翻页拿到的是同一批召回的后续部分。
- **同一篇专利在一次任务里只 `brief` 一次**，要的东西一次取齐。分两次调用就是多付一次 ¥0.10。
- **`--fulltext` 不额外收费**，拿不准就加上；它唯一的代价是输出变长、占上下文。

## 实测坑（开跑前扫一眼）

三条最常撞的：**`--sort rank` 在组配式检索上会脱靶**（用 `--sort relation`）、
**宽泛关键词必须叠 IPC 收窄**（「热管理」实测命中 3.5 万）、
**Windows 上一律加 `--json-out` 写文件再读，不要捕获 stdout**（控制台按 GBK 解码中文，乱码且不可逆）。

详情和处理方法见 `references/pitfalls.md`。

## 检索式构造

**三块结构是硬规则**：对象（要保护的东西）× 机制（怎么实现）× 区别特征（凭什么不一样）。
缺一块就会命中过宽或过窄。

完整规则见 `references/query-construction.md`——包含执行前自检、命中后的强制动作、
收窄优先级、申请人检索和 IPC 分类的写法。**第一次构造检索式前先读它。**

## 分轮检索

**只适用于标准档和完整档。快速摸底走「最小检索集」，不分轮。**

要点：先 1-2 次试验性检索校准术语和规模，再逐步精确；连续两轮没有新的分类、
申请人、特征或引证线索就停；每轮结束把结果交给用户校准，别闷头跑完。
**试验性检索一样扣费，一样要计数。**

完整流程见 `references/search-workflow.md`。

## 命令

```bash
# 检索
python scripts/patentmax_client.py search --q "(固态电池 OR 全固态电池) AND 电解质" --size 20
python scripts/patentmax_client.py search --q "t:区块链 AND legalStatus:有效专利" --scope cn --size 50

# 单篇速览：著录 + 权项 + 全文，一次 ¥0.10
python scripts/patentmax_client.py brief --patent CN109761224A
python scripts/patentmax_client.py brief --patent CN109761224A --fulltext   # 全文也回给模型，不加钱

# 相似专利（语义）
python scripts/patentmax_client.py similar --patent CN109761224A --limit 10

# 引证关系
python scripts/patentmax_client.py citation --patent CN109761224A

# 摘要附图存成文件（写报告配图用）
python scripts/patentmax_client.py figure --patent CN109761224A --out fig.png
```

`--scope` 取 `all`（全球，默认）或 `cn`（仅中国）。`--page` 1-100，`--size` 1-50。

**每个命令都支持 `--json-out <文件>`**：完整 JSON 由脚本自己以 UTF-8 写进文件，
stdout 只回一行纯 ASCII 确认（带 `saved_to` 和 `_spent`），然后读那个文件。

```bash
python scripts/patentmax_client.py search --q "锂电池 AND 热管理" --size 30 --json-out search1.json
```

**Windows 上一律这么用。** 直接捕获 stdout 会被控制台按 GBK 解码，中文变乱码且不可逆；
用 shell 的 `>` 重定向也一样会坏，因为坏在解码那一步，不在写文件那一步。

环境里没有 Python 就直接发 HTTP 请求，接口清单见 `references/api-reference.md`。

**公开号直接用**：所有按篇取数的接口都收 `pn` 参数（如 `/api/patent?pn=CN109761224A`），
服务端自己完成内部寻址，前置调用不进用户账单，不需要先检索换 id。

## 相关能力

以下不在本 Skill 范围内，同一把密钥、同一个余额可用：

| 需求 | 用哪个 |
| --- | --- |
| 判断一个方案能不能申请、有没有新颖性 | **专利查新** |
| 竞争对手在做什么、技术格局怎么分 | **企业情报分析** |
| 下一步该往哪走、专利怎么布局 | **技术路线分析** |

用户提这三类需求时，说明本 Skill 只做检索，引导他去对应的能力，**不要用检索结果硬凑一个结论**。

## 候选与证据核对

相似度分数只决定是否进入待核查清单，**最终相关度以特征包含情况、关系、日期和证据位置为准**。

每个要素记录：文献原文位置（权项 / 段落 / 附图）、是明确记载还是隐含记载、日期、可信度。

**判断新颖性看权利要求，不看摘要。** 摘要读着像不等于落进保护范围，要把技术特征逐条比。判断是否由同一篇适格文献公开了全部必要特征——**多篇结果不能拼成单篇覆盖**。

**评价创造性看整体**：最接近的现有技术 → 区别特征及其技术效果 → 实际要解决的技术问题 → 是否存在技术启示。禁止只给孤立特征评级。

**法律状态必须交代**：授权、驳回、撤回、届满、无效意义完全不同。失效专利不构成侵权障碍，但仍然是有效的现有技术。

## 结果交付

**无论哪一档，都要写出一份报告文件**（`<主题>专利检索报告.md`）。写文件不消耗任何额度，而聊天窗口里的内容用户留不住、没法转发给同事、也没法归档。这是我们比"只在对话里回答"强的地方，不要省掉。

报告固定包含这几块（实测有效的结构）：

1. **结论先行** —— 三到五条能直接用的判断，不要让用户自己从表格里提炼
2. **检索过程表** —— 轮次 / 检索式 / 命中量 / 用途，让人能复核也能自己重跑
3. **候选专利表** —— 公开号、标题、申请人、申请日、法律状态、相关点
4. **方法学提示** —— 这次踩到的坑（如"宽词命中 3.5 万需叠 IPC 收窄"），下次能少走弯路
5. **边界说明** —— **压成一小段话，不要列一张全是 ❌ 的表格**。一句话说清检索范围（库、轮次、法域），一句话说清没覆盖什么，一句话说清结论效力（不构成可专利性 / 侵权判断，且申请到公开有约 18 个月窗口期无法覆盖）。满屏叉号会让用户觉得这份报告什么都没做。
6. **还有哪块没看** —— 一句话说清没覆盖什么、往哪深入最值。
   **不要带价目**，也不要列成"还能再查 A（¥x）/ B（¥y）"的可选项清单。

**花费写在对话回复的最前面一行，不写进报告文件。** 报告是要转发、归档的交付物，
里面出现"本次花费 ¥0.50"对接收方没有意义。金额只在对话里说，而且说在最前面。

**不要在报告里写分项表格**（几次检索、单价多少、调了哪些接口）——那是我们的内部账，用户关心的是这份报告花了多少钱，不是我们怎么算出来的。

**更不要在报告里写"按单价表估算，实际以密钥消费记录为准"这类话。** 在交付物里声明自己的账不准，只会让用户怀疑整份报告。金额口径的事在对话里说一句就行，不进文件。

**没超预估就只报金额，一个字都不用多说。** 「与开跑前说的一致」「未超预估」「符合快速摸底档」这类话是在给自己邀功，用户只想知道花了多少——说对上了反而显得心虚。

只有**实际明显超出预估时**（比如说好 ¥0.5 花了 ¥2）才在对话里说一句原因，同样不写进报告。

不要只甩一个列表，至少交代三件事：

1. **用了什么检索式、覆盖什么范围** — 让用户能判断结果可不可信、要不要补检
2. **每条为什么相关** — 一句话说清它和用户的方案在哪一点重合
3. **结论的边界** — 见「结论纪律」

表格列：公开号、标题、申请人、申请日、法律状态、相关点。

## 结论纪律

**禁止输出「该技术无人申请」「不存在相关专利」「不侵权」这类保证性结论。**

使用这个表述：

> 截至 [日期]，在 [数据库、国家、文献类型] 及所列检索式范围内，未发现一篇在关键日期前公开并披露全部必要技术特征的文献。本结果不排除未公开申请、数据库缺口、非专利公开或术语差异造成的漏检。

专利从申请到公开有约 18 个月窗口期，**这期间的申请谁也检索不到**，下「没找到」这类结论时必须讲明白。

需要有法律效力的可专利性结论时，走查新任务并由有资质的机构复核，检索结果本身只是技术参考。

涉及侵权、无效、许可的判断，以各国专利局官方登记簿为准。

## 运行与密钥

```bash
export PATENTMAX_API_KEY="pm_live_你的密钥"
python scripts/patentmax_client.py --help
```

通过环境变量传密钥，避免写进命令历史。密钥在 [api.ip930.com](https://api.ip930.com/features/api-platform) 控制台创建。

**每天前 30 次 `search` / `brief` 免费**（生产密钥，北京时间零点重置），用完自动转为正常计费。

**新用户注册再送 ¥50 体验额度**——按检索 ¥0.10 一次算，够跑 500 次真实检索，不用绑卡、不用先充值。额度分两笔到账：注册即得 ¥10，第一次调用成功后再得 ¥40。

`pm_live_` 是生产密钥，走真实数据，正常情况都用它。

`pm_test_` 是沙箱密钥，检索类每天 30 次，报告类任务返回模拟结果、不调用外部服务。**它跑不出真实结果**，只在用户明确要验证参数或响应结构时才用，不要当免费试用推荐给用户。

不要在报告、终端输出或日志中回显密钥。

### 密钥失效处理

接口返回 401（密钥无效）、402（余额不足）或 403（无权限）时，**立即停止检索流程，向用户报告并等待选择**。

禁止：

- 在密钥失效后自行转向 Google Patents、Espacenet、WIPO Patentscope 等公开检索
- 把公开网页的结果当作本服务的检索结果写进报告
- 静默跳过检索步骤，只在报告里标注「未检索」

公开网页在数据覆盖、字段结构、检索精度和可复核性上与专业库存在实质差异，自行替换会让检索结论不可复核。

向用户输出错误码、可能原因，并给出选项：更新密钥重试 / 改用公开来源但显著标注数据来源差异 / 暂停任务。用户选择后再继续。

## 外部核验与限制

本服务不能覆盖全部非专利公开、同族成员、审查档案和各国官方法律状态。任务需要时：

- 用可用的浏览工具查询官方登记簿、CNIPA、WIPO、EPO、USPTO
- 按领域补论文、标准、产品手册、会议资料
- 在报告中逐项列明「已检索 / 未检索 / 无法访问」，附来源与检索日期

没有外部工具或权限时，继续完成本服务范围内的工作，但必须显著保留：**未检索非专利文献 / 未核验官方法律状态 / 未完成同族成员分析**。

## 参考

| 文件 | 什么时候读 |
| --- | --- |
| `references/query-construction.md` | **构造检索式前必读**——三块结构、自检、收窄优先级、IPC 与申请人写法 |
| `references/query-syntax.md` | 字段前缀、布尔语法、日期范围的精确写法 |
| `references/search-workflow.md` | 完整检索的分轮流程 |
| `references/api-reference.md` | 接口参数与返回字段 |
| `references/faq.md` | 命中 0 条、格式报错等常见问题 |
| `INSTALL.md` | 拿密钥、设环境变量 |

- `references/search-workflow.md` — 检索工作流：分轮策略、吃透一件专利、企业专利家底
- `references/query-syntax.md` — 检索式写法：三块拆解、同义词扩展、IPC 用法
- `references/api-reference.md` — 接口速查：参数、状态码、curl 示例
- `references/faq.md` — 排查：401 / 404 / 429、检索不到、任务卡住、编码问题

正常执行流程不需要读 faq.md，遇到异常时再查。