PatentMax Competitive Intelligence

安装指南

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

什么是

PatentMax Competitive Intelligence 帮助团队分析目标公司在特定技术领域的专利地位，从专利数据中识别竞争对手，并了解更广泛的竞争格局。它结合了专利记录与可选的研究来源（如论文、网站、新闻、标准和诉讼），以支持技术情报、竞争对手对标和专利尽职调查。
该技能执行异步分析，并在任务完成后下载 Word 报告。作为 Openclaw Skills 工作流，它强调准确的公司名称匹配、在付费执行前获得用户的明确批准、进度更新以及对数据覆盖范围和质量限制的清晰披露。

应用场景

比较特定技术领域中指定公司的专利组合与竞争对手。
绘制竞争格局，区分主要参与者和技术路线。
为管理层、投资或项目规划准备专利情报报告。
支持并购尽职调查或竞争对手对标。
在准备侵权风险审查或争议应对时添加诉讼来源。
包含论文、标准、新闻和网络来源以获取更广泛的技术情报。
避免对简单的专利检索、新颖性检查或技术路线图请求使用完整的付费分析。

工作原理

确认两个必需的输入：--subject 的技术名称和 --company 的目标公司确切专利注册名称。如果任一缺失，请询问用户而不是猜测。
设置可选范围，例如目标、市场、时间范围、来源、排除项和背景材料。对于用户未指定的可选字段，使用默认值。
展示提议的分析和返回的价格，然后获取用户确认。付费任务仅在命令包含 --yes 时运行。
提交一个 create 请求并记录其 operation_id。脚本异步返回；不要仅因为分析耗时而重复提交请求。
使用相同的操作 ID 调用 wait 直到完成，共享提供的进度更新。每次等待调用最多运行 30 秒，而整体报告可能需要数十分钟。
成功后，脚本会自动下载 Word 报告。在描述发现之前检查 quality_status、quality_hint 和摘要，并披露任何覆盖范围限制。
提供报告路径、简明摘要和相关建议。避免将专利检索结果视为不侵权或无专利的保证。

配置指南

在 https://api.ip930.com 注册，创建一个 PatentMax API 密钥，并将其设置为 PATENTMAX_API_KEY 环境变量。该技能需要此密钥来提交分析。
确保 Python 可用。如果 python 不可用，请尝试 python3，然后是 py；在 WorkBuddy 中，如果需要，请使用其捆绑的 Python 可执行文件的完整路径。
使用其绝对技能目录路径运行脚本。从用户的工作目录执行命令；默认情况下，Word 报告保存在那里。使用 --out-dir 选择另一个目标。
确认必需的公司和技术输入，告诉用户报价和预期等待时间，并在运行付费任务前获得批准。
export PATENTMAX_API_KEY="YOUR_API_KEY"
python "$DIR/scripts/patentmax_competitive.py" create
--subject "Sodium-ion batteries"
--company "Full patent-registered company name"
--yes python "$DIR/scripts/patentmax_competitive.py" wait
--operation-id 可以在创建时提供可选范围，例如 --objective、--markets "CN,US,EP"、--time-range "2020-2025"、--sources、--excluded、--materials 或 --materials-file。默认来源为专利、论文、网页和新闻；也可以包含标准和诉讼。使用 download --report-id 再次下载报告，或使用 cancel --operation-id 取消任务。将命令超时设置为 120 秒；单个脚本调用在 30 秒内返回。
PatentMax Competitive Intelligence 数据架构与分类体系
该技能将分析参数发送到 PatentMax API 并处理异步任务和报告元数据。它不描述本地数据库或单独的持久数据存储。
数据或字段 用途 --subject 必需的技术焦点；仅提供技术名称。 --company 必需的目标公司，尽可能使用准确的注册申请人名称。 --objective、--markets、--time-range 可选的决策上下文、地理范围和日期覆盖范围。 --sources 来源分类：patent、paper、web、news，可选 standard 和 litigation。 --excluded 要从分析中省略的技术领域。 --materials / --materials-file 随任务保留以供参考的可选用户提供的公司或产品背景。 operation_id 用于通过 wait 恢复轮询的标识符；中断后重复使用它，而不是创建重复任务。
report_id 用于稍后下载报告的标识符。
quality_status / quality_hint 报告质量状态和说明；当状态不是 qualified 时披露限制。
summary 包含执行摘要、建议和报告章节信息，以便简明交付结果。
files 包含已完成报告的完整本地路径；主要交付物是 Word 文档。
idempotency-key 如果未提供，则根据请求内容自动派生，有助于防止在相同重试时重复创建任务和计费。
报告可以借鉴多种来源类型，并且可以按市场、时期和排除项进行范围界定。专利记录可能存在公开延迟、申请人名称变体和数据库覆盖漏洞；这些限制应在结论中体现。

高级特性

create
、
wait
、
download
cancel
命令以及进度报告的异步任务生命周期。
幂等请求处理，在重试相同请求时减少重复任务和费用。
可配置的来源覆盖范围，包括专利、学术论文、网页、新闻、标准和诉讼。
市场、时间范围、目标和排除控件，以定制报告范围。
内联或通过文件提供的可选背景材料。
标记降级覆盖范围或需要审查的章节的质量层元数据。
用于直接交付的 Word 报告导出，带有用于简明交接的摘要字段。
负责任的报告指导：解释检索边界、18 个月专利公开窗口、申请人名称规范化限制，以及在侵权、有效性或许可方面寻求专业法律建议的必要性。

name: patentmax-competitive description: 企业技术专利竞争分析。当用户提到企业情报分析、竞争对手分析、竞品专利、技术竞争格局、专利布局对比、某家公司在做什么技术、行业专利态势，或要一份可交付的企业专利竞争报告时使用。常见说法：「竞品专利分析」「对手在布局什么」「某公司的专利布局」「技术情报」「专利尽调」。Use when the user asks for competitive patent intelligence, competitor technology analysis, or a company's patent landscape report. Requires a PatentMax API key. Also covers competitor patent analysis, technology intelligence, patent due diligence. version: "1.2.1"
author: PatentMax
user-invocable: true
argument-hint: "[企业名称 / 技术方向 / 分析目标]"
allowed-tools: Bash, Read, Write

PatentMax 企业情报分析

输出一份企业技术专利竞争分析报告：这家企业在某个技术方向上有什么、竞争对手在做什么、技术格局怎么分、机会和风险在哪。异步生成，可导出 Word 文档直接交付。

数据来自 PatentMax 专利库，并可将论文、网页、新闻、标准、诉讼一并计入分析来源。

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

需要 PatentMax 密钥。 在 https://api.ip930.com 注册（新用户送 ¥50 体验额度）、创建密钥，设成环境变量 PATENTMAX_API_KEY。没设时脚本会返回中文提示，原样转告用户即可。

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

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

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

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

不要用 cat 读文件、不要用 sleep 等待：读文件用 Read 工具；等待由脚本自己完成
命令在用户的工作目录里运行，生成的 Word 会存到这个目录；也可以用 --out-dir 指定
命令超时设为 120 秒。脚本每条命令最多跑 30 秒就返回，不会卡住
核心原则

必填只有两项：技术方向（--subject）和目标企业（--company）。 报告分析的就是这家企业在这个方向上的专利，竞争对手由报告从专利数据里自动识别。两项缺任何一项都先问用户，别猜。

目标企业要写专利上登记的全称。 一般是「地名＋字号＋行业＋有限公司」，例如「宁德时代新能源科技股份有限公司」。简称或错一个字都可能找不到这家企业的专利。用户只给了简称时，先用专利检索按申请人查一下登记名，再提交。

技术方向只写技术名称。 写「钠离子电池」，不要写「宁德时代在钠离子电池方向的专利布局」——企业名和「专利布局」这类词混进去会让检索跑偏。

这是付费任务，执行前必须报价并取得用户确认。 命令必须显式加 --yes 才会执行。

报告有质量分档，不能一律当结论交付。 quality_status 返回 qualified_degraded 或 review_required 时，说明来源覆盖或部分维度有短板，交付时必须说明限制。

不出保证性结论。 不写「该企业在此方向无专利布局」「不存在专利风险」这类表述——见「结论纪律」。

不重新提交。 报告要跑几十分钟，跑得久不代表失败。只要没有报错，就继续 wait。重新提交是这个技能最常见、代价最大的错误：输入写法一变就会新建任务、重复扣费，用户还要从头再等一遍，而原来那份其实还在正常生成。

什么时候用
用户说 用不用
「分析一下 XX 公司在 YY 方向的专利布局」 ✅ 用
「我们的竞争对手都在做什么技术」 ✅ 用
「这个赛道的专利竞争格局是什么样」 ✅ 用
「要一份竞品专利分析报告交给管理层」 ✅ 用
「XX 公司有多少专利」 ❌ 太轻，用检索或企业画像
「查一下有没有 XX 相关的专利」 ❌ 那是检索
「这个想法能不能申请」 ❌ 那是查新
「我们下一步该往哪个方向布局」 ❌ 那是技术路线分析

