seo-audit

完整网站 SEO 审核

流程

1. 渲染首页：使用 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto --json，在需要时获取原始 HTML、渲染后的 HTML、提取的文本、SPA 状态和无障碍数据
2. 识别业务类型：根据 seo orchestrator 分析首页信号
3. 抓取网站：沿内部链接最多抓取 500 个页面，并遵守 robots.txt
4. 委派给子 Agent（如果可用；否则按顺序直接运行）：
   • seo-technical -- robots.txt、站点地图、规范链接、Core Web Vitals、安全标头
   • seo-content -- E-E-A-T、可读性、内容单薄问题、AI 引用就绪度
   • seo-schema -- 检测、验证、生成建议
   • seo-sitemap -- 结构分析、质量门槛、缺失页面
   • seo-performance -- LCP、INP、CLS 测量
   • seo-visual -- 截图、移动端测试、首屏分析
   • seo-geo -- AI 爬虫访问、llms.txt、可引用性、品牌提及信号
   • seo-agentic -- Lighthouse Agentic Browsing 比例（X/N）、供 Agent 使用的无障碍树、AI Agent 访问策略、Markdown 和发现文件、WebMCP（完整审核中始终包含；其发现结果会纳入 AI 搜索就绪度）
   • seo-local -- GBP 信号、NAP 一致性、评论、本地 Schema、行业特定的本地因素（检测到本地服务行业时启动：实体店、SAB 或混合业务类型）
   • seo-maps -- 地理网格排名跟踪、GBP 审核、评论分析、竞争对手范围映射（检测到本地服务且 DataForSEO MCP 可用时启动）
   • seo-google -- CWV 实测数据（CrUX）、URL 索引状态（GSC）、自然流量（GA4）（通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check 检测到 Google API 凭据时启动）
   • seo-matomo -- Matomo Reporting API：自然流量、落地页、设备 / 国家细分、引荐来源分析（通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run matomo_auth.py --check 检测到 Matomo 凭据时启动；若两者均已配置，则与 seo-google 一同运行；若未配置 GA4，则作为其替代方案）
   • seo-backlinks -- 反向链接概况数据：DA/PA、引荐域名、锚文本、有害链接（通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check 检测到 Moz 或 Bing API 凭据时启动，或始终纳入 Common Crawl 的域名级指标）
   • seo-cluster -- 语义聚类分析（检测到内容策略信号时启动：博客、支柱页、主题集群）
   • seo-sxo -- 搜索体验分析：页面类型不匹配、用户故事、角色评分（完整审核中始终包含）
   • seo-drift -- 漂移分析：与已存储的基线进行比较（通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_history.py <url> 检测到该 URL 存在漂移基线时启动）
   • seo-ecommerce -- 产品 Schema、市场情报（检测到电子商务行业时启动）
5. 评分 -- 汇总得出 SEO 健康评分（0-100）
6. 保存审核产物 -- 将所有输出写入 {domain}-audit/
7. 报告 -- 生成按优先级排序的行动计划以及可选的 PDF/HTML 报告

抓取配置

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

输出文件

