competitor_skill

Competitor Patent Report Skill

用途

给定一条 PatSnap 专业检索式和报告标题，自动检索专利数据库，生成竞争对手专利分析报告 Markdown 文件，包含新公开专利概况、专利技术总结和专利详情三个部分。

首次安装配置

首次使用前，使用者必须配置自己的智慧芽（PatSnap）API Key，否则无法检索专利数据。

本 Skill 包不应内置任何 API Key。分享给他人前，请确认 scripts/config.py 中没有真实 key，且包内不包含 scripts/.env。

AI 引导规则

当用户首次触发本 skill（输入检索式）时， 必须先执行以下检查 ：

1. 在 skill 工作目录的 scripts/ 子目录下查找名为 .env 的配置文件，检查是否存在 PATSNAP_API_KEY

2. 如果文件不存在或 key 为空：

   • 告知用户需要先配置他自己的智慧芽 API Key

   • 询问用户："请提供你的智慧芽 API Key（格式通常为 sk-xxx）："

   • 用户输入后，将其写入 skill 工作目录 scripts/ 子目录下的 .env 配置文件： PATSNAP_API_KEY=用户输入的key

   • 确认写入成功后，继续执行检索

3. 如果 key 已存在，直接执行检索

.env 示例：

PATSNAP_API_KEY=sk-你的智慧芽APIKey
# 可选：如文献检索使用不同 key，可单独配置；未配置时默认复用 PATSNAP_API_KEY
# LITERATURE_API_KEY=sk-你的文献检索APIKey
# 可选：如需 AI 文献总结，可配置自己的 ARK Key；未配置时自动跳过该总结
# ARK_API_KEY=你的ARK_APIKey

触发条件

• 用户输入包含 PatSnap 字段操作符的检索式，例如：

  • ANCS:、 TAC_all:、 DESC_B:、 MAINF:、 ALL_AN:、 PN:、 APD:[、 PBD:[、 APNO:、 PRNO:

• 用户明确要求"运行检索式"、"执行检索"、"根据检索式生成报告"等

调用方式

cd ~/Documents/competitor_skill
bash scripts/run.sh "<检索式>" "<报告标题>" [数量]

参数说明：

• <检索式>：PatSnap 专业检索式（必填）

• <报告标题>：报告标题，用于文件命名和报告头部（可选，默认"专利检索报告"）

• [数量]：最大检索条数，默认 200

报告结构

第一部分：新公开专利概况

• 检索元信息（检索式、报告标题）

• 各公司专利数量统计表格

第二部分：专利技术总结

• 每家公司一张卡片，总结技术焦点和技术手段

第三部分：专利详情

• 按细分技术方向 → 申请人（公司）→ 专利三级展开

• 每篇专利：标题、公开号（可点击跳转智慧芽）、法律状态、申请人、申请日、技术问题、技术手段、技术功效、摘要附图

输出

• run.sh 将报告 Markdown 内容直接输出到 stdout，同时保存到 reports/ 目录

报告生成后的展示规则

run.sh 执行完毕后：

1. 在对话框中展示以下内容：

   • 第一部分（新公开专利概况） ：完整展示

   • 第二部分（专利技术总结） ：完整展示

   • 第三部分（专利详情） ：不在对话框展示，告知用户完整报告已保存到文件

环境要求

• Python 或 uv

依赖

requests>=2.31.0
python-dotenv>=1.0.0

自动安装（通过 uv 或 pip），无需手动操作。

使用前配置

本 Skill 依赖智慧芽开放平台 MCP 服务：

• 完成安装、初次使用时需进行自检，参见 README.md

• 用户需完成账号授权，并确保 Agent 环境已启用对应 MCP 工具

• 若未完成配置，本 Skill 只能提供分析框架，无法检索实时数据或生成基于数据库的结论

• 缺少MCP配置时，引导用户参照 README.md 在 [ open.zhihuiya.com ]( https://open.zhihuiya.com/ ) 获取MCP。