SEO 审计套件

由您的 OpenClaw agent 执行的生产级 SEO 与 GEO 审计。支持页面爬取、评分、问题识别、进度追踪，以及生成面向客户的报告。

安装配置

依赖项

pip3 install requests beautifulsoup4 lxml

高级功能可选依赖：

• GOOGLE_SEARCH_CONSOLE_KEY — Search Console API 所需的 JSON 密钥文件
• BRAVE_API_KEY — 若 web_search 功能已正常工作，则该密钥已预先配置
• PAGESPEED_API_KEY — Google PageSpeed Insights API 密钥（免费配额：每日 25,000 次请求）

工作区

所有数据均存放在 ~/.openclaw/workspace/seo-audit/ 目录下：

seo-audit/
├── config.json          # API 密钥、默认配置
├── sites/               # 各站点独立审计数据
│   └── example.com/
│       ├── audits/      # 按时间戳组织的审计结果
│       ├── keywords/    # 关键词追踪数据
│       └── competitors/ # 竞品分析数据
├── reports/             # 生成的 PDF / Markdown 报告
└── templates/           # 报告模板

运行 scripts/init-workspace.sh 可自动创建该目录结构。

核心工作流

1. 页面级 SEO 审计

对指定 URL 进行爬取，并全面审计所有页面内 SEO 因素：

scripts/audit-page.sh "https://example.com" [--depth 1]

执行的检查项：

• 标题标签（Title tag） — 是否存在；长度是否在 50–60 字符范围内；是否包含目标关键词
• Meta 描述（Meta description） — 是否存在；长度是否在 150–160 字符范围内；是否具有吸引力
• H1 标签 — 是否恰好仅有一个；是否包含主关键词
• 标题层级结构（Header hierarchy） — H1→H2→H3 是否嵌套合理
• 图片 alt 文本（Image alt text） — 所有图片是否均具备描述性 alt 属性
• 站内链接（Internal links） — 数量统计、锚文本质量、是否存在孤立页面（orphan pages）
• 外部链接（External links） — 数量统计、nofollow 使用情况、是否存在失效链接
• 字数（Word count） — 排名最低要求为 300 字；竞争性关键词建议达 1500+ 字
• 关键词密度（Keyword density） — 主关键词自然出现频次（建议 1%–3%）
• Schema 标记（Schema markup） — 是否存在且格式有效的 JSON-LD 结构化数据
• Open Graph / Twitter 卡片（Open Graph / Twitter cards） — 社交平台分享所需的元数据
• 规范链接（Canonical tag） — 是否存在；是否自引用或指向正确 URL
• URL 结构（URL structure） — 是否简洁、含关键词、无冗余参数

输出：JSON 格式审计结果 + 面向人工阅读的摘要。

2. 技术 SEO 审计

检查网站技术基础：

scripts/audit-technical.sh "https://example.com"

执行的检查项：

• 页面速度（Page speed） — 基于 PageSpeed API 的核心网页指标（LCP、FID、CLS）
• 移动端适配（Mobile friendliness） — viewport meta 标签、响应式设计信号
• HTTPS — SSL 证书是否有效；是否存在混合内容（mixed content）
• robots.txt — 是否存在；是否未错误屏蔽重要页面
• XML 站点地图（XML sitemap） — 是否存在、格式是否有效、是否已提交至搜索引擎
• 可抓取性（Crawlability） — 重要页面是否未被 noindex 标记；canonical 标签是否设置合理
• 404 错误（404 errors） — 是否存在失效的内部链接
• 重定向链（Redirect chains） — 是否存在超过 2 跳的重定向链
• 重复内容（Duplicate content） — 不同页面间标题/描述是否高度相似
• hreflang 标签（hreflang） — 是否针对多语言/多区域站点进行了正确配置（如适用）
• 结构化数据（Structured data） — JSON-LD 是否有效，是否存在解析错误

3. GEO（生成式引擎优化）审计

评估页面在 AI 搜索引擎（如 ChatGPT、Perplexity、Google AI Overviews）中的就绪程度：

scripts/audit-geo.sh "https://example.com"

GEO 专项检查项：

• 内容结构（Content structure） — 是否采用清晰的问答（Q&A）格式、定义类表述模式
• 实体明确性（Entity clarity） — 对人物、地点、品牌等实体的指代是否无歧义
• 可引用性（Citation-worthiness） — 是否包含统计数据、具体数据点、独特见解等内容
• 答案简洁性（Concise answers） — 各章节关键信息是否出现在前 2–3 句中
• 主题权威性信号（Topical authority signals） — 内容深度是否足够；是否通过站内链接关联相关主题
• Schema 丰富度（Schema richness） — 是否使用 FAQ、HowTo、Article 等 Schema 类型
• 品牌提及（Brand mentions） — NAP（Name, Address, Phone）信息是否一致；是否建立合理的实体关联
• 信源可信度信号（Source credibility signals） — 是否提供作者简介（author bios）、关于我们页面（about pages）、E-E-A-T 相关指标

输出：GEO 就绪度评分（0–100 分），并附具体改进建议。

4. 竞品分析

围绕目标关键词或域名开展竞品分析：

scripts/analyze-competitor.sh --keyword "ai seo tools" [--competitors "site1.com,site2.com"]

若未显式指定竞品，将通过 Brave Search 自动发现当前排名前 10 的页面。

分析内容包括：

• 内容长度对比
• 关键词使用模式分析
• 标题层级结构对比
• Schema 标记对比
• 反向链接概况（若已配置 Ahrefs / Moz API）
• 内容缺口（Content gaps）—— 竞品覆盖而您尚未覆盖的主题
• GEO 就绪度对比

5. 关键词追踪

长期追踪关键词排名变化：

scripts/track-keywords.sh --site "example.com" --keywords "keyword1,keyword2,keyword3"
scripts/track-keywords.sh --site "example.com" --report  # 显示排名变动情况

• 通过 Brave Search 查询当前关键词排名位置
• 历史数据存储于 sites//keywords/ 目录下
• 当排名发生显著变动（±5 名）时触发告警
• 支持生成周趋势报告

6. 报告生成

一键生成面向客户的交付报告：

scripts/generate-report.sh --site "example.com" --type full    # 完整审计报告
scripts/generate-report.sh --site "example.com" --type summary  # 执行摘要报告
scripts/generate-report.sh --site "example.com" --type geo      # GEO 专项报告
scripts/generate-report.sh --site "example.com" --type monthly  # 月度进展报告

报告包含以下内容：

• 综合评分（0–100 分）及对应等级（A/B/C/D/F）
• 按影响程度排序的高优先级问题清单
• 带示例的具体修复建议
• 竞品基准对比（Competitor benchmarking）
• 进度追踪（若存在历史审计数据）
• GEO 就绪度专项章节

输出格式：Markdown（默认）、HTML（适用于邮件或网页展示）。

评分体系

每次审计均按以下维度生成分项评分：

综合等级标准： A（90–100）、B（80–89）、C（70–79）、D（60–69）、F（＜60）

Cron 集成

• 每周审计： 每周一自动执行完整审计，并与上期结果比对
• 每日关键词检查： 每日追踪关键词排名，对大幅波动实时告警
• 月度报告： 自动按月生成报告，并投递至预设邮箱或协作渠道

参考资料

• references/scoring-rubric.md — 各项检查的详细评分标准
• references/geo-optimization.md — GEO 策略与 AI 搜索排名因素深度解析
• references/search-console-setup.md — Google Search Console API 集成指南