coopersimson96/ai-content-system/seo-audit

Full Website SEO Audit

Process

1. Fetch homepage — use scripts/fetch_page.py to retrieve HTML
2. Detect business type — analyze homepage signals per seo orchestrator
3. Crawl site — follow internal links up to 500 pages, respect robots.txt
4. Delegate to subagents (if available, otherwise run inline sequentially):

• seo-technical — robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
• seo-content — E-E-A-T, readability, thin content, AI citation readiness
• seo-schema — detection, validation, generation recommendations
• seo-sitemap — structure analysis, quality gates, missing pages
• seo-performance — LCP, INP, CLS measurements
• seo-visual — screenshots, mobile testing, above-fold analysis

1. Score — aggregate into SEO Health Score (0-100)
2. Report — generate prioritized action plan

Crawl Configuration

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

Output Files

• FULL-AUDIT-REPORT.md — Comprehensive findings
• ACTION-PLAN.md — Prioritized recommendations (Critical → High → Medium → Low)
• screenshots/ — Desktop + mobile captures (if Playwright available)

Scoring Weights

Report Structure

Executive Summary

• Overall SEO Health Score (0-100)
• Business type detected
• Top 5 critical issues
• Top 5 quick wins

Technical SEO

• Crawlability issues
• Indexability problems
• Security concerns
• Core Web Vitals status

Content Quality

• E-E-A-T assessment
• Thin content pages
• Duplicate content issues
• Readability scores

On-Page SEO

• Title tag issues
• Meta description problems
• Heading structure
• Internal linking gaps

Schema & Structured Data

• Current implementation
• Validation errors
• Missing opportunities

Performance

• LCP, INP, CLS scores
• Resource optimization needs
• Third-party script impact

Images

• Missing alt text
• Oversized images
• Format recommendations

AI Search Readiness

• Citability score
• Structural improvements
• Authority signals

Priority Definitions

• Critical: Blocks indexing or causes penalties (fix immediately)
• High: Significantly impacts rankings (fix within 1 week)
• Medium: Optimization opportunity (fix within 1 month)
• Low: Nice to have (backlog)