ChaoticSurfer/seo-suite

竞争对手：谁真正赢得了SERP，以及原因

找出在你的目标查询中排名的域名和页面，衡量它们与你的差异，并将差异转化为具体的修复措施，而不虚构流量或权威数据。

何时使用 / 不使用

用于：

• SERP竞争对手识别。
• 页面与页面比较。
• SERP功能和意图分析。
• 内容/关键词缺口。
• 反向链接缺口（付费）。
• 流量估算（付费，标注）。
• 变化监控。

不用于：

• 从种子词生成关键词列表 → seo-keywords。
• 执行外链推广 → seo-links。
• 你自己的GSC表现 → seo-analytics。

需收集的输入

• 你的域名，以及目标关键词集合（10–100个）。从seo-keywords输出或GSC触手可及列表拉取，或直接询问。
• 市场： 国家 + 语言（搜索的--gl/--hl等价参数），设备焦点。
• 用户已知的业务竞争对手。有用，但需通过SERP验证。
• 可选： 付费工具访问权限（Semrush/Ahrefs/Similarweb）以及任何信用额度预算。

工作流程

1. 收集SERPs（并行）。

   • 将关键词集合分成约10个一批的批次，每批次启动一个seo-serp-researcher代理，并行运行。
   • 每个代理返回每个关键词：排名前10的自然搜索结果URL、页面类型（指南/分类/产品/工具/论坛/视频/本地包）、SERP特征（AI概述、精选摘要、PAA、视频、图片、购物、本地包、论坛/“讨论”）、以及主导意图。
   • WebSearch结果近似于SERP；它们不是个性化、精确位置的Google SERP。标记为 [measured: WebSearch sample]。

2. 识别SERP竞争对手。

   • 统计所有关键词中的域名出现次数。在排名前10的槽位中占比最高的前5–10个域名是真正的竞争对手。
   • 区分：
     • 直接业务竞争对手。
     • 内容发布商/聚合商。
     • 市场平台/UGC（Reddit、YouTube、Wikipedia）。
   • 你与发布商竞争点击量，但不竞争客户。策略不同：超越排名 vs. 被列入/提及。

3. 意图和格式检查。 如果排名前10中有7个以上是与你不同的页面类型（例如列表 vs. 你的产品页面），则修复方法是格式，而非优化（启发式）。首先报告此项。

4. 页面级比较。 对于每个优先关键词：

   mkdir -p seo-work
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/compare_pages.py" https://you.com/page https://rival1.com/a https://rival2.com/b https://rival3.com/c \
     --keyword "target keyword" > seo-work/compare-<slug>.json
   

   阅读：

   • 字数对比 median_competitor_words（仅作参考：长度不是排名因素；google-rules §4）。
   • 标题和疑问式标题。
   • 列表/表格。
   • Schema类型。
   • 信任信号（作者、日期、引用）。
   • 关键词放置。
   • content_gap_phrases（2个以上竞争对手覆盖但你没有覆盖的子主题）。

   并行运行不同关键词的比较。

5. 技术/体验差距（可选）：

   • 在你的URL和排名前2的竞争对手上运行psi.py：现场CWV [measured: CrUX]。
   • 在竞争对手上运行page_audit.py以查看其Schema和可索引性设置。

6. 内容/关键词缺口。

   • 免费： 在竞争对手的主要话题 + SERP批次上运行keyword_ideas.py。竞争对手排名前10而你没有出现的任何关键词都是缺口 [measured: WebSearch sample]。
   • 付费： 参见下一节。

7. 反向链接缺口（仅限付费）。链接到2个以上竞争对手但未链接到你的引用域名 → 提供给seo-links。

8. 变化监控。 当竞争对手突然超越你时：

   • 获取Wayback Machine CDX API：https://web.archive.org/cdx/search/cdx?url=rival.com/page&output=json&limit=20&from=2025&fl=timestamp,statuscode,digest。
   • 变化的digest值表明页面内容发生变化的时刻。
   • 获取https://web.archive.org/web/<timestamp>/rival.com/page以diff旧版与新版（标题、标题、新增章节）。
   • 报告：“排名增长与日期为的页面更新相符”。

9. 综合。

   • 每个关键词：他们获胜的原因（格式、深度、新鲜度、权威性、用户体验、SERP特征），并附有证据标签。
   • 一份简短的操作列表，路由至seo-content / seo-onpage / seo-schema / seo-links / seo-technical。

