Repolode
Submit
Auriti-Labs

Auriti-Labs/geo-optimizer-skill

Open-source CLI and Python toolkit that scores a website 0–100 on AI answer-engine readiness and generates fixes for ChatGPT, Perplexity, Gemini and Google AI Overviews citations.

View on GitHubWebsite
Stars
1,123
Forks
126
Open issues
6
Last commit
yesterday

What is it?

GEO Optimizer audits how easily AI answer engines such as ChatGPT, Perplexity, Gemini, Claude and Google AI Overviews can crawl, parse and cite a website. A single command returns a 0–100 score across nine categories, including robots.txt access for 27 AI crawlers, llms.txt, JSON-LD schema, meta tags and content checks, along with a prioritized list of fixes.

The `geo fix` command previews generated robots.txt rules, llms.txt, schema and meta tags, and writes them only when run with `--apply`. Other commands sample real AI engines with your own API keys to check whether a brand or domain is mentioned or cited, track score history and drift, and gate CI builds on a score threshold.

The tool is available as a CLI, a Python library, an MCP server for clients such as Claude and Cursor, a GitHub Action, and an Astro build integration. It is MIT-licensed and written in Python.

Key features

  • 01Scores a site 0–100 across nine categories with prioritized fixes.
  • 02Checks robots.txt access for 27 AI crawlers.
  • 03Generates robots.txt rules, llms.txt, JSON-LD schema and meta tags, previewing before writing.
  • 04Queries AI engines with your own API keys to check brand mentions and citations.
  • 05Fails CI builds below a score threshold and can output SARIF.

Use cases

  • Checking whether a marketing or documentation site is readable by AI search engines.
  • Generating llms.txt and schema markup for a static site build.
  • Adding an AI-readiness score gate to a GitHub Actions pipeline.
  • Tracking how a brand appears in AI answers over time.

Quick start

  1. 1

    Run the audit with no install using uvx

    uvx --from geo-optimizer-skill geo audit --url https://yoursite.com
  2. 2

    Or install it with pip

    pip install -U geo-optimizer-skill
  3. 3

    Preview generated fixes (add --apply to write files)

    geo fix --url https://yoursite.com

Things to know

  • The citations command needs your own API key for AI providers such as Perplexity or OpenAI.
  • AI answers are not deterministic, so citation results vary between runs.
  • The score after fixes is only the tool's own estimate, not a measured result.

Topics

#seo#geo#aeo#llms-txt#json-ld#cli#python#ai-search#ai-search-optimization#ai-seo

FAQ

What is geo-optimizer-skill?
Open-source CLI and Python toolkit that scores a website 0–100 on AI answer-engine readiness and generates fixes for ChatGPT, Perplexity, Gemini and Google AI Overviews citations. GEO Optimizer audits how easily AI answer engines such as ChatGPT, Perplexity, Gemini, Claude and Google AI Overviews can crawl, parse and cite a website. A single command returns a 0–100 score across nine categories, including robots.txt access for 27 AI crawlers, llms.txt, JSON-LD schema, meta tags and content checks, along with a prioritized list of fixes.
Is geo-optimizer-skill free to use? What license does it have?
geo-optimizer-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is geo-optimizer-skill still maintained?
Actively maintained. The last commit to geo-optimizer-skill was on Oct 19, 2026.
What can I use geo-optimizer-skill for?
Checking whether a marketing or documentation site is readable by AI search engines. Generating llms.txt and schema markup for a static site build. Adding an AI-readiness score gate to a GitHub Actions pipeline. Tracking how a brand appears in AI answers over time.
How do I install geo-optimizer-skill?
Run the audit with no install using uvx: uvx --from geo-optimizer-skill geo audit --url https://yoursite.com Or install it with pip: pip install -U geo-optimizer-skill Preview generated fixes (add --apply to write files): geo fix --url https://yoursite.com
Where can I get geo-optimizer-skill?
The source code and installation instructions are on GitHub: https://github.com/Auriti-Labs/geo-optimizer-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects