PatentMax Patent Search

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install patentmax-patent-search
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 patentmax-patent-search。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PatentMax 专利检索将 AI 编码代理连接到 PatentMax 专利数据库，用于关键词和字段检索、单个专利查询、语义相似度发现、引用分析和专利组合统计。它涵盖 CN、US、EP、JP、KR 和 WIPO 记录，包括权利要求、说明书、法律状态字段和专利图纸。作为技术研究的 Openclaw Skills 之一，它将专利问题转化为结构化、可复现的检索和报告文件。
该技能强调有来源支持的结果、分阶段筛选和透明的成本控制。它将检索结果与法律意见区分开来：它不确定专利性、侵权性、自由实施或有效性。实时结果需要 PatentMax API 访问权限和 API 密钥。

应用场景

检索产品、方法、技术特征或发明概念的现有技术记录。
查找已知的公开号或申请号，并审查其书目数据、权利要求和说明书。
当关键词检索可能遗漏替代术语时，查找语义相似的专利。
探索引用关系并识别相关的技术工作。
审查公司、大学、发明人或机构的专利组合和技术重点。
按申请人、发明人、年份、IPC 分类、地域、法律状态或专利类型比较专利活动。
当用户明确要求时，下载专利 PDF 或保存摘要附图。
构建初步的、有记录的专利全景，同时明确说明检索范围和局限性。

工作原理

明确任务、技术主题、日期范围、地域、所需深度以及提交的材料是否包含机密信息. 搜索时将 Technical 方案细节发送给服务。
在付费工作前解释检索深度和预期成本。酌情使用快速、标准或综合工作流程；在技能成本规则要求的地方获得确认。
围绕技术对象、实现机制和区分特征构建查询。根据需要应用布尔运算符、字段过滤器、日期范围、IPC 分类以及 CN 或全球范围。
针对 PatentMax API 运行捆绑的客户端。在请求单个完整记录之前，先筛选结果标题、摘要、申请人、日期、IPC 代码和法律状态字段。
如果相关，使用语义相似度扩大范围，然后仅检查带有 brief 的入围专利。仅在它们符合用户请求且已解决成本问题时，才添加引用、法律事件、统计数据、公司简介、图纸或 PDF 请求。
跟踪候选人和证据，验证命令状态和返回的数据，并将错误或不完整的结果视为失败——而不是零结果检索。在 API 密钥错误后，不要捏造专利细节或静默替换其他来源。
编写包含发现、查询范围、候选记录、证据参考、局限性和下一步行动的 Markdown 报告。在对话中显示实际服务报告的 _spent 金额，而不是在报告中。

配置指南

从 https://api.ip930.com 上的 PatentMax 控制面板获取 PatentMax API 密钥。实时专利数据需要生产密钥；测试密钥返回模拟结果。
将密钥设置为环境变量。不要将其直接放在命令、报告、终端输出或日志中。
使用其绝对技能目录路径运行捆绑的客户端（$DIR 表示技能的已安装目录）。如果 python 不可用，请使用 python3 或 py，并将命令超时设置为 120 秒。
在构建第一个查询之前，阅读用于特定环境设置的 INSTALL.md 和 references/query-construction.md。使用提供的参考文件了解 API 语法和工作流详细信息。
在 Windows 上，使用 --json-out 写入命令输出并读取生成的 UTF-8 文件；不要捕获或重定向中文 JSON 输出。
export PATENTMAX_API_KEY="pm_live_your_key"
python "$DIR/scripts/patentmax_client.py" --help
python "$DIR/scripts/patentmax_client.py" search --q "(固态电池 OR 全固态电池) AND 电解质" --size 20 --json-out search.json
python "$DIR/scripts/patentmax_client.py" read --file search.json
PatentMax Patent Search 数据架构与分类体系
客户端返回结构化 JSON 并支持 --json-out 以保存完整的 UTF-8 结果。检索记录可以包括公开号、标题、摘要、申请人、发明人、申请日和公开日、主 IPC 分类、法律状态和结果总数。响应还公开了执行元数据，例如 _spent、_balance、_free_remaining、total 和 new_candidates；错误可能表现为 error: true 或 status: incomplete。
工件或元数据 用途
检索和简要 JSON 文件 保存查询结果或单个专利记录以供稍后阅读和证据审查。
read 输出 提取索引、选定的专利行、权利要求或匹配的说明书段落；匹配项可以包含段落编号。
候选账本 跟踪通过检索和相似性操作遇到的专利、重复出现、审查状态以及保留或排除记录的原因。
候选 CSV 导出 导出用于电子表格审查的候选列表。
图纸输出 将请求的专利摘要图保存到指定文件。
Markdown 报告 专利检索报告.md，包含结论、检索过程、候选表、方法说明、范围和局限性。
该技能未定义通用的输出目录；文件路径提供给客户端或为报告选择。候选人跟踪是任务范围的，在不活动一小时后重置，或可以显式清除。

