Repolode
jianruntech

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. 1

    Instale a versão fixada do PyPI

    pip install geo-score==1.8.3
  2. 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