explaingit

lindahaviv/agentgeoscore

Analysis updated 2026-05-18

5PythonAudience · pm founderComplexity · 3/5LicenseSetup · moderate

TLDR

A tool that scores and grades any website for how visible it is to AI assistants like ChatGPT and Perplexity, then lists concrete fixes to improve it.

Mindmap

mindmap
  root((repo))
    What it does
      Scores site AI visibility
      Grades A to F
      Ranked fix list
    Tech stack
      Python
      FastAPI
      React
      TypeScript
    Use cases
      Audit website
      Compare competitor
      Test AI prompts
    Audience
      Founders
      Marketers
      Developers
    Categories
      Agent access
      Discoverability
      Structured data
      Content clarity

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check how well a website's content and structure can be found and cited by AI assistants.

USE CASE 2

Get a ranked list of concrete fixes with copy-paste HTML snippets to improve AI visibility.

USE CASE 3

Compare a site's AI-search readiness against a competitor's site side by side.

USE CASE 4

Generate test prompts to verify in ChatGPT, Perplexity, or Claude whether a site actually gets cited.

What is it built with?

PythonFastAPIReactTypeScriptTailwind

How does it compare?

lindahaviv/agentgeoscore1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencepm founderops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs both a Python/FastAPI backend and a Vite/React frontend running, some probes need optional API keys.

MIT lets you use, copy, modify, and distribute this code for any purpose, including commercial products, with only a copyright notice required.

In plain English

AgentGEOScore is a tool that scores and grades any website for how visible and citable it is to AI systems like ChatGPT, Perplexity, and Claude. The idea behind it is called Generative Engine Optimization, or GEO: as more people ask AI assistants questions instead of using a traditional search engine, ranking well on Google is no longer enough. A site also needs to be readable and trustworthy to AI crawlers so it gets mentioned in the answer. You paste in a URL and the tool checks around 40 individual signals, grouped into five categories: agent access, meaning whether AI bots can even reach and read the page, discoverability, such as having a sitemap and clean URLs, structured data, meaning machine readable markup that tells a computer what a page is about, content clarity, meaning clear headings and readable, sufficiently deep text, and citation probe, meaning whether real AI models actually cite the domain when asked. Each category is weighted and combined into a score from 0 to 100 with a letter grade from A to F. The report also gives a ranked list of fixes to try first, sample HTML snippets to copy, a side by side comparison against a competitor's URL, and a set of AI search test prompts with direct links to ChatGPT, Perplexity, Claude, and Google AI Mode, so a user can check the result themselves instead of only trusting the score. Under the hood, the backend is built with Python and FastAPI, and includes protections against outbound requests being tricked into hitting private or internal addresses. The frontend is built with React, TypeScript, and Tailwind. The project has an extensive automated test suite covering both backend and frontend code, plus accessibility checks. The license is MIT, so the code can be used, modified, and reused freely, including for commercial purposes.

Copy-paste prompts

Prompt 1
Explain what the five scoring categories in AgentGEOScore measure and why each one matters for AI visibility.
Prompt 2
Help me set up AgentGEOScore locally and run a scan against my own website.
Prompt 3
Show me how to add JSON-LD structured data to fix a low Structured Data score from this tool.
Prompt 4
Walk me through comparing my site against a competitor using AgentGEOScore's compare feature.

Frequently asked questions

What is agentgeoscore?

A tool that scores and grades any website for how visible it is to AI assistants like ChatGPT and Perplexity, then lists concrete fixes to improve it.

What language is agentgeoscore written in?

Mainly Python. The stack also includes Python, FastAPI, React.

What license does agentgeoscore use?

MIT lets you use, copy, modify, and distribute this code for any purpose, including commercial products, with only a copyright notice required.

How hard is agentgeoscore to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agentgeoscore for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.