CLI e toolkit Python open source que avaliam de 0 a 100 o preparo de um site para mecanismos de respostas com IA e geram correções para citações no ChatGPT, Perplexity, Gemini e Google AI Overviews.
jianruntech/geo-score
Pontuação grátis de 0 a 100 que mede se mecanismos de resposta com IA conseguem acessar, interpretar e citar um site, com rastreamento opcional de citações usando suas próprias chaves de API.
- Estrelas
- 320
- Forks
- 12
- Issues abertas
- 0
- Último commit
- há 13 horas
O que é?
geo-score atribui a um site uma pontuação de 0 a 100 que indica se mecanismos de resposta com IA, como ChatGPT, Perplexity e Gemini, conseguem acessá-lo, interpretar seu conteúdo, confiar nele e citá-lo. A pontuação é calculada com base em uma rubrica publicada e versionada, com 21 verificações distribuídas em cinco pilares, além de três critérios que limitam o resultado quando um crawler não consegue acessar o conteúdo. Não precisa de chave de API nem de dependências instaladas além da biblioteca padrão do Python.
Com suas próprias chaves de OpenAI, Perplexity, Gemini, Anthropic ou OpenRouter, a ferramenta também pode fazer uma pergunta aos mecanismos e informar quais fontes são citadas nas respostas. O modo de monitoramento executa um conjunto fixo de perguntas em intervalos programados e informa as taxas de citação, a participação nas respostas e as mudanças entre execuções. Esses resultados de citações aparecem junto da pontuação e nunca são incorporados a ela.
O projeto está disponível como CLI, GitHub Action, servidor MCP para agentes e skill do Claude Code. Ele gera relatórios em texto, JSON, SARIF e JUnit.
Recursos principais
- 01Atribui ao site uma pontuação de 0 a 100 em cinco dimensões: acessibilidade, facilidade de interpretação, possibilidade de citação do conteúdo, credibilidade da marca e adequação à resposta.
- 02Funciona sem chave de API e usando apenas a biblioteca padrão do Python.
- 03Faz uma pergunta ao ChatGPT, Perplexity, Gemini e Claude e informa as fontes citadas.
- 04O modo de monitoramento acompanha um conjunto fixo de perguntas semana após semana, com intervalos de confiança.
- 05Disponível como CLI, GitHub Action, servidor MCP e skill do Claude Code.
Casos de uso
- Verificar se crawlers de busca com IA conseguem acessar e ler o site de uma empresa antes de reformular o conteúdo.
- Adicionar uma verificação de pontuação de prontidão ao CI para que os builds falhem quando o site apresentar regressões.
- Acompanhar ao longo do tempo a frequência com que mecanismos de IA citam uma marca em comparação com concorrentes identificados.
- Permitir que um agente de IA audite um site pelo servidor MCP.
Início rápido
- 1
Instale a versão fixada do PyPI
pip install geo-score==1.8.3 - 2
Avalie um site (grátis, sem necessidade de chave de API)
geo_score.py stripe.com
Antes de usar
- As verificações de citações dos níveis 2 e 3 exigem suas próprias chaves de API com busca habilitada para cada mecanismo de IA.
- Os relays de patrocinadores não foram testados para medições de citações e podem não encaminhar a busca na web e as citações sem alterações.
- As pontuações medem a prontidão segundo uma rubrica definida pelo projeto, não um efeito mensurado nas citações de IA.
Tópicos
Perguntas frequentes
- O que é geo-score?
- Pontuação grátis de 0 a 100 que mede se mecanismos de resposta com IA conseguem acessar, interpretar e citar um site, com rastreamento opcional de citações usando suas próprias chaves de API. geo-score atribui a um site uma pontuação de 0 a 100 que indica se mecanismos de resposta com IA, como ChatGPT, Perplexity e Gemini, conseguem acessá-lo, interpretar seu conteúdo, confiar nele e citá-lo. A pontuação é calculada com base em uma rubrica publicada e versionada, com 21 verificações distribuídas em cinco pilares, além de três critérios que limitam o resultado quando um crawler não consegue acessar o conteúdo. Não precisa de chave de API nem de dependências instaladas além da biblioteca padrão do Python.
- geo-score é gratuito? Qual é a licença?
- geo-score é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- geo-score ainda é mantido?
- Manutenção ativa. O último commit de geo-score foi em 19 de out. de 2026.
- Para que posso usar geo-score?
- Verificar se crawlers de busca com IA conseguem acessar e ler o site de uma empresa antes de reformular o conteúdo. Adicionar uma verificação de pontuação de prontidão ao CI para que os builds falhem quando o site apresentar regressões. Acompanhar ao longo do tempo a frequência com que mecanismos de IA citam uma marca em comparação com concorrentes identificados. Permitir que um agente de IA audite um site pelo servidor MCP.
- Como instalar geo-score?
- Instale a versão fixada do PyPI: pip install geo-score==1.8.3 Avalie um site (grátis, sem necessidade de chave de API): geo_score.py stripe.com
- Onde consigo geo-score?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jianruntech/geo-score
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Plataforma de AEO self-hosted e voltada a agentes que monitora a visibilidade da marca em mecanismos de respostas com IA, junto com dados de busca, tráfego e integridade do site.
Uma skill do Claude Code que audita a visibilidade de sites em mecanismos de busca com IA, como ChatGPT, Perplexity e Google AI Overviews, além de fazer verificações clássicas de SEO.
Plataforma open source para acompanhar como as marcas aparecem nas respostas de buscas com IA no ChatGPT, Gemini, Claude, Perplexity e outros mecanismos.
Plugin open source de análise de SEO para Claude Code, com auditorias paralelas de SEO técnico, E-E-A-T, Schema.org e otimização para buscas com IA.
Uma CLI e camada de skills que instala, configura e verifica canais para que agentes de IA possam ler e pesquisar no Twitter, Reddit, YouTube, Bilibili, XiaoHongShu e outras plataformas.