seo-audit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SEO Audit Skill

SEO审计技能

Audit websites for SEO, technical, content, performance, and security issues using the SEOmator CLI.

SEOmator provides comprehensive website auditing by analyzing website structure and content against 134 rules across 18 categories.

It provides a list of issues with severity levels, affected URLs, and actionable fix suggestions.

使用SEOmator CLI对网站的SEO、技术、内容、性能和安全问题进行审计。

SEOmator通过对照18个类别下的134条规则分析网站结构和内容，提供全面的网站审计服务。

它会生成包含问题严重程度等级、受影响URL以及可执行修复建议的问题列表。

链接

SEOmator npm package: npmjs.com/package/@seomator/seo-audit
GitHub repository: github.com/seo-skills/seo-audit-skill
Web UI: seomator.com/free-seo-audit-tool

SEOmator npm包: npmjs.com/package/@seomator/seo-audit
GitHub仓库: github.com/seo-skills/seo-audit-skill
Web界面: seomator.com/free-seo-audit-tool

What This Skill Does

本技能的功能

This skill enables AI agents to audit websites for 134 rules in 18 categories, including:

Core SEO: Canonical URLs, indexing directives, title uniqueness
Meta Tags: Title, description, viewport, favicon, canonical
Headings: H1 presence, heading hierarchy, keyword usage
Technical SEO: robots.txt, sitemap.xml, URL structure, 404 pages
Core Web Vitals: LCP, CLS, FCP, TTFB, INP measurements
Links: Broken links, redirect chains, anchor text, orphan pages
Images: Alt text, dimensions, lazy loading, modern formats
Security: HTTPS, HSTS, CSP, external link safety, leaked secrets
Structured Data: Schema.org markup, Article, Organization, FAQ, Product
Social: Open Graph tags, Twitter cards, share buttons, profile links
Content: Word count, readability, keyword density, author info
Accessibility: ARIA labels, color contrast, form labels, landmarks
Performance: DOM size, CSS optimization, font loading, preconnect
Crawlability: Sitemap conflicts, indexability signals, canonical chains
URL Structure: Keyword slugs, stop words
Mobile: Font sizes, horizontal scroll, intrusive interstitials
Internationalization: lang attribute, hreflang tags
Legal Compliance: Cookie consent, privacy policy, terms of service

The audit crawls the website, analyzes each page against audit rules, and returns a comprehensive report with:

Overall health score (0-100) with letter grade (A-F)
Category breakdowns with pass/warn/fail counts
Specific issues with affected URLs grouped by rule
Actionable fix recommendations

本技能支持AI Agent针对18个类别下的134条规则对网站进行审计，涵盖：

核心SEO：Canonical URLs、索引指令、标题唯一性
元标签：标题、描述、视口、网站图标、规范链接
标题层级：H1标签存在性、标题层级结构、关键词使用
技术SEO：robots.txt、sitemap.xml、URL结构、404页面
核心网页指标（Core Web Vitals）：LCP、CLS、FCP、TTFB、INP测量
链接：失效链接、重定向链、锚文本、孤立页面
图片：替代文本（Alt text）、尺寸、懒加载、现代格式
安全：HTTPS、HSTS、CSP、外部链接安全性、敏感信息泄露
结构化数据：Schema.org标记、文章、组织、FAQ、产品
社交属性：Open Graph标签、Twitter卡片、分享按钮、个人资料链接
内容：字数、可读性、关键词密度、作者信息
可访问性：ARIA标签、颜色对比度、表单标签、地标
性能：DOM大小、CSS优化、字体加载、预连接
可抓取性：站点地图冲突、可索引性信号、规范链接链
URL结构：关键词slug、停用词
移动端适配：字体大小、横向滚动、强制插入式内容
国际化：lang属性、hreflang标签
合规性：Cookie同意、隐私政策、服务条款

审计过程会抓取网站内容，对照审计规则分析每个页面，并返回包含以下内容的全面报告：

整体健康评分（0-100分）及等级（A-F）
各分类的通过/警告/失败数量统计
按规则分组的具体问题及受影响URL
可执行的修复建议

When to Use

使用场景

