seo-audit

全站 SEO 审核

共享数据缓存

步骤 0 —— 检查共享数据缓存：

开始收集信息前，检查 .seo-cache/ 中是否有可供相关 SEO 技能复用的上下文。 参考：../seo/references/shared-data-cache.md，了解架构和依赖关系图。

如果存在以下缓存文件，请检查：

• .seo-cache/site-meta.json：域名、业务类型、行业和抓取上下文

• .seo-cache/audit-scores.json：先前完整审核的优先级

• .seo-cache/pages/{url-slug}/page-analysis.json：提供 URL 时的页面级上下文

• 如果找到：解析并使用明确有效的字段（注明“使用了来自 [date] 的缓存 [X]”）

• 如果缺失、损坏或不相关：继续收集新证据

• 如果用户说“refresh”或“re-run”：忽略缓存读取，并在写入时覆盖

流程

1. 获取首页：使用 scripts/fetch_page.py 获取 HTML
2. 检测业务类型：根据 SEO 编排器分析首页信号
3. 抓取网站：沿内部链接抓取最多 500 个页面，并遵守 robots.txt
4. 委派给子 Agent（如果可用；否则依次内联执行）：
   • seo-technical —— robots.txt、站点地图、规范 URL、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-local —— GBP 信号、NAP 一致性、评价、本地架构、行业特定的本地因素（检测到本地服务行业时启动：实体店、SAB 或混合业务类型）
   • seo-maps —— 地理网格排名跟踪、GBP 审核、评价情报、竞争对手半径映射（检测到本地服务且 DataForSEO MCP 可用时启动）
   • seo-google —— CWV 实测数据（CrUX）、URL 索引状态（GSC）、自然流量（GA4）（通过 python scripts/google_auth.py --check 检测到 Google API 凭据时启动）
   • seo-backlinks —— 反向链接概况数据：DA/PA、引用域名、锚文本、有害链接（通过 python scripts/backlinks_auth.py --check 检测到 Moz 或 Bing API 凭据时启动，或始终纳入 Common Crawl 域名级指标）
   • seo-cluster —— 语义聚类分析（检测到内容策略信号时启动：博客、支柱页面、主题集群）
   • seo-sxo —— 搜索体验分析：页面类型不匹配、用户故事、用户画像评分（完整审核中始终纳入）
   • seo-drift —— 漂移分析：与存储的基线进行比较（通过 python scripts/drift_history.py <url> 检测到该 URL 存在漂移基线时启动）
   • seo-ecommerce —— 产品架构、市场情报（检测到电子商务行业时启动）
5. 评分 —— 汇总为 SEO 健康度评分（0-100）
6. 报告 —— 生成按优先级排序的行动计划

抓取配置

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

输出文件

• FULL-AUDIT-REPORT.md：全面的调查结果
• ACTION-PLAN.md：按优先级排序的建议（Critical > High > Medium > Low）
• screenshots/：桌面端和移动端截图（如果 Playwright 可用）
• PDF 报告（推荐）：使用 scripts/google_report.py --type full 生成专业的 A4 PDF。报告采用白色封面和企业风格，包含目录、执行摘要、图表（Lighthouse 仪表盘、查询柱状图、索引环形图）、指标卡片、阈值表、附带工作量估算的优先级建议，以及实施路线图。完成审核后，务必提供生成 PDF 的选项。

评分权重

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

报告结构

执行摘要

• 整体 SEO 健康评分（0-100）
• 检测到的业务类型
• 5 个最严重的问题
• 5 项快速优化

技术 SEO

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

内容质量

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

页面 SEO

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

Schema 和结构化数据

• 当前实现
• 验证错误
• 尚未利用的机会

性能

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

图片

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

AI 搜索就绪度

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

优先级定义

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

DataForSEO 集成（可选）

如果有可用的 DataForSEO MCP 工具，请与现有子 Agent 一起启动 seo-dataforseo Agent，利用实时数据丰富审计结果：真实 SERP 排名、带有垃圾评分的反向链接配置文件、页面分析（Lighthouse）、商家信息，以及 AI 可见度检查（ChatGPT 爬虫、LLM 提及）。

Google API 集成（可选）

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

错误处理

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

写入共享数据缓存

完成所有工作后，如果工作流产生了持久性发现，请将简明的 JSON 摘要写入 .seo-cache/。 请遵循 ../seo/references/shared-data-cache.md 中的架构和命名规则；至少包含 cache_type、analyzed_at、来源 URL/域名、关键发现、问题、建议和工具限制。如果 .gitignore 中缺少 .seo-cache/，请将其添加进去。