seo-audit

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.