Shopify Geo Audit MCP server

shopify-geo-audit

Audit any Shopify store for AI-search readiness, then generate the fixes you actually paste in.

npx shopify-geo-audit https://your-store.com

No account, no API key, no config. It fetches the storefront, runs a set of checks for the signals that ChatGPT, Perplexity, Gemini and Google's AI Overviews read, scores the store 0-100, and writes paste-ready fixes to ./geo-audit-output/.

Want it on your PATH instead of npx? npm i -g shopify-geo-audit.

Why I built this

I do a lot of Shopify work, and "are we showing up in AI answers?" became a real client question fast. The field goes by a pile of names — GEO, AEO, AI SEO, LLM SEO, answer engine optimization — but the question is the same: when someone asks ChatGPT or Perplexity for product recommendations, is your store citable? The existing tools mostly hand you a dashboard that says you're invisible and stop there. The useful part, the part that takes an afternoon by hand, is producing the actual structured data and config. So I wrote the thing that does that part.

It's deliberately small and offline. One command, runs locally, nothing leaves your machine except the requests to the store you're auditing.

What it checks

Nine checks, weighted by how much they matter for getting cited:

The result is an SRO Score (Search Readiness for AI): 80-100 strong, 50-79 needs work, below 50 at risk.

The premise — that deliberate changes to your pages measurably move how often engines cite you — comes from the original GEO paper (Aggarwal et al., KDD 2024), which measured visibility gains of up to ~40% from exactly this kind of work.

What it generates

The output isn't a report you read and forget. It's files:

• product-jsonld.html — a valid Product block filled from your store's real data, ready for your theme
• llms.txt — a content manifest for your domain
• robots-fixes.txt — the exact lines to stop blocking AI crawlers
• priority-list.txt — every failing check, ranked, each with a one-line fix

Pass --html and you also get a self-contained report.html you can screenshot or send a client:

Example

$ npx shopify-geo-audit https://acme-coffee.com

  ────────────────────────────────────────────────────────────

  Acme Coffee
  https://acme-coffee.com/

  SRO Score: 41/100  ■ AT RISK

  ────────────────────────────────────────────────────────────

Shortened. The full README is on GitHub.