GEO Site Readiness Audit

Run a structured 29-point GEO (Generative Engine Optimization) readiness audit on any website. Checks AI accessibility, structured data, content citability,...

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 md

What 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 technical

Batch 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