Full Website SEO Audit
Process
- Fetch homepage: use
scripts/fetch_page.py to retrieve HTML
- Detect business type: analyze homepage signals per seo orchestrator
- Crawl site: follow internal links up to 500 pages, respect robots.txt
- Delegate to subagents (if available, otherwise run inline sequentially):
seo-technical -- robots.txt, sitemaps, canonicals, Core Web Vitals, security headersseo-content -- E-E-A-T, readability, thin content, AI citation readinessseo-schema -- detection, validation, generation recommendationsseo-sitemap -- structure analysis, quality gates, missing pagesseo-performance -- LCP, INP, CLS measurementsseo-visual -- screenshots, mobile testing, above-fold analysisseo-geo -- AI crawler access, llms.txt, citability, brand mention signals
- Score -- aggregate into SEO Health Score (0-100)
- 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 findingsACTION-PLAN.md: Prioritized recommendations (Critical > High > Medium > Low)screenshots/: Desktop + mobile captures (if Playwright available)
Scoring Weights
| Category |
Weight |
| Technical SEO |
22% |
| Content Quality |
23% |
| On-Page SEO |
20% |
| Schema / Structured Data |
10% |
| Performance (CWV) |
10% |
| AI Search Readiness |
10% |
| Images |
5% |
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
| Scenario |
Action |
| URL unreachable (DNS failure, connection refused) |
Report the error clearly. Do not guess site content. Suggest the user verify the URL and try again. |
| robots.txt blocks crawling |
Report which paths are blocked. Analyze only accessible pages and note the limitation in the report. |
| Rate limiting (429 responses) |
Back off and reduce concurrent requests. Report partial results with a note on which sections could not be completed. |
| Timeout on large sites (500+ pages) |
Cap the crawl at the timeout limit. Report findings for pages crawled and estimate total site scope. |
1---2name: seo-audit3description: Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to 7 specialists, generates health score. Use when user says "audit", "full SEO check", "analyze my site", or "website health check".4---56# Full Website SEO Audit78## Process9101. **Fetch homepage**: use `scripts/fetch_page.py` to retrieve HTML112. **Detect business type**: analyze homepage signals per seo orchestrator123. **Crawl site**: follow internal links up to 500 pages, respect robots.txt134. **Delegate to subagents** (if available, otherwise run inline sequentially):14 - `seo-technical` -- robots.txt, sitemaps, canonicals, Core Web Vitals, security headers15 - `seo-content` -- E-E-A-T, readability, thin content, AI citation readiness16 - `seo-schema` -- detection, validation, generation recommendations17 - `seo-sitemap` -- structure analysis, quality gates, missing pages18 - `seo-performance` -- LCP, INP, CLS measurements19 - `seo-visual` -- screenshots, mobile testing, above-fold analysis20 - `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals215. **Score** -- aggregate into SEO Health Score (0-100)226. **Report** -- generate prioritized action plan2324## Crawl Configuration2526```27Max pages: 50028Respect robots.txt: Yes29Follow redirects: Yes (max 3 hops)30Timeout per page: 30 seconds31Concurrent requests: 532Delay between requests: 1 second33```3435## Output Files3637- `FULL-AUDIT-REPORT.md`: Comprehensive findings38- `ACTION-PLAN.md`: Prioritized recommendations (Critical > High > Medium > Low)39- `screenshots/`: Desktop + mobile captures (if Playwright available)4041## Scoring Weights4243| Category | Weight |44|----------|--------|45| Technical SEO | 22% |46| Content Quality | 23% |47| On-Page SEO | 20% |48| Schema / Structured Data | 10% |49| Performance (CWV) | 10% |50| AI Search Readiness | 10% |51| Images | 5% |5253## Report Structure5455### Executive Summary56- Overall SEO Health Score (0-100)57- Business type detected58- Top 5 critical issues59- Top 5 quick wins6061### Technical SEO62- Crawlability issues63- Indexability problems64- Security concerns65- Core Web Vitals status6667### Content Quality68- E-E-A-T assessment69- Thin content pages70- Duplicate content issues71- Readability scores7273### On-Page SEO74- Title tag issues75- Meta description problems76- Heading structure77- Internal linking gaps7879### Schema & Structured Data80- Current implementation81- Validation errors82- Missing opportunities8384### Performance85- LCP, INP, CLS scores86- Resource optimization needs87- Third-party script impact8889### Images90- Missing alt text91- Oversized images92- Format recommendations9394### AI Search Readiness95- Citability score96- Structural improvements97- Authority signals9899## Priority Definitions100101- **Critical**: Blocks indexing or causes penalties (fix immediately)102- **High**: Significantly impacts rankings (fix within 1 week)103- **Medium**: Optimization opportunity (fix within 1 month)104- **Low**: Nice to have (backlog)105106## DataForSEO Integration (Optional)107108If 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).109110## Error Handling111112| Scenario | Action |113|----------|--------|114| URL unreachable (DNS failure, connection refused) | Report the error clearly. Do not guess site content. Suggest the user verify the URL and try again. |115| robots.txt blocks crawling | Report which paths are blocked. Analyze only accessible pages and note the limitation in the report. |116| Rate limiting (429 responses) | Back off and reduce concurrent requests. Report partial results with a note on which sections could not be completed. |117| Timeout on large sites (500+ pages) | Cap the crawl at the timeout limit. Report findings for pages crawled and estimate total site scope. |
luokai0