高级特性

布尔查询语法支持
AND
、
OR
、
NOT
、括号以及针对标题、文号、法律状态、专利类型以及申请年或公开年等项目的字段特定过滤器。
检索范围可以针对中国或全球集合；结果可以按相关性或日期排序并分页。
similar
检索从已知专利扩展发现，并可帮助解决关键词检索差距。
brief
在一次调用中检索书目信息、权利要求和说明书文本； --fulltext 控制返回的上下文，无需额外的全文费用。
引用查询、法律事件历史、IPC 和时间趋势统计、公司组合概况、图纸和 PDF 可作为单独的功能提供。
候选人管理支持列表、将记录标记为保留或排除并附带原因、以及导出 CSV。
预算和检索次数保护有助于限制失控的检索；返回的计费元数据具有权威性，不得通过修改查询来绕过被阻止的请求。
结果文件状态检查、显式错误处理和证据参考支持可复现的研究。该技能要求事实专利细节来自 API 响应，并且结论不得超出检索范围。
Openclaw Skills 用户应注意边界：此技能提供专利检索和分析支持，不提供法律意见、专利性结论、FTO 或侵权意见、正式的专利族数据或商标和版权检索。

name: patentmax-patent-search description: 全球专利检索与统计分析。当用户提到专利检索、找专利、现有技术、相似专利、引证分析、某家公司有多少专利、某个领域谁在申请、技术趋势分布，或直接给出一个专利号、公开号时使用。也用于：查外国专利（美国、欧洲、日本、韩国）、按专利号或申请号查一篇、看权利要求和说明书全文、查法律状态（还有没有效）、下载专利 PDF 和附图、查某家企业 / 高校 / 发明人 / 代理机构有哪些专利。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. Also covers foreign (US/EP/JP/KR) patents, lookup by publication or application number, full claims and description, legal status, patent PDF and drawings, and patents of a company, university, inventor or agency. version: "3.4.1"
user-invocable: true
argument-hint: "[专利号 / 检索式 / 企业名称]"
allowed-tools: Bash, Read, Write, WebFetch

PatentMax 专利检索

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

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

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

使用问题、企业采购：访问 ip930.com，右下角「联系客服」。

运行环境（必读，所有命令都适用）

部分 WorkBuddy 等环境的命令行不完整，cat、ls、sleep、rm 等可能找不到。为保证任何电脑都能跑通：

脚本路径一律写绝对路径：$DIR/scripts/patentmax_client.py（$DIR 是本技能所在目录），不要写 cd ... && ...（前一步失败会让后面整条静默不执行）

python 找不到时依次试 python3、py；还找不到就用 WorkBuddy 自带的：先用 Glob 在 ~/.workbuddy/binaries/python/versions/ 下找到 python.exe，用它的完整路径。下文所有 python 都按这条替换

不要用 cat 读文件：读结果文件用 Read 工具，或用脚本的 read 子命令
检索命令几秒就返回；命令超时设为 120 秒即可
快速参考

时间紧就先看这张表。

我要… 怎么做 花费
给一段方案/配方，找类似专利 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 条或全是无关 别收尾，看「检索空转 = 假阴性闸门」 —
命令报错 / 退出码不是 0 不是 0 条，按报错处理，见「失败不是 0 条」 —
只看存下来的结果里某一篇、某一段 read --file ，见「读结果文件」 不花钱
这次任务一共出现过哪些专利 candidates list 不花钱
命中几万条 加 IPC/日期/申请人收窄，别翻页硬啃 —
怎么写检索式 references/query-construction.md —
拿密钥 / 配环境 INSTALL.md —

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

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

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