• {domain}-audit/FULL-AUDIT-REPORT.md：全面的审计发现
• {domain}-audit/ACTION-PLAN.md：按优先级排序的建议（Critical > High > Medium > Low）
• {domain}-audit/audit-data.json：用于生成报告的结构化审计数据封装
• {domain}-audit/findings/*.md：各类别的专家发现（technical.md、content.md、schema.md、performance.md、visual.md 等）
• {domain}-audit/screenshots/：桌面端 + 移动端截图（如果有 Playwright）
• PDF 报告（推荐）：使用 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/ 生成专业的 A4 PDF。这将生成白色封面的企业级报告，包含目录、执行摘要、图表（Lighthouse 仪表盘、查询柱状图、索引甜甜圈图）、指标卡片、阈值表、附带工作量估算的优先级建议，以及实施路线图。完成审计后，请务必提供 PDF 生成选项。

结构化审计数据封装

将 {domain}-audit/audit-data.json 写成以下结构，以便即使无法获取 Google API 数据，"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/ 也能生成报告：

{
  "summary": {
    "health_score": 0,
    "business_type": "detected type",
    "top_findings": [],
    "quick_wins": []
  },
  "categories": [
    {
      "name": "Technical SEO",
      "score": 0,
      "what_works": [],
      "findings": [
        {
          "title": "Finding title",
          "severity": "Critical|High|Medium|Low|Info",
          "description": "Evidence-backed detail",
          "recommendation": "Specific fix"
        }
      ]
    }
  ],
  "action_plan": {
    "phases": [
      {"name": "Phase 1: Critical Fixes", "timeframe": "Week 1", "items": []},
      {"name": "Phase 2: High-Impact Improvements", "timeframe": "Weeks 2-3", "items": []},
      {"name": "Phase 3: Content & Authority", "timeframe": "Month 2", "items": []},
      {"name": "Phase 4: Monitoring & Iteration", "timeframe": "Ongoing", "items": []}
    ]
  },
  "artifacts": {
    "findings_dir": "findings/",
    "screenshots_dir": "screenshots/"
  }
}

评分权重

类别	权重
技术 SEO	22%
内容质量	23%
页面 SEO	20%
Schema / 结构化数据	10%
性能（CWV）	10%
AI 搜索就绪度	10%
图片	5%

报告结构

执行摘要

• SEO 整体健康评分（0-100）
• 检测到的业务类型
• 5 个最关键的问题
• 5 个最容易快速解决的问题

技术 SEO

• 抓取问题
• 索引问题
• 安全隐患
• Core Web Vitals 状态

内容质量

• E-E-A-T 评估
• 内容单薄的页面
• 重复内容问题
• 可读性评分

页面 SEO

• 标题标签问题
• Meta 描述问题
• 标题结构
• 内部链接缺口

Schema 与结构化数据

• 当前实现
• 验证错误
• 缺失的机会

性能

• LCP、INP、CLS 评分
• 资源优化需求
• 第三方脚本的影响

图片

• 缺少替代文本
• 图片尺寸过大
• 格式建议

AI 搜索就绪度

• 可引用性评分
• 结构改进
• 权威性信号

优先级定义

• Critical：阻止索引或导致处罚（立即修复）
• High：显著影响排名（1 周内修复）
• Medium：优化机会（1 个月内修复）
• Low：锦上添花（列入待办）

DataForSEO 集成（可选）

如果有 DataForSEO MCP 工具，请在现有子 Agent 之外启动 seo-dataforseo Agent，以实时数据丰富审计结果：真实 SERP 排名、带垃圾评分的反向链接档案、页面分析（Lighthouse）、商家列表，以及 AI 可见度检查（ChatGPT 抓取工具、LLM 提及）。

Google API 集成（可选）

如果已配置 Google API 凭据（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check），请启动 seo-google Agent，以真实的 Google 实测数据丰富审计结果：CrUX Core Web Vitals（替代仅基于实验室数据的估算）、GSC URL 索引状态、搜索效果（点击次数、展示次数、CTR），以及 GA4 自然流量趋势。性能（CWV）类别评分从实测数据中获益最大。

Matomo 集成（可选）

如果已配置 Matomo 凭据（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run matomo_auth.py --check），则启动 seo-matomo Agent，利用可自托管的分析数据丰富审计内容：自然访问量趋势、热门落地页、设备和国家/地区分布、渠道／搜索引擎细分，以及自然搜索关键词。可作为 GA4 的替代方案（仅配置 Matomo 时），也可作为补充（同时配置 GA4 和 Matomo 时）。由于细分方式（referrerType==search 与 sessionDefaultChannelGroup == "Organic Search"）和归因窗口规则不同，Matomo 数据不会与 GA4 完全一致。

Google 更新关联分析

在将流量或排名变化归因于任何因素之前，请从一手来源台账中列出该时间段内已确认的 Google 更新：

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run seo_updates.py --since <yyyy-mm> --json

每条记录都附有 Google 所有的 URL。如果 freshness.stale 为 true，请说明该台账可能遗漏了近期更新，并在得出结论前查看 status.search.google.com。日期重叠只是一个假设，绝非因果关系的证明。

错误处理

情况	操作
URL 无法访问（DNS 故障、连接被拒绝）	清楚报告错误。不要猜测网站内容。建议用户确认 URL 后重试。
robots.txt 阻止抓取	报告被屏蔽的路径。仅分析可访问的页面，并在报告中注明这一限制。
速率限制（429 响应）	减缓请求，并减少并发请求数。报告部分结果，并注明哪些部分无法完成。
大型网站超时（500+ 个页面）	在超时时限内限制抓取范围。报告已抓取页面的发现，并估算网站的总体规模。
子 Agent 在大型网站上达到 maxTurns 预算	发现内容不会丢失：每个审计子 Agent 都会在首次分析后将部分结果写入 output_dir/findings/*.md，并在完成前用完整结果覆盖该文件。读取现有的发现文件并将其合并到报告中，同时注明内容可能不完整。