前四类才值得跑这个任务。 后面四类用更便宜的方式就能解决，别浪费用户的钱。

执行前检查

信息不足时先问，不要急着跑。问几个问题的成本，远低于跑一次没用的报告。

检查项 必须确认
目标企业（必填） 分析哪家企业。用专利上登记的全称，简称匹配不准
技术方向（必填） 分析它在哪个技术方向上的专利，只写技术名称
目标（可选） 这份报告要支持什么决策——立项、并购尽调、竞品对标、还是应诉准备
地域（可选） 关心哪些市场，会影响检索范围
时间范围（可选） 全部历史还是近三年，新兴技术看近期、成熟技术要看全周期
来源（可选） 除专利外，是否要算上论文、新闻、标准、诉讼
排除（可选） 有没有不想让报告覆盖的方向

只有两项必填缺了才需要追问；可选项用户没提就用默认值，不要为了填表反复问。

背景素材（可选）

--materials / --materials-file 可以不填。用户主动给了背景资料（企业介绍、已知产品等）就带上，会记在任务里备查；没有就不用问，也不用编。

提交前确认（一条消息问完，不花钱）

两项必填齐了以后，用一条消息列给用户确认，用户回「确认」或改完再加 --yes：

📋 准备做企业专利竞争分析

• 目标企业：……（专利上登记的全称）
• 技术方向：……
• 分析目标 / 市场 / 时间范围：……（没说就用默认）
• 费用：¥15（以提交后返回的价格为准；任务失败或取消全额退回）
• 用时：通常要几十分钟；完成后 Word 报告自动存到当前目录

用户已经在同一轮对话里确认过的，不要再问第二遍。

命令

# 最简：只给两项必填
python "$DIR/scripts/patentmax_competitive.py" create \

--subject "钠离子电池"
--company "宁德时代新能源科技股份有限公司"
--yes

# 带上可选项
python "$DIR/scripts/patentmax_competitive.py" create \

--subject "钠离子电池"
--company "宁德时代新能源科技股份有限公司"
--objective "评估我方在钠离子电池正极材料方向立项的竞争环境与专利风险"
--markets "CN,US,EP"
--time-range "近五年"
--yes

# 接着等：每次最多 30 秒，完成时自动下载 Word
python "$DIR/scripts/patentmax_competitive.py" wait --operation-id

# 重新下载 Word（wait 完成时已自动下载过）
python "$DIR/scripts/patentmax_competitive.py" download --report-id

# 不想跑了
python "$DIR/scripts/patentmax_competitive.py" cancel --operation-id

参数说明

--subject（必填）技术方向，只写技术名称；--company（必填）目标企业，专利上登记的全称。缺了脚本会直接提示，不会提交、不会扣费。

--materials、--materials-file、--objective、--markets 都可不填。

--sources 默认 patent,paper,web,news，另可加 standard（标准）、litigation（诉讼）。做侵权风险或应诉准备时把 litigation 加上；做前沿技术判断时 paper 很重要，论文通常比专利早一两年。

--time-range 填 all、近三年、2020-2025 这类描述均可。

--excluded 填不想覆盖的方向，避免报告被无关分支稀释。

--idempotency-key 不填会按请求内容自动生成——同样的输入重试不会重复建任务、重复扣费。

等待并报告进度

create 约 15 秒后返回。返回退出码 10 时，先发这一句，再发输出里的进度：

企业专利竞争分析报告已开始生成，这类报告通常要几十分钟，进度会实时告诉你。

记下输出 JSON 里的 operation_id，后面都用它。不主动向用户展示任务编号，用户问起再给。然后运行：

python "$DIR/scripts/patentmax_competitive.py" wait --operation-id

每条 wait 最多 30 秒就返回。按退出码处理：

退出码 含义 怎么做 10 还在生成 发送输出里的进度，然后立即再运行一次 wait 0 完成了，Word 报告已自动下载 按「读结果」交付 1 出错 按「出错时」处理 2 输入有误，什么都没提交 按 message 补齐后再运行 3 同样的任务已经在跑 用输出里的 operation_id 运行 wait，不要换写法重新提交 进度怎么发（照原文，不改字）

把每条 [进度] …… / [进度 X%] …… 去掉方括号部分，按下表加图标后原文发送：