核心原则

每一条专利信息必须来自接口返回值。 不确定就说不确定，不得凭记忆补公开号、申请日、申请人或法律状态——编一个格式正确的公开号出来，比查不到糟得多。 brief 返回的公开号和你查的对不上时，客户端会直接报错——那个号多半不存在，不要换个写法硬查，也不要用返回的内容。

失败不是 0 条。 命令输出里有 "error": true、退出码不是 0、或结果文件里是 "status": "incomplete"，都表示这一步没跑成， 绝不能写成「未检索到相关专利」。网络超时就原样重跑同一条命令——同一任务里的重复请求不会重复扣费，不要改写检索式重发。

检索不等于查新。 用户要的是「有没有类似的」就用检索；要「能不能申请」的结论，那是查新任务，不在本 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 档。 绝大多数「帮我看看有没有类似的」用快速摸底就够了；摸完再问用户要不要往下走，比一上来就跑完整检索省得多。

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

两道闸门

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

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

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

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

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

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

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

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

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

筛选阶段一律不取单篇正文。 检索结果每行自带标题、摘要、申请人、申请日、IPC、 法律状态——判断"相不相关"这些就够了。一次 search --size 50 ¥0.10 = 每篇 ¥0.002， 而 brief 每篇 ¥0.10，差 50 倍。这一条是量级差异，任何时候都成立。
brief 一次取齐，不要拆成多条命令。 著录、权项、全文本来就在同一次调用里， --fulltext 加不加都是 ¥0.10。唯一真的另外花钱的是 --legal，而法律状态 在检索结果里已经有了——要完整事件流水时才加。
stats / company / pdf 默认不用。 每次 ¥0.30，是检索的 3 倍。 想知道"谁在做、哪年多"，换个检索式比命中数就行。
别为省钱而漏检。 前 30 次免费、之后每次一毛，多跑一式检索的代价可以忽略； 漏掉一篇关键对比文件的代价不可挽回。省的对象是"逐篇取正文"，不是"多跑一次检索"。
关键词跑不动就换语义扩展，不要堆同义词。 一次 similar（¥0.10） 能顶二十几式同义词轮换，而且捞得到关键词根本覆盖不到的表述。 连续换 3 式检索式而前排质量没提升，就该换招了。
记账口径
实际花费以命令返回的 _spent 为准（服务端的真实扣费），不要凭印象估，也不要自己按单价表算。
报错不扣费（401/402/403/429/5xx），走每日免费额度的调用不扣费——这两种不会进账单。
试验性检索、跑完丢弃的检索一样扣费，一样要计数。漏计的大头就是这些。
检索式预算与停止条件（硬规则）

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

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

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

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

饱和：连续两轮不再出现新的分类号、申请人、技术特征或引证线索 → 停。 每次 search / similar 的输出都带 new_candidates（本任务里第一次出现的篇数）， 出现 _saturation 就是这一批全是老面孔。连续两式 new_candidates 很少（前排强相关里没有新的）就该停， 不用凭记忆判断。预算内跑不满不算失败，恰恰说明这个主题已经检索透了。
空转：连着换同义词重检但前排质量没有提升 → 停，换策略（语义扩展、 改 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-2 个高区分特征。前排结果同时用来校准术语和判断规模， 不另跑"试验性检索"——第一式本身就兼任这个角色。 跑完先记一张术语卡再写第二式（三行，记在心里或报告草稿里，不用给用户看）：
专利里的叫法：前排强相关几篇的标题、摘要里实际用的词（用户说「液冷」，专利里可能写「浸没式冷却」「冷却介质」）
分类线索：输出里 page_profile.ipc_group 跟强相关那几篇对得上的分类
主要申请人：page_profile.applicant 里反复出现的
IPC 预检 0-1 次（按需）：要用术语卡里的分类限定时才单独验一次，0 条先修格式再用。
第二式：用术语卡里的叫法，对象 × 机制 × 技术问题/效果，换个角度覆盖同一主题。
收窄或换切角 0-1 次（按需）：前两式噪声明显时，加术语卡里的分类或新术语重检。
语义扩展 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 步，不额外加预算。

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

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

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

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

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

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

