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
   • seo-geo -- AI crawler access, llms.txt, citability, brand mention signals
   • seo-local -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (spawn when Local Service industry detected: brick-and-mortar, SAB, or hybrid business type)
   • seo-maps -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (spawn when Local Service detected AND DataForSEO MCP available)
5. Score -- aggregate into SEO Health Score (0-100)
6. 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)

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, spawn the seo-dataforseo agent alongside existing subagents to enrich the audit with live data: real SERP positions, backlink profiles with spam scores, on-page analysis (Lighthouse), business listings, and AI visibility checks (ChatGPT scraper, LLM mentions).

Error Handling