| name | seo-audit |
| description | Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to 6 specialists, generates health score. Use when user says "audit", "full SEO check", "analyze my site", or "website health check".
|
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 analysis
- 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 | 25% |
| Content Quality | 25% |
| On-Page SEO | 20% |
| Schema / Structured Data | 10% |
| Performance (CWV) | 10% |
| Images | 5% |
| AI Search Readiness | 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)