Use this skill when you need to:

Analyze a website's SEO health
Debug technical SEO issues
Check for broken links
Validate meta tags and structured data
Audit security headers and HTTPS
Check accessibility compliance
Generate site audit reports
Compare site health before/after changes
Improve website performance, accessibility, SEO, security and more

在以下场景中使用本技能：

分析网站的SEO健康状况
调试技术SEO问题
检查失效链接
验证元标签和结构化数据
审计安全标头和HTTPS配置
检查可访问性合规性
生成网站审计报告
对比网站改版前后的健康状况
提升网站性能、可访问性、SEO、安全性等指标

Prerequisites

前置条件

This skill requires the SEOmator CLI to be installed.

使用本技能需要先安装SEOmator CLI。

Installation

安装步骤

bash

npm install -g @seomator/seo-audit

bash

npm install -g @seomator/seo-audit

Verify Installation

验证安装

Check that seomator is installed and the system is ready:

bash

seomator self doctor

This checks:

Node.js version (18+ recommended)
npm availability
Chrome/Chromium for Core Web Vitals
Write permissions for ~/.seomator
Local config file presence

检查SEOmator是否安装成功以及系统环境是否就绪：

bash

seomator self doctor

该命令会检查：

Node.js版本（推荐18+）
npm可用性
用于测量Core Web Vitals的Chrome/Chromium浏览器
~/.seomator目录的写入权限
本地配置文件是否存在

Setup

配置步骤

Running

seomator init

creates a

seomator.toml

config file in the current directory.

bash

seomator init                    # Interactive setup
seomator init -y                 # Use defaults
seomator init --preset blog      # Blog-optimized config
seomator init --preset ecommerce # E-commerce config
seomator init --preset ci        # Minimal CI config

If there is no

seomator.toml

in the directory, CREATE ONE with

seomator init

before running audits.

运行

seomator init

会在当前目录创建一个

seomator.toml

配置文件。

bash

seomator init                    # 交互式配置
seomator init -y                 # 使用默认配置
seomator init --preset blog      # 博客优化配置
seomator init --preset ecommerce # 电商网站优化配置
seomator init --preset ci        # 极简CI配置

如果当前目录没有

seomator.toml

文件，请先运行

seomator init

创建配置文件，再执行审计。

Usage

使用方法

AI Agent Best Practices

AI Agent最佳实践

YOU SHOULD always prefer
--format llm
- it provides token-optimized XML output specifically designed for AI agents (50-70% smaller than JSON).

When auditing:

Prefer live websites over local dev servers for accurate performance and rendering data
Use
--no-cwv
for faster audits when Core Web Vitals aren't needed
Scope fixes as concurrent tasks when implementing multiple fixes
Run typechecking/formatting after implementing fixes (tsc, eslint, prettier, etc.)

请始终优先使用
--format llm
参数——它会生成专门为AI Agent优化的XML格式输出，比JSON格式小50-70%，更节省token。

执行审计时：

优先选择在线网站而非本地开发服务器，以获取准确的性能和渲染数据
当不需要Core Web Vitals时，使用
--no-cwv
参数加快审计速度
当需要修复多个问题时，将任务拆分为并行子任务
修复完成后运行类型检查和格式化（如tsc、eslint、prettier等）

Website Discovery

网站发现

If the user doesn't provide a website to audit:

Check for local dev server configurations (package.json scripts, .env files)
Look for Vercel/Netlify project links
Check environment variables for deployment URLs
Ask the user which URL to audit

If you have both local and live websites available, suggest auditing the live site for accurate results.

如果用户未提供要审计的网站：

检查本地开发服务器配置（package.json脚本、.env文件）
查找Vercel/Netlify项目链接
检查环境变量中的部署URL
询问用户要审计的URL

如果同时有本地和在线网站可选，建议审计在线网站以获取准确结果。

Basic Workflow

基础工作流

bash

undefined

bash

undefined

Quick single-page audit with LLM output

快速单页审计，生成LLM优化输出

seomator audit https://example.com --format llm --no-cwv

Multi-page crawl (up to 50 pages)

多页面抓取审计（最多50页）

