SEO Audit Report
Run full SEO audits from your agent and get actionable, scored reports.
Quick Start
CODEBLOCK0
Commands
Full Audit
CODEBLOCK1
Crawls up to --depth pages from the starting URL.
Quick Check (single page)
CODEBLOCK2
Generate Report
CODEBLOCK3
What Gets Audited
Technical SEO
- - HTTPS enforcement and redirect chains
- Robots.txt presence and configuration
- Sitemap.xml detection and validation
- Canonical tag usage
- Mobile viewport meta tag
- Page load indicators (response time, content size)
- HTTP status codes across crawled pages
On-Page SEO
- - Title tag (presence, length, keyword usage)
- Meta description (presence, length, uniqueness)
- Heading hierarchy (H1-H6 structure)
- Image alt text coverage
- Internal/external link ratio
- Content length analysis
- Open Graph and Twitter Card tags
Content Quality Signals
- - Word count per page
- Heading-to-content ratio
- Duplicate title/description detection
- Thin content pages (<300 words)
Link Health
- - Broken internal links (4xx/5xx)
- Orphan pages (no internal links pointing to them)
- External link count and diversity
Scoring
Each audit category is scored 0-100:
| Score | Rating | Meaning |
|---|
| 90-100 | Excellent | No significant issues |
| 70-89 |
Good | Minor improvements possible |
| 50-69 | Fair | Notable issues to address |
| 0-49 | Poor | Critical issues found |
Overall score is a weighted average:
- - Technical: 35%
- On-Page: 35%
- Content: 15%
- Links: 15%
Report Format
Reports are markdown with:
- - Executive summary with overall score
- Category breakdowns with individual scores
- Prioritized issue list (Critical → Low)
- Specific fix recommendations per issue
- Comparison benchmarks
Advanced
See references/seo-checklist.md for the complete 50+ point checklist used in audits.
SEO审计报告
从您的智能体中运行完整的SEO审计，获取可操作、带评分的报告。
快速开始
bash
python3 scripts/seo_audit.py --url https://example.com
命令
完整审计
bash
python3 scripts/seo_audit.py --url https://example.com --depth 3
从起始URL开始，爬取最多--depth个页面。
快速检查（单页面）
bash
python3 scripts/seo_audit.py --url https://example.com/page --quick
生成报告
bash
python3 scripts/seo_audit.py --url https://example.com --output report.md
审计内容
技术SEO
- - HTTPS强制与重定向链
- Robots.txt存在性与配置
- Sitemap.xml检测与验证
- 规范标签使用情况
- 移动端视口meta标签
- 页面加载指标（响应时间、内容大小）
- 爬取页面的HTTP状态码
页面SEO
- - 标题标签（存在性、长度、关键词使用）
- Meta描述（存在性、长度、唯一性）
- 标题层级结构（H1-H6）
- 图片alt文本覆盖率
- 内链/外链比例
- 内容长度分析
- Open Graph与Twitter Card标签
内容质量信号
- - 每页字数
- 标题与内容比例
- 重复标题/描述检测
- 内容过少页面（<300字）
链接健康度
- - 失效内链（4xx/5xx）
- 孤立页面（无内链指向）
- 外链数量与多样性
评分标准
每个审计类别评分为0-100分：
良好 | 可进行小幅改进 |
| 50-69 | 一般 | 存在需解决的显著问题 |
| 0-49 | 较差 | 发现关键问题 |
总体评分为加权平均：
- - 技术：35%
- 页面：35%
- 内容：15%
- 链接：15%
报告格式
报告采用Markdown格式，包含：
- - 执行摘要及总体评分
- 各分类细分及单项评分
- 按优先级排列的问题列表（关键→低）
- 每个问题的具体修复建议
- 对比基准
进阶
完整审计中使用的50余项检查清单，请参阅references/seo-checklist.md。
