专利全景调研搭子（PatentMax REST 版）

摸清一个技术领域或一家企业的专利格局：范围界定 → 基线检索 → 主体归一 → 维度统计 → 头部核验 → 技术分支 → 趋势 → 报告。

走 PatentMax 的 HTTP 接口，用户自备 API 密钥（PATENTMAX_API_KEY），客户端脚本 scripts/patentmax_client.py 只用 Python 标准库，不需要 pip install。

全景调研最容易翻车的地方不是接口不会调，是申请人名称没做归一：同一家跨国集团在榜单里同时挂着中文名、日文名、英文名、子公司名，各占一行，排名被严重低估。这个 skill 把归一单独做成一步，并且规定归一没做完就不许出排名。

与相邻能力的分工

铁律（五条）

1. 主体归一未完成，不得出任何排名。 直接从 stats 的 Top 20 榜单念排名是本 skill 唯一一个能让整份报告作废的错误。
2. ¥0.30 那一档必须先报数再调用。 stats / company / pdf 每次 ¥0.30，是检索的 3 倍，且不在每日免费额度内。四个维度就是 ¥1.20。多维度必须合并成一次确认，不要一个一个跑完才报账。
3. 数字只来自工具。 花费以命令返回的 _spent 为准（服务端真实扣费），不要自己按单价表算一遍。历史上自报价系统性偏低——实测自报 ¥2.80、实扣 ¥3.50，漏掉 7 次调用。两个数字同时出现在用户面前一次，就足以毁掉信任。
4. Windows 上一律 --json-out 写文件再读。 直接捕获 stdout 会被控制台按 GBK 解码，中文变乱码且不可逆；用 shell 的 > 重定向也一样坏，坏在解码那一步。
5. 失败不是 0 条。 输出里有 "error": true、退出码不是 0、或结果文件里是 "status": "incomplete"，都表示这一步没跑成，绝不能写成「该领域暂无专利申请」。

🔴 阶段 0：启动门禁（五项全过才能开始）

① 密钥已配置且有效（缺密钥即停）

echo "${PATENTMAX_API_KEY:0:8}"   # 非空才继续；只回显前 8 位，不要回显完整密钥

• 为空 → 停止，引导用户去 api.ip930.com/features/api-platform 创建密钥并设为环境变量（见 INSTALL.md）。
• 不要把密钥写进任何文件、命令历史、报告或日志。

先用不需要密钥的健康检查确认网络通不通：

curl -s "https://api.ip930.com/api/v1/health"

网络都不通就去调付费接口，只会得到一堆 401 而不是"没通"。

② 一次只调研一个对象

全景的每一步（范围、统计口径、归一清单）都假设对象是单一的。

• 「锂电池领域」→ 一个对象 ✅
• 「宁德时代的专利家底」→ 一个对象 ✅
• 「宁德时代在固态电池方向的布局」→ 一个对象（企业 × 领域）✅
• 「固态电池和钠离子电池两个领域分别看看」→ 两个对象，停下询问，让用户选一个或确认分跑两次
• 「宁德时代、比亚迪、LG 三家对比」→ 停下询问：本 skill 一次只做一条归一链，三家混着跑会让归一清单和统计口径互相污染

③ 维度预算先报数（¥0.30 档的硬门槛）

开始任何 stats / company 调用之前，把要跑的维度、每个 ¥0.30、合计多少一次性摆给用户，等他确认。

本次要统计 {n} 个维度：{维度列表}
单价 ¥0.30/维度，合计 ¥{n×0.30}（不在每日免费额度内）
确认继续，还是先只看 {1-2} 个最关键的？

默认建议先跑 1–2 个维度。 多数「看看这个领域什么情况」用 applicant + ipc3 就够；跑完再问要不要加维度，比一上来扫四个维度省得多。

想知道「谁在做、哪年多」这类方向性对比，其实换个检索式比命中数更便宜——search --q "A AND B" 和 search --q "A AND C" 比一下命中量，¥0.20 且多半落在免费额度里。

④ 语言

自动检测输入语言：中文 → 全文中文；其他 → 全文英文（含所有表头与结论），对照见文末「附录 A」。

⑤ 数据源可达

基线检索返回 0 条时，先怀疑写法（字段名大小写、字段不存在、布尔串太多），再怀疑事实。排查顺序见 references/pitfalls.md。0 命中不是"该领域没有专利"。

全流程硬约束

