geo/aeoplaybooks
Check your visibility →
Free · no key · build on it

Build on the AI-visibility checker

The same engine behind the free checker is open to build on: a plain JSON API, an MCP server for agents, an npm CLI + GitHub Action to gate your CI, an embeddable score widget, and a browser extension. No API key, no signup — attribute your calls with a source field so we can see what's useful.

1 · Cached score lookup — GET /api/score

Reads the stored score for a host (no live probe, CORS-open, cached 5 min). Ideal for dashboards, overlays and the widget — high frequency, no rate-limit pain. Returns found:false for hosts never checked.

curl "https://geoplaybooks.com/api/score?host=github.com"
# -> {"ok":true,"found":true,"host":"github.com","score":80,"band":"strong",...}

2 · Full 5-signal audit — POST /api/check

Runs the live 5-signal probe (crawler reachability, robots.txt, llms.txt, JSON-LD schema, answer-first structure) and returns the scored result with per-check findings. Rate-limited to 20 / 10 min / IP. Pass a source for attribution.

curl -X POST https://geoplaybooks.com/api/check \
  -H "content-type: application/json" \
  -d '{"domain":"example.com","source":"api"}'
# -> {"ok":true,"score":33,"band":"invisible","verdict":"...","checks":[...]}

3 · CLI & CI gate — npx @geoplaybooks/geo-check

Zero-dependency Node CLI (18+). Pretty output, --json, and a --min gate that exits non-zero when a site drops below a score — drop it into any pipeline.

npx @geoplaybooks/geo-check example.com
npx @geoplaybooks/geo-check example.com --min 60   # exit 1 if below 60 (CI gate)

As a GitHub Action:

- uses: xpressmike/geo-check-action@v1
  with:
    domain: example.com
    min-score: "60"

4 · Embeddable score widget

Drop one script tag on any page to render a live score card (uses /api/score). Omit data-host to score the embedding page's own domain; add data-theme="light" for light mode. No dependencies, never blocks your page.

<script src="https://geoplaybooks.com/geo-widget.js"
        data-host="example.com" async></script>

5 · MCP server for agents — /mcp

Seven tools over Streamable-HTTP JSON-RPC: live audits, fix-it briefs, llms.txt linting, playbook search & reading, the Pulse benchmark, and paid SOV sampling. One command to add to Claude Code, Cursor or ChatGPT.

claude mcp add --transport http geoplaybooks https://geoplaybooks.com/mcp

Full MCP docs →

6 · GEO Lens browser extension

See any site's GEO score as you browse: audit the current page, scores next to Google results, and the domains AI answers cite on ChatGPT / Perplexity / Gemini. Built on this same API.

Chrome Web Store link — coming soon. Meanwhile the source loads unpacked from the repo.