Назад към всички

geo-site-audit

// 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 visibili

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namegeo-site-audit
descriptionRun 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 md

What Gets Audited

Four dimensions with 29 checkpoints total:

DimensionChecksFocus
AI Accessibility10Crawler access, llms.txt, performance
Structured Data11Schema markup validation
Content Citability7Answer formatting, entity clarity
Technical Setup7HTTPS, 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