PatentMax 专利技术全景
把一个明确的技术主题转为“检索范围—结果核查—统计图表—研发判断”的可追溯报告。适合第一轮技术扫描；不替代查新、FTO、无效证据检索或完整专利导航。
开始前先定边界
确认用户要分析的技术主题、国家/地区、申请日期范围和申请人范围。用户只给主题时，先拟两版检索式：查全版与查准版，展示关键词及排除词，让用户确认后再调用接口。报告记录最终检索式、数据源、抓取时间、页数、每页条数、返回数量和 API 回报的命中总数。
检索使用 https://api.ip930.com/api/search，凭据由环境变量 PATENTMAX_API_KEY 提供。只读取环境变量是否存在，不打印其值。每页最多 50 条；脚本默认仅预览请求数，不联网。执行前查看 PatentMax 控制台当前单价和余额，给出页数与预计调用次数，由用户确认本次调用及预算。确认后才加 --yes。
python scripts/panorama.py --query '(固态电池 OR 全固态电池) AND 电解质' --scope all --pages 2 --out-dir ./result
python scripts/panorama.py --query '(固态电池 OR 全固态电池) AND 电解质' --scope all --pages 2 --out-dir ./result --yes
--scope cn 仅中国；all 为全球。密钥未配置、接口失败、页结果结构无法识别时停止并报告错误，不能用网页内容填补。检索响应里的临时 id 约 60 分钟过期；本流程只做列表统计，不拿它当永久专利标识。
分析顺序
- 检索：逐页取回专利列表，保留原始 JSON。若接口提供命中总数，则对照已抓取数；未抓完的报告必须标注“抽样页结果”。
- 清洗：以申请号优先、公开号其次去重；两者都缺的记录单列为“无法可靠去重”，不推断同族数量。申请人、IPC、日期、法律状态缺失时写“未获取”，不要补猜。
- 统计：按申请年统计趋势，列主要申请人和 IPC 前缀（至小类），并给出各字段有效记录数。公开年不能代替申请年；名称相似的申请人未经核实不合并。
- 解读：每条判断指出所依据的图表和样本量，识别可能的技术方向与空白，再列至少一条反证或检索偏差。若只有前几页，不用“市场份额”“全行业”“垄断”等结论性词。
- 交付：
专利全景数据.json包含检索口径、逐页来源与统计；专利全景报告.html可直接查看。图表与表格使用同一份 JSON 数值。报告给出代表文献的公开号，方便回查。
脚本只调用检索接口，不自动购买报告、下载全文或批量调详情。想进一步做权利要求比对、法律状态、引证或 FTO 时，先单列后续任务及预计额外调用量，不在本轮隐式执行。
质量门槛
- 不把“返回记录数”等同于“不同申请数”；无法去重的记录单列。
- 不把样本分布当作总体分布；未抓完时在标题下方显著标注覆盖比例。
- 图表同时标绝对数和分母，不只写百分比。
- 每个代表文献要有可复核的公开号或申请号；没有编号不列入代表清单。
- 法律状态只按检索时接口返回标注，不能替代官方登记簿实时核验。
- 有敏感的未公开研发材料时，不把技术细节写进公开检索式；先与用户确定可公开的概括范围。
字段口径与报告结构见 references/analysis-standard.md。安装方法见 INSTALL.md。