检查项

检查项	规则	来源
与SERP多数项的意图/格式匹配	≥7/10相同类型 → 匹配	启发式
长度	无偏好的字数；覆盖搜索者所需内容	google-rules §4 [Google文档]
与总结竞争对手相比的原创价值	“超越他人提供价值”是有帮助内容的提问	google-rules §4 [Google文档]
你可以赢得的SERP特征	精选摘要 / PAA：优先回答段落；视频：观看页面；图片	google-rules §3, §8 [Google文档]
AI概述是否存在	符合条件 = 已索引 + 可成为摘要片段；无特殊标记	google-rules §10 [Google文档]
竞争对手富结果	仅限有效的支持类型（FAQ/HowTo不再显示）	google-rules §5 [Google文档]
抓取/复制竞争对手内容	违反抓取和规模化内容政策	google-rules §4 [Google文档]

数据：免费 vs 付费

免费：

• WebSearch SERP样本。
• compare_pages.py、keyword_ideas.py、page_audit.py、psi.py（竞争对手URL/域名的CrUX现场数据）。
• Wayback CDX。
• Google Trends用于需求比较。
• 竞争对手的公开站点地图（sitemap_check.py https://rival.com --sample 0 --urls-out rival-urls.txt 通过lastmod提供其库存和发布节奏）。

付费（${CLAUDE_PLUGIN_ROOT}/references/tools.md）：

• Semrush（## Semrush）。
  • 有机研究：竞争对手的排名关键词和预估流量 [vendor data]。
  • 关键词差距（最多5个域名）：缺失/较弱/未开发的关键词。
  • 更新日期附近的位置历史。
  • 当你需要他们的完整关键词列表而非样本时适用。
  • 成本策略：每季度进行一次关键词差距导出，在导出前按位置1–20和你的话题进行过滤；仅使用正确的国家数据库。
• Ahrefs（## Ahrefs）。
  • 网站分析（有机关键词、热门页面）。
  • 内容差距、链接交集。
  • 当同时需要内容和反向链接差距时适用。
  • 成本策略：按流量排名的热门页面 + 内容差距，限制在竞争对手的前50页。避免重复进行完整导出。
• Similarweb（## 其他付费工具）。用于市场规模评估的总流量和渠道组合估算（有机 vs 付费 vs 引荐）。
• DataForSEO SERP API（## DataForSEO）。精确、基于位置的SERP，带有特征解析，可扩展并按调用付费。当WebSearch样本不够精确时（本地、多城市、每日）适用。

切勿将供应商的流量或关键词数字呈现为测量数据。它们是 [vendor data]/[estimate]，可能偏差数倍，尤其是对于小型网站。

输出

1. 竞争对手图谱： 域名、类型（业务 / 发布商 / UGC）、关键词集合中的排名前10槽位占比、重叠的主要关键词。
2. 每个关键词的SERP表格： 意图、主导格式、存在的特征、我们能否赢得它（是/否/如何）。
3. 每个优先关键词的页面比较摘要： 你的指标 vs 竞争对手中位数、值得覆盖的缺口短语、缺失的Schema/信任信号、路由的操作。
4. 缺口列表： 竞争对手排名但你未出现的关键词（免费样本或付费导出），聚类后交给seo-keywords/seo-strategy。
5. 跃升竞争对手的变更日志（Wayback证据）。

陷阱与误区

• 你的业务竞争对手不一定是你的SERP竞争对手。 使用SERP。
• “他们排名高是因为内容更长。” 相关性，而非因果。匹配意图并添加新内容，而不是填充字数。
• 逐字复制竞争对手的标题会产生商品化内容。以更好的方式覆盖缺口话题（第一手数据、工具、示例）。
• 供应商的DR/DA/流量都是模型。一个“较低DA”的网站排名高于你是正常的。
• WebSearch ≠ 用户实时的Google SERP（位置、个性化、AI概览各不相同）。如果决策依赖于它们，请在浏览器中重新检查关键SERPs。
• 不要激进地抓取竞争对手。 获取少量页面，尊重robots.txt，并在遇到CAPTCHA时停止。

记录工作

追加到SEO-WORKLOG.md（${CLAUDE_PLUGIN_ROOT}/references/worklog.md）：

• 关键词集合和市场。
• 竞争对手列表。
• 比较文件。
• 缺口决策。
• 使用的付费工具单元/信用额度。
• 何时重新运行（每季度，或在下次核心更新后）。