• 预算闸门默认生效。 脚本一直在数检索次数，默认 15 次上限（金额闸默认 ¥5）。被拦时退出码 3，停下来把已有结果交给用户，告诉他继续大概要花多少，让他选：换个思路继续 / 用现有结果收尾 / 就此结束。不要自行降级参数硬凑，不要绕开。
• 闸门是内务，不要播报。「已设置预算上限」这类话一句都不要说，只有真被拦下来时才需要开口。
• 统计结果只说明申请行为，不说明技术实力。 榜单上排第一的可能是专利运营公司、高校，也可能是把一件技术拆成二十件申请的布局策略。排名 ≠ 强弱，解读时必须点明这一点。
• 法律状态要在报告里交代。 有效、失效、审中的构成完全不同；失效专利不计入"当前障碍"，但仍构成现有技术。

执行流程

初始化

python scripts/patentmax_client.py budget start --limit 5 --searches 15

然后把口径复述给用户一行：

本次调研：对象 {领域 / 企业 / 企业×领域} ｜ 时间窗 {起 至} ｜ 地域 {cn|all} ｜ 维度 {列表}（合计 ¥X.XX）

Step 1：范围界定（不调接口）

定下四件事，缺一件就去问用户，不要自己猜：

展示模板：

## 📋 Step 1 完成：范围界定
- 对象：{...}
- 技术边界：{核心概念}；不含 {...}
- 时间窗：{applicationYear:[YYYY TO YYYY]}
- 地域：{cn|all}；统计口径：{申请年 / 公开年}

Step 2：基线检索

拿总量、校准术语。stats 之前必须先有这一步——不然你圈定的范围可能根本不是用户说的那个领域。

python scripts/patentmax_client.py search --q "{核心概念}" --size 30 --json-out s1.json

• 命中过万 → 叠 IPC / 年份收窄，不要翻页硬啃
• 命中 < 20 → 扩大同义词或换上位概念，注意触发空转闸门（见 references/pitfalls.md）

展示模板：

## 📋 Step 2 完成：基线检索
| 检索式 | 库 | 命中 |
|---|---|---|

### 术语卡
- 专利里的叫法：...
- 分类线索：...
- 主要申请人：...

跑完先提炼术语卡再写统计的 q。 用户说「液冷」，专利里可能写「浸没式冷却」——拿错词去统计，整份报告的口径就偏了。

Step 3：主体归一（本 skill 的核心，不可跳过）

先跑一次 stats --dimension applicant，拿到 Top 20 原始榜单，然后人工识别同一集团的不同写法。

python scripts/patentmax_client.py stats --q "{术语卡校准后的 q}" --dimension applicant --json-out st_applicant.json

申请人名称未做集团归一化。同一家公司可能以中文名、日文名、英文名、子公司名等多种写法分散在榜单的不同位置。典型：

合并规则：同一实控主体的所有写法合并计一行，但在报告里保留拆分明细——用户要看的往往正是"这家公司在中国用哪个主体申请"。

展示模板：

## 📋 Step 3 完成：主体归一
| 归一后主体 | 榜单中的写法 | 各写法件数 | 合并后件数 |
|---|---|---|---|
| 丰田 | 丰田自动车株式会社 / トヨタ自動車株式会社 / Toyota Motor Corp | 12 / 8 / 5 | 25 |

### 归一存疑（未合并，需用户确认）
| 写法 | 为什么存疑 |
|---|---|

🔴 存疑的不要硬并。 拿不准是不是同一家，就单列并在报告里标注「未合并，可能影响其实际排名」，让懂行的人判断。错误合并比不合并更糟——会把两家独立公司算成一家。

归一没做完，不许进 Step 8 出排名。

Step 4：维度统计

按 Step 0③ 确认过的维度逐个跑。每个维度 ¥0.30，跑之前确认过就不再重复问。

python scripts/patentmax_client.py stats --q "{q}" --dimension ipc3 --json-out st_ipc3.json
python scripts/patentmax_client.py stats --q "{q}" --dimension applicationYear --json-out st_year.json

可用维度：

每个维度只返回 Top 20。

展示模板：

## 📋 Step 4 完成：维度统计
| 维度 | Top 3 | 件数 | 备注 |
|---|---|---|---|

企业画像（mode=company 路径）在这一步跑：

python scripts/patentmax_client.py company --name "{工商全称}" --json-out co.json

company 按名称精确匹配，要工商全称。查不到就改用 stats --q 'applicant:"企业名"'，按需要的维度统计。

Step 5：头部申请人核验

榜单前几名抽样核验，不要直接念。核验三件事：

1. 归一有没有并错 —— 用 search --q 'applicant:"{该写法}"' 看它名下的专利是不是真的属于这行技术。有些主体名同字不同、或跨界经营。
2. 是不是真在做这门技术 —— 一些大集团专利总量大，但在该细分领域只有零星几件，是统计范围串了。
3. 有没有专利运营壳/高校 —— 它们排前面往往是因为申请量大或拆分申请，不代表产业地位。