seomator audit https://example.com --crawl -m 50 --format llm --no-cwv

Full audit with Core Web Vitals

包含Core Web Vitals的完整审计

seomator audit https://example.com --crawl -m 20 --format llm

undefined

seomator audit https://example.com --crawl -m 20 --format llm

undefined

Advanced Options

高级选项

Force fresh crawl (ignore cache):

bash

seomator audit https://example.com --refresh --format llm

Resume interrupted crawl:

bash

seomator audit https://example.com --resume --format llm

Save HTML report for sharing:

bash

seomator audit https://example.com --format html -o report.html

Verbose output for debugging:

bash

seomator audit https://example.com --format llm -v

强制重新抓取（忽略缓存）：

bash

seomator audit https://example.com --refresh --format llm

恢复中断的抓取任务：

bash

seomator audit https://example.com --resume --format llm

保存HTML报告以便分享：

bash

seomator audit https://example.com --format html -o report.html

调试用详细输出：

bash

seomator audit https://example.com --format llm -v

Command Reference

命令参考

Audit Command Options

审计命令选项

Option	Alias	Description	Default
`--format <fmt>`	`-f`	Output format: console, json, html, markdown, llm	console
`--max-pages <n>`	`-m`	Maximum pages to crawl	10
`--crawl`		Enable multi-page crawl	false
`--refresh`	`-r`	Ignore cache, fetch fresh	false
`--resume`		Resume interrupted crawl	false
`--no-cwv`		Skip Core Web Vitals	false
`--verbose`	`-v`	Show progress	false
`--output <path>`	`-o`	Output file path
`--config <path>`		Config file path
`--save`		Save to ~/.seomator	false

选项	别名	描述	默认值
`--format <fmt>`	`-f`	输出格式：console、json、html、markdown、llm	console
`--max-pages <n>`	`-m`	最大抓取页面数	10
`--crawl`		启用多页面抓取	false
`--refresh`	`-r`	忽略缓存，重新获取内容	false
`--resume`		恢复中断的抓取任务	false
`--no-cwv`		跳过Core Web Vitals测量	false
`--verbose`	`-v`	显示进度信息	false
`--output <path>`	`-o`	输出文件路径
`--config <path>`		配置文件路径
`--save`		保存到~/.seomator目录	false

Other Commands

其他命令

bash

seomator init              # Create config file
seomator self doctor       # Check system setup
seomator config --list     # Show all config values
seomator report --list     # List past reports
seomator db stats          # Show database statistics

bash

seomator init              # 创建配置文件
seomator self doctor       # 检查系统环境
seomator config --list     # 显示所有配置值
seomator report --list     # 列出历史报告
seomator db stats          # 显示数据库统计信息

Output Formats

输出格式

Format	Flag	Best For
console	`--format console`	Human terminal output (default)
json	`--format json`	CI/CD, programmatic processing
html	`--format html`	Standalone reports, sharing
markdown	`--format markdown`	Documentation, GitHub
llm	`--format llm`	AI agents (recommended)

The

--format llm

output is a compact XML format optimized for token efficiency:

50-70% smaller than JSON output
Issues sorted by severity (critical first)
Fix suggestions included for each issue
Clean stdout for piping to AI tools

格式	参数	最佳使用场景
console	`--format console`	终端人类可读输出（默认）
json	`--format json`	CI/CD、程序化处理
html	`--format html`	独立报告、分享
markdown	`--format markdown`	文档、GitHub
llm	`--format llm`	AI Agent（推荐）

--format llm

输出是经过token效率优化的紧凑XML格式：

比JSON输出小50-70%
按严重程度排序问题（严重问题优先）
每个问题都包含修复建议
干净的标准输出，可直接管道到AI工具

Examples

示例

Example 1: Quick Audit with LLM Output

示例1：快速审计并生成LLM输出

bash

undefined

bash

undefined

User asks: "Check example.com for SEO issues"

用户提问："检查example.com的SEO问题"

seomator audit https://example.com --format llm --no-cwv

undefined

seomator audit https://example.com --format llm --no-cwv

undefined

Example 2: Deep Crawl for Large Site

示例2：大型网站深度抓取审计

