PatentMax 专利统计与态势分析

数据采集、核验、分类、统计到汇总上报。数据源 IPRDB；先读 references/iprdb-api.md。

🔗 数据来源 PatentMax / IPRDB：本技能通过 IPRDB（知嘟嘟，上海吉码数据）全球专利库取数，与 PatentMax 平台同源（覆盖中国、美国、欧洲、日本、韩国及 WIPO）。

• 网页端（零配置在线检索）：https://app.ip930.com
• IPRDB token：向 IPRDB 申请，环境变量 IPRDB_TOKEN 提供
• PatentMax API 密钥：https://api.ip930.com/features/api-platform?tab=keys
• MCP 服务端点：https://api.ip930.com/api/mcp（写进 ~/.workbuddy/mcp.json 的 mcpServers，headers.Authorization 放 Bearer 密钥，保存后在连接器管理页点「信任」生效）

统计维度（IPRDB ration 支持）

countryCode 国家代码、legalStatus 法律状态、applicationYear 申请年、documentYear 公开年、applicant 申请人、inventor 发明人、ipc/ipc1/ipc2/ipc3/ipc4 分类号、loc、province 省、city 市、type 类型。

执行流程

1. 定义统计口径：对象（申请人/领域/时间段/地域）、指标（申请量/授权量/有效量）、分组维度。口径必须写清楚（如"2020-2025 年中国发明专利授权且有效"）。
2. 构建检索式：如 q=(applicant:华为 OR applicant:中兴) AND documentYear:[2020 TO 2025] AND type:发明授权
3. 逐维度统计：

   python scripts/iprdb_client.py ration "<检索式>" applicationYear
   python scripts/iprdb_client.py ration "<检索式>" legalStatus
   python scripts/iprdb_client.py ration "<检索式>" applicant
   python scripts/iprdb_client.py ration "<检索式>" ipc1
   python scripts/iprdb_client.py ration "<检索式>" type
   python scripts/iprdb_client.py ration "<检索式>" province
   

   注意：analysis_total 是 JSON 字符串数组，需解析为 key/count 列表；每维度只返回前 20 项。
4. 明细核验：对总量执行 search，核对 total 与各维度计数加总的一致性；不一致时以 search total 为准并注明。
5. 汇总输出：
   • 汇总表（总量/各维度分布）
   • 趋势（按年申请/公开）
   • 结构（类型/法律状态/地域/申请人/技术 IPC）
   • 可审计说明（检索式、统计时间、口径）

• 适合生成 Excel/表格交付物或直接文字+表格汇报。

输出规范

• 每个数字注明口径与检索式；合计由明细现算（用工具计算），不手写推算。
• 中文输出。