python scripts/patentmax_client.py search --q 'applicant:"{主体}" AND {核心概念}' --size 10 --json-out v1.json

展示模板：

## 📋 Step 5 完成：头部核验（抽查 {n} 家）
| 主体 | 榜单件数 | 核验命中 | 是否真在该领域 | 备注 |
|---|---|---|---|---|

{发现并错时}⚠️ {主体} 经核验不属于该领域，已从排名中剔除/下调。

Step 6：技术分支切分

用 ipc3 / ipc4 的统计结果把领域切成几个技术分支，然后对每个分支单独检索验证——分支是不是真有那么多、主要玩家是谁。

python scripts/patentmax_client.py search --q "{核心概念} AND ipc:{分支分类号}" --size 20 --json-out br1.json

展示模板：

## 📋 Step 6 完成：技术分支
| 分支 | 分类号 | 件数 | 占比 | 主要主体 |
|---|---|---|---|---|

看领域整体格局用 ipc2/ipc3，看细分技术路线用 ipc4。 直接用 ipc（完整号）会碎到没法看。

Step 7：趋势与法律状态构成

python scripts/patentmax_client.py stats --q "{q}" --dimension legalStatus --json-out st_legal.json

两个必须交代的点：

• 公开年趋势天然滞后。专利从申请到公开约 18 个月，最近一两年的公开年数据一定是偏低的，不能读成"这个领域降温了"。要看真实热度用 applicationYear，并注明最后一年数据不完整。
• 失效专利不计入当前障碍，但仍是有效的现有技术。

展示模板：

## 📋 Step 7 完成：趋势与法律状态
- 申请年趋势：{…}；{最后一年}数据不完整，已注明
- 法律状态构成：有效 {a} / 审中 {b} / 失效 {c}

Step 8：报告产出

写文件不消耗额度，而聊天窗口里的内容用户留不住、没法转发。任何一档都要出报告文件（<对象>专利全景调研.md）。

结构：

1. 结论先行 —— 三到五条能直接用的判断，不要让用户自己从表格里提炼
2. 口径说明 —— 检索式、时间窗、地域、统计口径、归一规则。没有这一块，整份报告不可复核
3. 归一后的主体排名 —— 附拆分明细
4. 技术分支分布
5. 趋势与法律状态
6. 边界说明 —— 压成一小段话：一句话说清范围，一句话说清没覆盖什么，一句话说清结论效力（排名不等于技术实力，本结果不构成法律意见）。不要列一张全是 ❌ 的表格
7. 还有哪块没看 —— 一句话说清往哪深入最值

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

本次查询花费 ¥{_spent}

只说本次，不说累计。 一个字都不用多说；只有实际明显超出预估时才解释一句原因，同样不写进报告。

🔴 阶段 9：异常处理

单步失败

命令输出 "error": true、退出码非 0、或结果文件里 "status": "incomplete" → 停在该步，展示错误原文、已完成/未完成步骤，询问重试还是调整输入。绝不跳过失败步骤继续下一步。

网络超时就原样重跑同一条命令——同一任务里的重复请求不会重复扣费（客户端自动生成 Idempotency-Key）。不要改写检索式重发，那会变成一次新计费。

业务失败（命令成功了，但什么都没产出）

密钥失效

接口返回 401（密钥无效）/ 402（余额不足）/ 403（无权限）→ 立即停止流程，向用户报告错误码与可能原因，给出选项：更新密钥重试 / 改用公开来源但显著标注数据来源差异 / 暂停任务。

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

公开来源在数据覆盖、字段结构和可复核性上与专业库存在实质差异，自行替换会让整份报告不可复核。

免费额度

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

stats / company / pdf 不在免费额度内，每次 ¥0.30。

附录 A：英文模板对照（输入语言非中文时使用）

全部展示模板改用下列英文，不留任何中文。

用途与边界（合规）

• 本 skill 只访问 api.ip930.com（PatentMax 专利数据接口），用于检索与统计，不向任何其他地址发送数据。
• API 密钥由用户自备，在 api.ip930.com 控制台创建，通过环境变量传入。本 skill 不捆绑、不代管、不回显任何密钥，包内不含任何凭据。费用从用户自己的账户余额扣除，本 skill 的提供方不代收费用。
• 密钥与费用口径以用户自己在控制台的消费记录为准；本 skill 在对话里报的金额取自接口返回的 _spent 字段。
• 输出是技术与管理参考，不是法律意见。侵权、无效、许可等有法律后果的判断，以各国专利局官方登记簿和有资质机构的意见为准。
• 不得将输出用于转售数据或批量抓取建库。
• 脚本只用 Python 标准库，不安装任何第三方依赖，不修改用户环境。

参考