🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

GEO Site Readiness Audit

by @geoly-geo

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

Versionv1.0.1
Downloads1,175
TERMINAL
clawhub install geo-site-audit

πŸ“– About This Skill


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  [--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
  • πŸ’‘ Examples

    To audit a website:

    python scripts/geo_audit.py  [--output json|md|html]
    

    Example:

    python scripts/geo_audit.py example.com --output md
    

    πŸ“‹ Tips & Best Practices

    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