geo-auditlisted
Install: claude install-skill hashd1ve/geo-audit-skill
# GEO Audit
Diagnose whether AI search engines can **find, read, and cite** a website, then say
exactly what to change. Grounded in how ChatGPT Search actually works: it leans on
**Bing's index** plus OpenAI's crawlers, and **those crawlers do not execute
JavaScript** — so anything rendered client-side is invisible to them.
## The one non-obvious idea
**A no-JavaScript HTTP fetch (curl/urllib) shows exactly what the AI crawler sees.**
For GEO this is the correct instrument, not a limitation. Do **not** trust
`web_fetch`, a browser, or a classic-SEO tool that renders JavaScript to judge what
AI crawlers can read — they will show content the crawler never receives and give
false confidence. The bundled scanner fetches as `OAI-SearchBot` with no JS.
## Workflow
1. **Scope.** Get the domain. Ask for target queries/keywords and whether they have
server-log or Bing Webmaster access (only if the user wants the retrieval/
measurement depth — the scan works without them).
2. **Scan.** Run the scanner (standard library, no installs):
```bash
python3 scripts/geo_audit.py <domain> --sample 8 --json out.json --html report.html
```
It reads robots.txt (bot access), the sitemap (URL shape), and samples pages,
reporting per page: body word count, headings, `<p>` count, JSON-LD, and a
`js_only` verdict. Use `--pages /a,/b,/c` to audit specific URLs.
3. **Interpret** against the 3 blocks, **top-down — stop at the first failing block**
(fixing citability on pag