seo-audit

完整网站SEO审计

流程

1. 渲染首页：使用 claude-seo run render_page.py <url> --mode auto --json 捕获原始HTML、渲染后HTML、提取的文本、SPA状态，以及可访问性数据（如需）
2. 检测业务类型：根据SEO编排器分析首页信号
3. 抓取网站：跟踪内部链接最多500个页面，遵守robots.txt
4. 委派给子代理（如果可用，否则按顺序内联执行）：
   • seo-technical -- robots.txt、站点地图、规范标签、核心网页指标、安全标头
   • seo-content -- E-E-A-T、可读性、内容单薄、AI引用准备度
   • seo-schema -- 检测、验证、生成建议
   • seo-sitemap -- 结构分析、质量门控、缺失页面
   • seo-performance -- LCP、INP、CLS测量
   • seo-visual -- 截图、移动端测试、首屏分析
   • seo-geo -- AI爬虫访问、llms.txt、可引用性、品牌提及信号
   • seo-local -- GBP信号、NAP一致性、评论、本地结构化数据、行业特定本地因素（检测到本地服务行业时生成：实体店、SAB或混合业务类型）
   • seo-maps -- 地理网格排名跟踪、GBP审计、评论情报、竞争对手半径映射（检测到本地服务且DataForSEO MCP可用时生成）
   • seo-google -- CWV现场数据（CrUX）、URL索引状态（GSC）、自然流量（GA4）（通过 claude-seo run google_auth.py --check 检测到Google API凭据时生成）
   • seo-backlinks -- 反向链接档案数据：DA/PA、引用域、锚文本、毒性链接（通过 claude-seo run backlinks_auth.py --check 检测到Moz或Bing API凭据时生成，或始终包含Common Crawl域级指标）
   • seo-cluster -- 语义聚类分析（检测到内容策略信号时生成：博客、支柱页面、主题集群）
   • seo-sxo -- 搜索体验分析：页面类型不匹配、用户故事、人物评分（始终包含在完整审计中）
   • seo-drift -- 漂移分析：与存储的基线比较（通过 claude-seo run drift_history.py <url> 检测到URL的漂移基线时生成）
   • seo-ecommerce -- 产品结构化数据、市场情报（检测到电商行业时生成）
5. 评分 -- 汇总为SEO健康评分（0-100）
6. 持久化审计产物 -- 将所有输出写入 {domain}-audit/ 目录
7. 报告 -- 生成优先行动计划及可选的PDF/HTML报告

抓取配置

最大页面数：500
遵守robots.txt：是
跟随重定向：是（最多3跳）
每页超时：30秒
并发请求数：5
请求间隔：1秒

输出文件

• {domain}-audit/FULL-AUDIT-REPORT.md：综合发现
• {domain}-audit/ACTION-PLAN.md：按优先级排序的建议（严重 > 高 > 中 > 低）
• {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-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，格式如下，以便 claude-seo run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/ 即使在Google API数据不可用时也能生成报告：

{
  "summary": {
    "health_score": 0,
    "business_type": "检测到的类型",
    "top_findings": [],
    "quick_wins": []
  },
  "categories": [
    {
      "name": "技术SEO",
      "score": 0,
      "what_works": [],
      "findings": [
        {
          "title": "发现标题",
          "severity": "严重|高|中|低|信息",
          "description": "基于证据的详细信息",
          "recommendation": "具体修复方法"
        }
      ]
    }
  ],
  "action_plan": {
    "phases": [
      {"name": "阶段1：严重修复", "timeframe": "第1周", "items": []},
      {"name": "阶段2：高影响改进", "timeframe": "第2-3周", "items": []},
      {"name": "阶段3：内容与权威", "timeframe": "第2个月", "items": []},
      {"name": "阶段4：监控与迭代", "timeframe": "持续", "items": []}
    ]
  },
  "artifacts": {
    "findings_dir": "findings/",
    "screenshots_dir": "screenshots/"
  }
}

评分权重

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

报告结构

执行摘要

• 整体SEO健康评分（0-100）
• 检测到的业务类型
• 前5个关键问题
• 前5个速赢项

技术SEO

• 可抓取性问题
• 可索引性问题
• 安全问题
• 核心网页指标状态

内容质量

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

页面SEO

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

结构化数据

• 当前实施情况
• 验证错误
• 缺失的机会

性能

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

图片

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

AI搜索准备度

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

优先级定义

• 严重：阻止索引或导致惩罚（立即修复）
• 高：显著影响排名（1周内修复）
• 中：优化机会（1个月内修复）
• 低：锦上添花（待办事项）

DataForSEO集成（可选）

如果DataForSEO MCP工具可用，则生成 seo-dataforseo 代理，与现有子代理一起丰富审计数据，包括实时SERP排名、带垃圾评分的外链档案、页面分析（Lighthouse）、商家列表和AI可见性检查（ChatGPT抓取、LLM提及）。

Google API集成（可选）

如果配置了Google API凭据（claude-seo run google_auth.py --check），则生成 seo-google 代理，用真实的Google现场数据丰富审计：CrUX核心网页指标（取代仅实验室估算）、GSC URL索引状态、搜索表现（点击量、展示次数、点击率）和GA4自然流量趋势。性能（CWV）类别评分受益于现场数据。

错误处理

场景	操作
URL不可达（DNS故障、连接拒绝）	清晰报告错误。不要猜测网站内容。建议用户验证URL后重试。
robots.txt阻止抓取	报告哪些路径被阻止。仅分析可访问页面，并在报告中注明限制。
速率限制（429响应）	退避并减少并发请求。报告部分结果，并注明哪些部分无法完成。
大型网站超时（500+页面）	在超时限制处停止抓取。报告已抓取页面的发现，并估算网站总规模。