我们在这一点上有成本优势：语义扩展 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 就够

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

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

# ② 从结果里挑最接近的一篇，用它的公开号做语义扩展（¥0.10）
python "$DIR/scripts/patentmax_client.py" similar --patent --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 一次，要的东西一次取齐。万一又 brief 了同一篇，客户端会直接用本地缓存（输出带 _reused），不会再扣钱。 --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。

命令

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

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

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

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

# 摘要附图存成文件（写报告配图用）
python "$DIR/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），然后读那个文件。

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

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

结果文件先写占位：命令一开始就往 --json-out 的文件里写 "status": "incomplete"， 失败时把错误写进同一个文件。所以读到 incomplete 或 "error": true 就是这一步没跑成—— 不会再出现「这次失败了、文件里还是上一次的成功结果」。回执里直接带 total、new_candidates， 多数时候不用打开文件就能决定下一步。

读结果文件（不花钱）

一份 brief --fulltext 动辄几万字，整份读进来既慢又把前面的证据挤掉。用 read 只取要的部分：

python "$DIR/scripts/patentmax_client.py" read --file search1.json # 索引：公开号/标题/申请人/日期/状态，不含摘要
python "$DIR/scripts/patentmax_client.py" read --file search1.json --patent CN120581759A # 只看这一篇的完整行（含摘要）
python "$DIR/scripts/patentmax_client.py" read --file brief1.json # 权利要求，默认前 3000 字
python "$DIR/scripts/patentmax_client.py" read --file brief1.json --field description --find "实施例|电导率"

--find 返回命中处前后各 200 字，带所在段落号（如 [0023]）。报告里引用说明书就写这个段落号， 比「说明书中提到」可信得多。全文里找不到某个词不等于没公开，可能换了说法。 取说明书要在 brief 时加 --fulltext 并存文件。Windows 上 read 也加 --json-out。

候选台账（不花钱）

本任务里 search / similar 出现过的每篇专利都自动记账，每行结果带 seen_before。

python "$DIR/scripts/patentmax_client.py" candidates list # 全部候选：出现几次、取没取过全文、取舍状态
python "$DIR/scripts/patentmax_client.py" candidates list --status keep # 只看入选的
python "$DIR/scripts/patentmax_client.py" candidates mark --patent CN120581759A CN122357092A --status keep --reason "水基冷却液配方"
python "$DIR/scripts/patentmax_client.py" candidates mark --patent CN121186301A --status exclude --reason "数据中心机柜结构，非冷却液"
python "$DIR/scripts/patentmax_client.py" candidates export --out 候选专利.csv # 导出 Excel 能直接打开的表（不花钱）

排除必须写理由——报告的候选表要交代为什么不算。写报告时用 candidates list --status keep 出候选专利表， 不要凭记忆拼。台账跟任务走，闲置 1 小时后新任务从空账开始（budget clear 立即清空）。

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

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

相关能力

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

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

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

候选与证据核对

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

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

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

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

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

结论必须绑定出处。 每条技术结论写明公开号 + 权项号或说明书段落号（如 CN120581759A 权1、[0023]）；没有核读过原文的，放进报告末尾的「待核清单」，不要写进结论。

结果交付

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

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

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

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

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

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

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

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

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

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

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

结论纪律

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

使用这个表述：

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

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

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

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

运行与密钥

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

通过环境变量传密钥，避免写进命令历史。密钥在 api.ip930.com 控制台创建。

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

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

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

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

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

密钥失效处理

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

禁止：

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

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

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

出错时

脚本出错时输出 {"error": true, "message": "……"}，message 是写给用户看的中文说明。

原样转述 message，不猜原因、不自己换写法重试；命令失败不等于检索到 0 条，不要写成「未检索到相关专利」
外部核验与限制

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

用可用的浏览工具查询官方登记簿、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 拿密钥、设环境变量

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

PatentMax 技术路线图分析
PatentMax 新颖性检索