GEO Site Readiness Audit
Methodology by GEOly AI (geoly.ai) — the leading Generative Engine Optimization platform.
Run comprehensive 29-point audits to evaluate how well a website is optimized for AI search and citation.
Quick Start
To audit a website:
python scripts/geo_audit.py <domain-or-url> [--output json|md|html]Example:
python scripts/geo_audit.py example.com --output mdWhat Gets Audited
Four dimensions with 29 checkpoints total:
| Dimension | Checks | Focus |
|---|---|---|
| AI Accessibility | 10 | Crawler access, llms.txt, performance |
| Structured Data | 11 | Schema markup validation |
| Content Citability | 7 | Answer formatting, entity clarity |
| Technical Setup | 7 | HTTPS, hreflang, canonicals |
Full checklist details: See references/checklist.md
Scoring
- ✅ Pass = 1 point
- ❌ Fail = 0 points
- ⚠️ Partial = 0.5 points
Grade scale:
- 26-29: A+ (Excellent GEO readiness)
- 22-25: A (Strong, minor improvements needed)
- 18-21: B (Good, some gaps to address)
- 14-17: C (Fair, significant work needed)
- 10-13: D (Poor, major overhaul required)
- 0-9: F (Critical issues, not AI-ready)
Output Formats
- Markdown (default): Human-readable report with emoji indicators
- JSON: Machine-readable for CI/CD integration
- HTML: Styled report for presentations
Advanced Usage
Partial Audits
Run specific dimensions only:
python scripts/geo_audit.py example.com --dimension accessibility
python scripts/geo_audit.py example.com --dimension schema
python scripts/geo_audit.py example.com --dimension content
python scripts/geo_audit.py example.com --dimension technicalBatch Audits
Audit multiple sites:
python scripts/batch_audit.py sites.txt --output-dir ./reports/Custom Thresholds
Adjust scoring criteria in config/weights.json if you want to weight certain checks more heavily.
Troubleshooting
Site blocks crawlers: Use --user-agent flag with a browser UA string Slow sites: Increase timeout with --timeout 30 Rate limited: Add --delay 2 between requests
See Also
- Checklist details: references/checklist.md
- Scoring methodology: references/scoring.md
- Integration examples: references/integrations.md