bash

undefined

bash

undefined

User asks: "Do a thorough audit with up to 100 pages"

用户提问："对网站进行全面审计，最多抓取100页"

seomator audit https://example.com --crawl -m 100 --format llm --no-cwv

undefined

seomator audit https://example.com --crawl -m 100 --format llm --no-cwv

undefined

Example 3: Fresh Audit After Changes

示例3：修改后重新审计（忽略缓存）

bash

undefined

bash

undefined

User asks: "Re-audit the site, ignore cached results"

用户提问："重新审计网站，忽略缓存结果"

seomator audit https://example.com --refresh --format llm --no-cwv

undefined

seomator audit https://example.com --refresh --format llm --no-cwv

undefined

Example 4: Generate Shareable Report

示例4：生成可分享的报告

bash

undefined

bash

undefined

User asks: "Create an HTML report I can share"

用户提问："创建一个我可以分享的HTML报告"

seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html

undefined

seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html

undefined

Evaluating Results

结果评估

Score Ranges

评分范围

Score	Grade	Meaning
90-100	A	Excellent - Minor optimizations only
80-89	B	Good - Address warnings
70-79	C	Needs Work - Priority fixes required
50-69	D	Poor - Multiple critical issues
0-49	F	Critical - Major problems to resolve

分数	等级	含义
90-100	A	优秀 - 仅需少量优化
80-89	B	良好 - 需处理警告问题
70-79	C	有待改进 - 需优先修复问题
50-69	D	较差 - 存在多个严重问题
0-49	F	危急 - 需解决重大问题

Priority Order (by category weight)

优先级排序（按分类权重）

Fix issues in this order for maximum impact:

Core Web Vitals (11%) - User experience + ranking
Links (9%) - Internal linking structure
Images (9%) - Performance + accessibility
Security (9%) - Trust signals
Meta Tags (8%) - Search visibility
Technical SEO (8%) - Crawling foundation
Structured Data (5%) - Rich snippets
Accessibility (5%) - WCAG compliance
Performance (5%) - Static optimization
Content (5%) - Text quality

按以下顺序修复问题以获得最大效果：

核心网页指标（Core Web Vitals）（11%）- 用户体验 + 排名影响
链接（9%）- 内部链接结构
图片（9%）- 性能 + 可访问性
安全（9%）- 信任信号
元标签（8%）- 搜索可见性
技术SEO（8%）- 抓取基础
结构化数据（5%）- 富文本摘要
可访问性（5%）- WCAG合规
性能（5%）- 静态资源优化
内容（5%）- 文本质量

Fix by Severity

按严重程度修复

Failures (status: "fail") - Must fix immediately
Warnings (status: "warn") - Should fix soon
Passes (status: "pass") - No action needed

失败（状态："fail"） - 必须立即修复
警告（状态："warn"） - 应尽快修复
通过（状态："pass"） - 无需操作

Output Summary

输出总结

After implementing fixes, give the user a summary of all changes made.

When planning scope, organize tasks so they can run concurrently as sub-agents to speed up implementation.

修复完成后，向用户提供所有修改的总结。

规划任务范围时，将任务拆分为可并行执行的子任务，由子Agent处理以加快实施速度。

Troubleshooting

故障排除

seomator command not found

seomator命令未找到

If you see this error, seomator is not installed or not in your PATH.

Solution:

bash

npm install -g @seomator/seo-audit

如果出现此错误，说明seomator未安装或未添加到PATH中。

解决方案：

bash

npm install -g @seomator/seo-audit

Core Web Vitals not measured

核心网页指标（Core Web Vitals）未测量

If CWV metrics are missing, Chrome/Chromium may not be available.

Solution:

Install Chrome, Chromium, or Edge
Run
```
seomator self doctor
```
to verify browser detection
Use
```
--no-cwv
```
to skip CWV if not needed

如果缺少CWV指标，可能是系统中没有Chrome/Chromium浏览器。

解决方案：

安装Chrome、Chromium或Edge浏览器
运行
```
seomator self doctor
```
验证浏览器检测情况
如果不需要CWV指标，使用
```
--no-cwv
```
参数跳过

