| name | site-keyword-research |
| description | 整站关键词研究与深度挖掘。输入一个网站域名或URL，自动完成：首页主题分析 → 递归式关键词树扩展（Google联想词多级分叉）→ 去重合并 → 关键词分层 → 10词SERP详细分析 → 3词定方向，最终输出完整 Markdown 报告。
触发条件：用户说"分析网站关键词"、"关键词研究"、"keyword research"、"挖掘某网站的关键词"、或提供一个URL说"分析这个网站的SEO关键词机会"。
|
Site Keyword Research Skill
输入一个网站域名，输出完整的关键词研究与竞争度分析报告。核心改进：递归式关键词树扩展——不是一次扩展就停，而是持续分叉挖掘，直到词库收敛。
核心工作流
阶段一：递归关键词树扩展（不限次数，直到词库收敛）
→ 种子词 → Google搜索 → 提取 Related Searches + PASF + 问题词
→ 每个新词 → 再搜索 → 再提取 → 持续分叉
→ 直到：不再发现新词 或 词库达到上限（100个）
阶段二：去重合并 → 分层筛选（20词）
→ 去重、去无关词
→ 选20个最有价值的词进详细分析
阶段三：10词SERP详细分析 → 3词定方向
→ 竞争度打分
→ 给出最重要的3个词 + 具体操作建议
关键词来源标注规范（强制）：
| 标签 | 含义 | 可信度 |
|---|
[PASF] | 来自 Google「People Also Search For」的真实搜索推荐 | ⭐⭐⭐⭐⭐ |
[RS] | 来自 Google Related Searches 联想词 | ⭐⭐⭐⭐ |
[Q] | 来自 Google 搜索结果中的「People Also Ask」问题 | ⭐⭐⭐⭐ |
[AI-主题] | AI 根据站点主题扩展生成，需人工验证 | ⭐⭐⭐ |
[竞品] | 从 SERP 结果中竞品内容提取 | ⭐⭐⭐⭐ |
输入参数
执行 skill 时需要提供以下参数：
| 参数 | 说明 | 默认值 |
|---|
domain | 要分析的网站域名（如 example.com） | 必填，从用户输入提取 |
output_dir | 报告输出目录 | 可选，默认为当前目录 |
域名格式支持：
https://example.com → 自动提取 domainexample.com → 直接使用www.example.com → 提取 domain
第一阶段：递归关键词树扩展（核心改进）
1.1 站点主题分析
使用 web_fetch 抓取首页（maxChars: 2000），识别：
- 站点类型（产品工具/内容媒体/电商/SAAS/论坛）
- 核心主题（2-4个主题词，作为种子词根）
- 目标用户群体
- 主要功能/服务
同时抓取首页 HTML 标题、meta description。
1.2 种子词确定
根据站点分析，确定 3-5 个种子关键词（作为树的根节点）：
- 核心产品/服务词
- 核心场景/用途词
- 核心用户需求词
1.3 递归扩展算法（关键词树构建）
这是本 skill 的核心改进——不是一次扩展就停，而是持续分叉。
扩展规则：
每次取队首关键词出列 → Google搜索 → 提取三类词 → 入库 → 新词继续入队
直到队列空（词库收敛）或达到上限（100个唯一词）
搜索格式：
https://www.google.com/search?q=<URL编码关键词>&hl=en
反爬策略（必须执行）：
每次打开搜索页后，等待 3-5 秒 再执行 snapshot，给 JS 渲染足够时间：
browser(action=open, url="https://www.google.com/search?q=...&hl=en")
browser(action=wait, timeMs=4000)
browser(action=snapshot, compact=true)
连续搜索时，两次搜索之间随机等待 2-4 秒，避免固定频率触发反爬：
browser(action=wait, timeMs=2000 + Math.random() * 2000)
如果遇到 CAPTCHA 验证页面：
- 等待 5 秒后刷新页面重试
- 最多重试 2 次
- 如果仍然失败，记录「CAPTCHA 拦截」标注，改用
web_search 补充数据，并在报告中说明 SERP 数据为推算值
每次搜索必须提取以下内容：
A. Related Searches（RS）- 联想词
从搜索结果页底部「Related Searches」区域提取所有联想词，每个标注 [RS]。
B. People Also Search For（PASF）- 推荐词
从 SERP 中「People Also Search For」区域提取推荐词，每个标注 [PASF]。
C. People Also Ask（PAA）- 问题词
从 SERP 中「People Also Ask」区域提取问题，每个标注 [Q]。
提取方法：
- 用
browser(action=open, url="...") 打开搜索页
browser(action=snapshot, compact=true) 获取 DOM- 搜索
Related Searches、People Also Search For、People Also Ask 区块
- 每个区块内的词/问题逐一提取
递归扩展流程图：
种子词队列：[seed1, seed2, seed3]
已收集词库：[]
第1轮：
出列 seed1 → 搜索 → 得到 [rs1, rs2, pasf1, q1]
入库：[rs1[RS], rs2[RS], pas1[PASF], q1[Q]]
新词入队：[rs1, rs2, pasf1, q1, seed2, seed3]
第2轮：
出列 rs1 → 搜索 → 得到 [rs1a, pasf1a, q1a]
入库：[rs1a[RS], pasf1a[PASF], q1a[Q]]
新词入队：[rs2, pasf1, q1, seed2, seed3, rs1a, pasf1a, q1a]
第3轮：
出列 rs2 → 搜索 → ...
...持续直到队列空或达到100词上限
1.4 去重与过滤规则
每次入库前执行去重：
必须去重：
- 完全相同的词（大小写不敏感）
- 复数形式与原形视为同义词（保留一个）
- 与站点主题完全无关的词
词库上限：
- 目标：收集 80-100 个唯一关键词
- 实际执行中如果达到 100 个，停止扩展，进入分层
- 如果队列提前耗尽（词库收敛），也停止扩展
1.5 AI 辅助扩展（补充手段，不是主力）
在递归扩展完成后，如果词库不足 50 个，用 AI 补充扩展：
基于已收集的 [PASF] 和 [RS] 词，识别词根模式，生成更多变体：
模式举例：
{词根} + generator / maker / creator{词根} + free / online / AIhow to {词根} / {词根} tutorial / {词根} for beginnersbest {词根} / {词根} alternatives / {词根} vs
每个生成的词标注 [AI-主题]，需入库参与后续分层。
1.6 候选词收集结果记录
最终词库格式（每个词必须标注来源和深度）：
{关键词} [来源标签|扩展深度]
例：
oracle card generator [RS|depth=1] — 从种子词第1轮扩展
emotional tarot reading [PASF|depth=2] — 从第2轮词扩展而来
how to use oracle cards [Q|depth=1] — 从种子词第1轮扩展
ai oracle card generator [AI-主题] — AI补充生成
扩展深度说明：
depth=1：直接从种子词一次扩展而来，最相关depth=2：从 depth=1 的词再扩展，相关性稍弱但覆盖更广depth=3+：多级扩展，可能发现意外的低竞争词
第二阶段：分层筛选（20词）
2.1 关键词相关性初筛
保留标准（同时满足）：
- 与站点核心主题高度相关
- 搜索意图明确
- 不涉及品牌词（除非该品牌是对手）
剔除标准（满足任一即剔除）：
- 完全无关领域（如医疗、法律等专业领域）
- 过于泛泛
- 无实际搜索信号（Google 没有推荐）
2.2 分层（四层模型）
| 层级 | 定义 | 目标数量 | 策略 |
|---|
| 核心词 | 高搜索量，主赛道 | 1-3个 | 品牌期/长期目标 |
| 中尾词 | 中等搜索量，明确意图 | 3-5个 | 3-6个月内容建设 |
| 长尾词 | 低搜索量，精准需求 | 8-12个 | 立即行动，快速见效 |
| 问题词 | 问句形式，信息需求 | 5-8个 | 博客内容，覆盖漏斗顶端 |
2.3 最终20词筛选标准
从词库中选 20 个进入 SERP 分析：
优先保留：
- 有
[PASF] 或 [RS] 来源（Google 真实推荐）
- 包含高意图修饰词（free、best、generator、alternative、how to）
- 搜索意图是 Transactional 或 Commercial Investigation
- 扩展深度浅的词优先（depth=1 > depth=2 > depth=3+）
第三阶段：10词SERP详细分析
3.1 SERP 分析执行
对筛选出的 20 个词，快速扫描 SERP，挑选 10 个最有商业价值的做详细分析。
快速扫描维度：
- 广告主密度（0/少/多）
- 现有结果类型（工具/博客/论坛/目录）
- Featured Snippet 情况
优先分析：
- Transactional 意图词（商业价值最高）
- 有
[PASF] 来源的词（Google 推荐=真实需求）
- 扩展深度浅的词
3.2 详细分析维度
对每个入选词，打开 SERP：
https://www.google.com/search?q=<URL编码关键词>&hl=en
用 snapshot compact=true 抓取，记录：
| 分析维度 | 记录内容 |
|---|
| 广告主数量 | 0 / 1-3 / 4-6 / 6+ |
| 广告主类型 | 列出主要广告主 |
| Featured Snippet | 有 / 无 |
| 视频结果 | 有 / 无（数量） |
| 前10域名 + 类型 | 工具/博客/目录/论坛/官方 |
| 前10内容深度 | 薄页(<200字) / 中等 / 深度(1000+字) |
| 高权重站数量 | Wikipedia/Quora/Amazon/大型媒体 |
| PASF 推荐词 | 列出 Google 推荐的关联搜索词 |
3.3 竞争度打分
| 维度 | 1分 | 2分 | 3分 | 4分 | 5分 |
|---|
| 广告主 | 0 | 1-2 | 3-5 | 6-8 | 8个以上 |
| 高权重站 | 0 | 1 | 2-3 | 4-5 | 5个以上 |
| Featured Snippet | 无 | — | 1个 | — | 2个以上 |
| 视频结果 | 无 | — | 1-2个 | — | 3个以上 |
| 内容深度 | 全薄页 | 多数薄 | 混合 | 多数深 | 全深度 |
总分 5-10 → 🟢 低竞争（立即行动）
总分 11-17 → 🟡 中竞争（可切入）
总分 18-25 → 🔴 高竞争（观望/迂回）
第四阶段：Top 3 词定方向
4.1 选词标准
综合以下选出最重要的 3 个词：
- 竞争度低（分数 ≤ 10）
- Transaction 意图强（商业转化价值高）
- Google 推荐词优先（[PASF] 来源）
- 扩展深度浅（depth=1 或 depth=2）
4.2 策略报告格式
对每个 Top 3 词，给出：
关键词：{词} [来源标签|扩展深度]
分层：{核心词/中尾词/长尾词/问题词}
竞争度：{分数}分 / {低中高三档}
机会描述：
{一句话说明为什么这个机会现在存在，以及为什么 Google 推荐这个词}
推荐动作（具体到操作）：
- 第一步：做什么
- 第二步：做什么
- 第三步（如需要）：做什么
落地页建议：
- 标题：{建议标题}
- 核心卖点：{3个核心卖点}
- CTA：{建议的 Call to Action}
- 覆盖长尾：{建议同时覆盖的关联长尾词}
外链机会：
{对应的外链建设策略}
输出规范
Markdown 报告（主要内容输出到这里）
报告自动保存到文件，文件名格式：
{output_dir}/{domain}-keyword-research-{YYYY-MM-DD}.md
如果 output_dir 未指定，默认保存到执行目录。
报告结构：
# {域名} 关键词研究报告 — YYYY-MM-DD
## 第一章：站点定位分析
## 第二章：递归关键词树扩展记录
## 第三章：完整候选词库（全部词，含来源+扩展深度）
## 第四章：关键词分层矩阵（20词）
## 第五章：10词SERP详细分析
## 第六章：综合机会矩阵（20词横向对比）
## 第七章：Top 3 关键词定方向
## 第八章：外链策略建议
## 第九章：数据说明与后续建议
聊天回复（摘要形式）
✅ 关键词研究报告已生成
**站点：** {domain}
**递归扩展深度：** {N}轮
**候选词总数：** {N}个
**分析词数：** {M}个
**竞争度概况：** 🟢低竞{N1}个 / 🟡中竞{N2}个 / 🔴高竞{N3}个
📄 完整报告：{filename}
🥇 Top 3 关键词：
1. {词1} — {一句话机会描述}
2. {词2} — {一句话机会描述}
3. {词3} — {一句话机会描述}
💡 低竞争词发现：{1-2个特别值得关注的低竞争词简述}
关键原则
- 递归扩展必须执行到底：不允许只扩一轮就停，必须持续到词库收敛或达到上限
- 每个词必须标注来源和扩展深度：不标注的词视为
[AI-主题]
- PASF 词优先分析：Google 推荐 = 真实用户需求，最有价值的信号
- 20词 → 10词筛选：20词进分层，10词做详细 SERP 分析，不要跳过
- Top 3 必须有具体操作建议：不能只给词不给动作
- 扩展深度浅的词优先：depth=1 最相关，depth=3+ 可能发现意外机会但可信度稍低
错误处理
| 场景 | 处理 |
|---|
| web_fetch 403/404 | 跳过，用已知主题信息继续分析 |
| 站点是全新站（DA≈0） | 标注"新站，竞品内容质量差距是核心机会指标" |
| Google 弹出验证 | 必须用 browser retry（等5秒刷新 / 最多重试2次），禁止降级到 web_search；如果 browser 完全失败，标注「搜索数据获取失败，关键词来源基于官网分析+AI扩展，可信度降低」，不得使用 AI 猜测真实搜索量数据 |
| web_search 全部失败 | 标注「搜索数据获取失败，关键词来源基于官网分析+AI扩展，可信度降低」，不得使用 AI 猜测真实搜索量数据；报告中必须明确标注每个关键词的来源标签，无 [PASF]/[RS] 标签的词单独列出 |
| 队列提前耗尽（词库收敛） | 记录收敛轮次，进入分层分析 |
| SERP 无法抓取（地理位置限制） | 标注"竞争度为推算值，建议在美国节点复查 PASF 数据" |
参考文件
- 完整报告模板：
references/output-template.md
- 单关键词竞争度分析：
keyword-competition-analysis/SKILL.md
