SEO 审计技能
使用 SEOmator CLI 对网站进行 SEO、技术、内容、性能、安全、JavaScript 渲染及 AI 就绪性审计。
SEOmator 提供全面的网站审计,通过分析网站结构和内容,覆盖 251 条规则,横跨 20 个类别。
它会提供一个问题列表,包含严重级别、受影响的 URL 和可操作的修复建议。
链接
- SEOmator npm 包:npmjs.com/package/@seomator/seo-audit
- GitHub 仓库:github.com/seo-skills/seo-audit-skill
- Web UI:seomator.com/free-seo-audit-tool
本技能的功能
该技能使 AI 代理能够根据 251 条规则在 20 个类别中审计网站,包括:
- 核心 SEO(19 条规则):规范 URL、索引指令、标题唯一性、规范冲突/循环
- 性能(22 条规则):LCP、CLS、FCP、TTFB、INP、压缩、缓存、精简、HTTP/2
- 链接(19 条规则):损坏的链接、重定向链、锚文本、孤立页面、localhost/片段链接
- 图片(14 条规则):替代文本、尺寸、延迟加载、现代格式、替代文本长度、背景图片
- 安全性(16 条规则):HTTPS、HSTS、CSP、外部链接安全、泄露的秘密、SSL 过期/协议
- 技术性 SEO(13 条规则):robots.txt、sitemap.xml、URL 结构、404 页面、软 404、错误代码
- 可抓取性(18 条规则):Sitemap 冲突、可索引性信号、规范链、分页问题
- 结构化数据(13 条规则):Schema.org 标记、文章、组织、FAQ、产品、面包屑导航
- JavaScript 渲染(13 条规则):已渲染 DOM 检查、原始与渲染不匹配、SSR 检测
- 可访问性(12 条规则):ARIA 标签、颜色对比度、表单标签、地标、触摸目标
- 内容(17 条规则):字数、可读性、关键词密度、重复检测、像素宽度
- 社交(9 条规则):Open Graph 标签、Twitter 卡片、分享按钮、个人资料链接
- E-E-A-T(14 条规则):作者署名、引用、信任信号、关于/联系页面、YMYL 检测
- URL 结构(14 条规则):关键词别名、停用词、大写、下划线、会话 ID、跟踪参数
- 重定向(8 条规则):重定向循环、类型(301/302)、元刷新、JavaScript 重定向、损坏的重定向
- 移动端(5 条规则):字体大小、水平滚动、侵入式插页、视口问题
- 国际化(10 条规则):lang 属性、hreflang 验证(返回链接、冲突、不匹配)
- HTML 验证(9 条规则):DOCTYPE、字符集、头部结构、lorem ipsum、多个标题/描述
- AI/GEO 就绪性(5 条规则):语义化 HTML、AI 机器人访问、llms.txt、Schema 漂移
- 法律合规(1 条规则):Cookie 同意
审计会抓取网站,根据审计规则分析每个页面,并返回一份综合报告,包含:
- 总体健康评分(0-100),附带字母等级(A-F)
- 按类别细分的通过/警告/失败计数
- 按规则分组的具体问题及受影响的 URL
- 可操作的修复建议
何时使用
当您需要以下操作时,使用此技能:
- 分析网站的 SEO 健康
- 调试技术性 SEO 问题
- 检查损坏的链接和重定向链
- 验证元标签、规范 URL 和结构化数据
- 审计安全标头、SSL 和 HTTPS
- 检查可访问性合规性
- 分析 JavaScript 渲染和 SSR 兼容性
- 评估 AI/GEO 就绪性(语义化 HTML、llms.txt、机器人访问)
- 检测页面间的重复内容
- 验证 hreflang 和国际化的设置
- 检查 HTML 文档结构和验证
- 以多种格式生成网站审计报告
- 比较变更前后的网站健康度
前提条件
此技能需要安装 SEOmator CLI。
安装
npm install -g @seomator/seo-audit
验证安装
检查 seomator 是否已安装且系统就绪:
seomator self doctor
这会检查:
- Node.js 版本(推荐 18+)
- npm 可用性
- 用于核心网页指标和 JS 渲染的 Chrome/Chromium
- 对 ~/.seomator 的写入权限
- 本地配置文件是否存在
设置
运行 seomator init 会在当前目录创建一个 seomator.toml 配置文件。
seomator init # 交互式设置
seomator init -y # 使用默认值
seomator init --preset blog # 博客优化配置
seomator init --preset ecommerce # 电商配置
seomator init --preset ci # 最小化 CI 配置
如果目录中没有 seomator.toml 文件,请在运行审计之前使用 seomator init 创建一个。
使用方法
AI 代理最佳实践
您应该始终优先使用 --format llm - 它提供了专为 AI 代理优化的 token 高效 XML 输出(比 JSON 小 50-70%)。
审计时:
- 优先选择在线网站,而不是本地开发服务器,以获得准确的性能和渲染数据
- 当不需要核心网页指标和 JS 渲染检查时,使用
--no-cwv以加快审计速度 - 在实施多个修复时,将修复任务分解为并发的子任务
- 在实施修复后运行类型检查/格式化(如 tsc、eslint、prettier 等)
网站发现
如果用户未提供要审计的网站:
- 检查本地开发服务器配置(package.json 脚本、.env 文件)
- 查找 Vercel/Netlify 项目链接
- 检查环境变量中的部署 URL
- 让用户提供要审计的 URL
如果您同时拥有本地和在线网站,建议审计在线站点以获得准确结果。
基本工作流程
# 快速单页审计,使用 LLM 输出
seomator audit https://example.com --format llm --no-cwv
# 多页面抓取(最多 50 页)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# 完整审计,包含核心网页指标 + JS 渲染分析
seomator audit https://example.com --crawl -m 20 --format llm
高级选项
强制全新抓取(忽略缓存):
seomator audit https://example.com --refresh --format llm
恢复中断的抓取:
seomator audit https://example.com --resume --format llm
仅审计特定类别:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
保存 HTML 报告以共享:
seomator audit https://example.com --format html -o report.html
用于调试的详细输出:
seomator audit https://example.com --format llm -v
命令参考
审计命令选项
| 选项 | 别名 | 描述 | 默认值 |
|---|---|---|---|
--format <fmt> | -f | 输出格式:console, json, html, markdown, llm | console |
--max-pages <n> | -m | 最大抓取页面数 | 10 |
--crawl | 启用多页面抓取 | false | |
--categories <列表> | -c | 要审计的类别(逗号分隔) | 全部 |
--refresh | -r | 忽略缓存,重新获取 | false |
--resume | 恢复中断的抓取 | false | |
--no-cwv | 跳过核心网页指标 + JS 渲染 | false | |
--verbose | -v | 显示进度 | false |
--output <路径> | -o | 输出文件路径 | |
--config <路径> | 配置文件路径 | ||
--save | 保存到 ~/.seomator | false |
其他命令
seomator init # 创建配置文件
seomator self doctor # 检查系统设置
seomator config --list # 显示所有配置值
seomator report --list # 列出过去的报告
seomator db stats # 显示数据库统计信息
输出格式
| 格式 | 标志 | 最佳用途 |
|---|---|---|
| console | --format console | 人类终端输出(默认) |
| json | --format json | CI/CD、程序化处理 |
| html | --format html | 独立报告、共享 |
| markdown | --format markdown | 文档、GitHub |
| llm | --format llm | AI 代理(推荐) |
--format llm 输出是一种紧凑的 XML 格式,针对 token 效率进行了优化:
- 比 JSON 输出小 50-70%
- 问题按严重性排序(关键优先)
- 每个问题附带修复建议
- 干净的 stdout,便于通过管道传输到 AI 工具
示例
示例 1:使用 LLM 输出进行快速审计
# 用户问:“检查 example.com 的 SEO 问题”
seomator audit https://example.com --format llm --no-cwv
示例 2:对大型网站进行深度抓取
# 用户问:“进行深入审计,最多 100 页”
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
示例 3:变更后重新审计
# 用户问:“重新审计网站,忽略缓存结果”
seomator audit https://example.com --refresh --format llm --no-cwv
示例 4:生成可共享的报告
# 用户问:“创建一个可共享的 HTML 报告”
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
示例 5:聚焦特定领域
# 用户问:“只检查我的 JavaScript 渲染和重定向”
seomator audit https://example.com -c js,redirect --format llm
评估结果
分数范围
| 分数 | 等级 | 含义 |
|---|---|---|
| 90-100 | A | 优秀 - 仅需微小优化 |
| 80-89 | B | 良好 - 处理警告 |
| 70-79 | C | 需要改进 - 需要优先修复 |
| 50-69 | D | 差 - 存在多个关键问题 |
| 0-49 | F | 严重 - 需要解决主要问题 |
优先级顺序(按类别权重)
按以下顺序修复问题以获得最大影响:
- 核心(12%)- 元标签、规范、H1、索引
- 性能(12%)- 核心网页指标 + 优化
- 链接(8%)- 内部链接结构
- 图片(8%)- 性能 + 可访问性
- 安全性(8%)- 信任信号、SSL
- 技术性 SEO(7%)- 抓取基础
- 可抓取性(5%)- 可索引性、分页
- 结构化数据(5%)- 富媒体摘要
- JavaScript 渲染(5%)- 已渲染 DOM、SSR
- 内容(5%)- 文本质量 + 重复
- 可访问性(4%)- WCAG 合规性
- 社交(3%)- 社交分享
- E-E-A-T(3%)- 信任、专业知识
- URL 结构(3%)- URL 卫生
- 重定向(3%)- 重定向链
- 移动端(2%)- 视口、字体
- 国际化(2%)- Hreflang
- HTML 验证(2%)- 文档结构
- AI/GEO 就绪性(2%)- 语义化 HTML、AI 机器人
- 法律合规(1%)- Cookie 同意
按严重程度修复
- 失败(status: "fail")- 必须立即修复
- 警告(status: "warn")- 应尽快修复
- 通过(status: "pass")- 无需操作
输出总结
实施修复后,向用户提供所有更改的摘要。
在规划范围时,将任务组织起来,使其可以作为子代理并发运行,以加速实施。
故障排除
seomator 命令未找到
如果看到此错误,表示 seomator 未安装或不在 PATH 中。
解决方法:
npm install -g @seomator/seo-audit
核心网页指标未测量
如果缺少 CWV 指标,可能是 Chrome/Chromium 不可用。
解决方法:
- 安装 Chrome、Chromium 或 Edge
- 运行
seomator self doctor验证浏览器检测 - 如果不需要,使用
--no-cwv跳过 CWV
抓取超时或性能缓慢
对于大型网站,审计可能需要几分钟。
解决方法:
- 使用
--verbose查看进度 - 使用
-m 20限制页面数以获得更快结果 - 使用
--no-cwv跳过基于浏览器的测量
无效 URL
确保 URL 包含协议:
# 错误
seomator audit example.com
# 正确
seomator audit https://example.com
工作原理
- 获取:下载页面 HTML 并测量响应时间
- 解析:提取 DOM、元标签、链接、图片、结构化数据
- 丰富:每次审计获取一次 robots.txt 和 sitemap
- 渲染(如果启用 CWV):通过 Playwright 捕获已渲染 DOM 以进行 JS 渲染分析
- 抓取(如果启用):发现并获取链接的页面
- 分析:对每个页面运行 251 条审计规则
- 评分:计算类别和总体加权得分
- 报告:以请求的格式生成输出
结果存储在 ~/.seomator/ 中,以后可通过 seomator report 检索。
资源
- 完整规则参考:参见
docs/SEO-AUDIT-RULES.md了解所有 251 条规则 - 存储架构:参见
docs/STORAGE-ARCHITECTURE.md了解数据库细节 - CLI 帮助:
seomator --help和seomator <command> --help