Crawl timeout or slow performance

抓取超时或性能缓慢

For large sites, audits may take several minutes.

Solution:

Use
```
--verbose
```
to see progress
Limit pages with
```
-m 20
```
for faster results
Use
```
--no-cwv
```
to skip browser-based measurements

对于大型网站，审计可能需要数分钟时间。

解决方案：

使用
```
--verbose
```
参数查看进度
使用
```
-m 20
```
限制抓取页面数以加快结果返回
使用
```
--no-cwv
```
参数跳过基于浏览器的测量

Invalid URL

URL无效

Ensure the URL includes the protocol:

bash

undefined

确保URL包含协议：

bash

undefined

Wrong

错误示例

seomator audit example.com

Correct

正确示例

seomator audit https://example.com

undefined

seomator audit https://example.com

undefined

How It Works

工作原理

Fetch: Downloads the page HTML and measures response time
Parse: Extracts DOM, meta tags, links, images, structured data
Crawl (if enabled): Discovers and fetches linked pages
Analyze: Runs 134 audit rules against each page
Score: Calculates category and overall scores
Report: Generates output in requested format

Results are stored in

~/.seomator/

for later retrieval with

seomator report

获取内容：下载页面HTML并测量响应时间
解析：提取DOM、元标签、链接、图片、结构化数据
抓取（如果启用）：发现并获取链接页面内容
分析：对照134条审计规则分析每个页面
评分：计算各分类及整体评分
报告：生成指定格式的输出

结果会存储在

~/.seomator/

目录中，可通过

seomator report

命令检索历史报告。

Resources

资源

Full rules reference: See
```
docs/SEO-AUDIT-RULES.md
```
for all 134 rules
Storage architecture: See
```
docs/STORAGE-ARCHITECTURE.md
```
for database details

CLI help:

seomator --help

and

seomator <command> --help

完整规则参考：查看
```
docs/SEO-AUDIT-RULES.md
```
获取全部134条规则
存储架构：查看
```
docs/STORAGE-ARCHITECTURE.md
```
了解数据库细节

CLI帮助：

seomator --help

和

seomator <command> --help

seo-audit

Original

Translation

SEO Audit Skill

SEO审计技能

Links

链接

What This Skill Does

本技能的功能

When to Use

使用场景

Prerequisites

前置条件

Installation

安装步骤

Verify Installation

验证安装

Setup

配置步骤

Usage

使用方法

AI Agent Best Practices

AI Agent最佳实践

Website Discovery

网站发现

Basic Workflow

基础工作流

Quick single-page audit with LLM output

快速单页审计，生成LLM优化输出

Multi-page crawl (up to 50 pages)

多页面抓取审计（最多50页）

Full audit with Core Web Vitals

包含Core Web Vitals的完整审计

Advanced Options

高级选项

Command Reference

命令参考

Audit Command Options

审计命令选项

Other Commands

其他命令

Output Formats

输出格式

Examples

示例

Example 1: Quick Audit with LLM Output

示例1：快速审计并生成LLM输出

User asks: "Check example.com for SEO issues"

用户提问："检查example.com的SEO问题"

Example 2: Deep Crawl for Large Site

示例2：大型网站深度抓取审计

User asks: "Do a thorough audit with up to 100 pages"

用户提问："对网站进行全面审计，最多抓取100页"

Example 3: Fresh Audit After Changes

示例3：修改后重新审计（忽略缓存）

User asks: "Re-audit the site, ignore cached results"

用户提问："重新审计网站，忽略缓存结果"

Example 4: Generate Shareable Report

示例4：生成可分享的报告

User asks: "Create an HTML report I can share"

用户提问："创建一个我可以分享的HTML报告"

Evaluating Results

结果评估

Score Ranges

评分范围

Priority Order (by category weight)

优先级排序（按分类权重）

Fix by Severity

按严重程度修复

Output Summary

输出总结

Troubleshooting

故障排除

seomator command not found

seomator命令未找到

Core Web Vitals not measured

核心网页指标（Core Web Vitals）未测量

Crawl timeout or slow performance

抓取超时或性能缓慢

Invalid URL