进度行 发送
[进度] 已开始生成…… 🚀 已开始生成……
[进度] 排队中，已等待…… 🕒 排队中，已等待……
[进度] 生成中，已用时…… 📝 生成中，已用时……
[进度 X%] 某阶段，已用时…… 📝 X% 某阶段，已用时……

例：[进度 35%] 检索竞争对手专利，已用时 6分30秒 → 发送 📝 35% 检索竞争对手专利，已用时 6分30秒。

等待期间只发进度，不附加其它文字；不改写进度文字，不自己估算剩余时间，不编造没出现的百分比
出结果之前不要结束回复。 退出码为 10 时，发完进度立即再运行 wait
等了几十分钟还没完成 → 正常，继续 wait。命令断了、对话重开了，也用同一个 operation_id 运行 wait 接着看，不要重新 create
读结果

退出码 0 时 Word 报告已经下载好，输出 JSON 的 files 里是完整路径。先发：

✅ 100% 企业专利竞争分析报告已生成，用时
📄 报告：

quality_status 不是 qualified 时，紧接着把 quality_hint 讲给用户。没有 Word 时（有 docx_note）照实说。

再根据 summary 用几句话讲要点，讲结论时遵守下面的「结论纪律」（不下保证性结论，交代检索边界）：

字段 怎么讲
executive_summary 核心结论，用自己的话讲两三句，别整段念
recommendations 建议，挑最要紧的两三条讲
report_sections Word 报告里有哪几章，用户想细看时告诉他去哪章找

交付消息里可以再加一句可选的下一步（只挑最相关的一条，没有就不说，不调用工具）：例如「想看我们自己往哪个方向布局能避开对方，可以接着做技术路线与专利布局分析。」

最后一句固定是：

在 https://api.ip930.com 控制台可以查看所有任务和余额。

不要打开 Word 把正文贴进对话，也不要读「完整结果」JSON 全文：用户直接打开 Word 看。贴进来既拖长对话，又白白消耗积分
以上是本轮最后的输出，发完就停：之后不再调用工具、不补表格、不写总结和建议，等用户回复。在这之后再调工具，收尾信息会被埋掉，用户看不到

用户追问细节时，再按下面几条组织回答：

格局怎么分。 谁是主要玩家、各自占什么位置、技术路线是趋同还是分化。

对方的动作意味着什么。 近期申请集中在哪些方向、和公开产品是否对得上、有没有明显的卡位意图。

我方的位置。 空档在哪、哪些方向已经拥挤、绕不开的专利是哪几件。

质量提示要说。 quality_status 不是 qualified 时，向用户说明是哪块数据不足、结论要打几分折扣。

边界。 见下。

出错时

脚本出错时输出 {"error": true, "message": "……"}，message 是写给用户看的中文说明，里面已经写明了下一步怎么办。

原样转述 message，不猜原因、不补充建议、不自己换写法重试
退出码 2（输入有误：少必填项、文件读不了、方案太短）：什么都没提交、没扣费，按 message 补齐后再运行
任务失败或取消时，预扣的费用会全额退回，告诉用户这一点
结论纪律

禁止输出保证性结论，例如「该企业在此方向没有专利布局」「不存在专利风险」「我方方案不侵权」。

使用这类表述：

截至 [日期]，在 [数据库、地域、来源类型] 及所列检索范围内，未检索到该企业在 [方向] 上的公开专利申请。本结果不排除未公开申请（约 18 个月公开窗口）、名称未归一化的关联主体、数据库缺口或术语差异造成的漏检。

三条必须交代：

18 个月公开窗口 — 这期间的申请谁也查不到，对手最新的动作大概率不在数据里 申请人名称未做集团归一化 — 同一集团可能以中文名、英文名、子公司名分散，查跨国集团要分主体再合并，否则会严重低估对方专利量
侵权与效力判断需专业意见 — 本报告是技术与商业参考，涉及侵权、无效、许可的判断以各国专利局官方登记簿和代理人意见为准
相关能力

同一把密钥、同一个余额，还可以用：

普通检索 — 关键词与字段式检索、单篇速览、相似专利、引证分析、15 维统计、企业画像
技术方案查新 — 判断一个想法有没有人做过、能不能申请
技术路线分析 — 从竞争格局往前走一步，给出自己的布局建议
参考
references/materials-guide.md — 可选的背景素材怎么写
references/workflow.md — 完整工作流：问什么、怎么跑、结果怎么组织成交付物
references/faq.md — 排查：参数报错、任务卡住、报告太泛、质量分档含义
PatentMax 新颖性检索

Instagram Post