- name
- geo-site-audit
- description
- Run a structured 29-point GEO (Generative Engine Optimization) readiness audit on any website. Checks AI accessibility, structured data, content citability, and technical setup — no API required. Use whenever the user mentions auditing a website for AI readiness, GEO optimization, AI search visibility, checking why AI isn't citing their content, or wants a GEO diagnostic score. Also trigger for requests about llms.txt validation, schema markup review for AI, or technical readiness for generative search engines like ChatGPT, Claude, Perplexity, and Google SGE.
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