SEO Audit
Production-grade SEO audit framework with an 85-point checklist across 8 dimensions, severity-weighted scoring, automated diagnostic workflows, and prioritized remediation plans. Covers technical SEO, on-page optimization, content quality, competitive positioning, and migration readiness.
Core Capabilities
- 85-point checklist across 8 dimensions — crawlability, indexation, Core Web Vitals, on-page, content quality, infrastructure, off-page, analytics
- Severity-weighted scoring — Critical/High/Medium/Low multipliers roll up to an A–F health grade
- Diagnostic deep dives — CWV optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization & intent matching, E-E-A-T and AI-content detection
- Competitive gap analysis — your site vs. 3 competitors across technical and content dimensions
- Prioritized remediation — P0–P4 priority framework, fix-list template, and migration checklists
When to Use
Pick the operating mode that matches the situation:
- Full Site Audit — comprehensive audit across all 8 dimensions; use for initial assessment or annual reviews.
- Focused Audit — single-dimension deep dive when the problem area is already identified (e.g., failing Core Web Vitals, indexation issues).
- Pre-Migration Audit — for planned URL changes, platform switches, or redesigns; establishes baseline and redirect mapping.
- Traffic Drop Diagnosis — emergency diagnostic when organic traffic drops; follows the traffic-drop decision tree to isolate cause.
Clarify First
Before auditing, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- [ ] Audit mode — full site, single-dimension focused, pre-migration, or traffic-drop diagnosis — sets scope and which of the 8 dimensions to run
- [ ] Site URL + available data — GSC, analytics, and crawl exports on hand — determines what can be verified vs. assumed in the findings
- [ ] Primary symptom or goal — e.g. ranking drop, indexation gap, failing Core Web Vitals — focuses the diagnostic deep-dives and remediation priority
- [ ] Competitor set — the 3 sites to benchmark against — drives the competitive gap analysis
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
# Check redirect chains and status codes
python scripts/redirect_checker.py --url https://example.com/old-page --json
# Analyze XML sitemap for errors
python scripts/sitemap_analyzer.py --sitemap https://example.com/sitemap.xml
# Score content quality for SEO
python scripts/content_scorer.py article.md --json
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/audit-checklist.md — initial scoping questions, the full 85-point checklist across all 8 dimensions, and the severity-weighted scoring formula. Read when starting an audit or scoring results.
- references/diagnostics-and-analysis.md — Core Web Vitals optimization stacks, indexation gap analysis, traffic-drop decision tree, cannibalization/intent scoring, AI-content & E-E-A-T detection, competitive gap framework. Read when diagnosing a specific problem area.
- references/remediation-and-migration.md — migration checklist (pre/during/post), P0–P4 remediation framework and plan template, output artifacts, troubleshooting table, and success criteria. Read when turning findings into an action plan.
Scope & Limitations
In scope: technical SEO across all 8 audit dimensions, severity-weighted scoring with prioritized remediation, traffic-drop diagnosis, competitive gap analysis, pre/post-migration checklists, AI content quality detection.
Out of scope: content creation or rewriting (use Content Creator), structured data implementation (use Schema Markup), site architecture redesign (use Site Architecture), link building execution, paid search audits, server/CDN provisioning.
Known limitations: field CWV data requires sufficient traffic for CrUX; off-page signals need third-party tools (Ahrefs, SEMrush); AI Overview impact on CTR varies by query type; Google's algorithm changes 500–600 times/year, so findings are point-in-time.
Integration Points
- AI SEO — run after audit to optimize for AI search citation alongside traditional findings.
- Schema Markup — use when audit reveals missing or broken structured data opportunities.
- Site Architecture — use when audit uncovers structural issues requiring architectural redesign.
- Content Humanizer — use when audit flags AI content detection signals on key pages.
- Content Strategy / programmatic-seo — use when audit reveals content gaps or keyword-gap clusters addressable at scale.