As IA recomendam-te a ti ou ao teu rival?

O que é e porque importa

Quando alguém pergunta ao ChatGPT «qual é a melhor app para…?», a resposta dá alguns nomes e muitas vezes cita sites como fonte. Se o teu nome não está lá, quem lê não te vê. E tu não sabes, porque ninguém te diz.

O Limelit Open serve para medir isso. Dás-lhe o teu site e até cinco rivais, e ele faz ao ChatGPT, Claude, Perplexity e Gemini as perguntas de um cliente, através das APIs deles e com a pesquisa web ligada. Depois conta quantas vezes apareces tu e quantas os rivais, em que posição, e que sites são citados. Tudo num painel no teu computador, que podes consultar a partir do Claude Code.

Duas coisas a saber já. É um projeto open source de terceiros, não meu, com licença Apache-2.0. E ainda está em pré-lançamento, ou seja, em teste: não há uma versão final. É para quem tem uma app, um SaaS ou um site: indie hackers, founders a solo, vibecoders.

1. O que mede, e o que não mede

Cada ronda guarda as respostas completas e procura nelas o teu nome e os dos rivais com uma simples pesquisa de texto: nenhum modelo decide o que viu, por isso cada número verifica-se à mão. Os números:

• Visibilidade: a percentagem de respostas que te nomeiam.
• Quota de voz (share of voice): as tuas menções sobre o total das marcas que segues.
• Posição: o lugar médio em que apareces quando a resposta é uma lista.
• Quota de citações: quantas fontes citadas são o teu site. Cada site citado é classificado: teu, de um rival, social, informativo, outro.
• As pesquisas que o motor fez antes de responder, que muitas vezes não são a pergunta que fizeste.

Cada número diz em quantas respostas se baseia (n), e abaixo de 20 o painel avisa-te. As perguntas que nomeiam a tua marca ficam fora do número principal: só mediriam a pergunta.

O limite mais importante

As respostas vêm das APIs dos modelos, com a pesquisa web ligada, e não são idênticas ao que uma pessoa vê na app do ChatGPT: o README di-lo claramente. Para medir o que as pessoas veem são precisos scrapers, serviços pagos que leem a página como um utilizador. O mesmo para o AI Overview e o AI Mode do Google e para o Copilot do Bing, que não têm API: ou um scraper, ou a versão alojada do Limelit. Toma os números como uma direção.

2. Instala-o e faz a primeira ronda

Corre em Mac ou Linux, é um único ficheiro e cria sozinho a sua base de dados SQLite. Não precisas de instalar nada antes. Abre o Terminal e cola:

mkdir -p ~/limelit && cd ~/limelit
curl -fsSL https://github.com/limelit-co/open/releases/latest/download/limelit_$(uname -s | tr A-Z a-z)_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz | tar xz limelit
./limelit serve

1. Abre http://localhost:1515 no navegador. O Terminal também mostra as linhas prontas para ligar o Claude Code, com os teus caminhos.
2. O assistente de configuração pede-te o domínio, depois a categoria, ou seja, a frase que um cliente usaria (por exemplo «app para aprender línguas»), e até cinco rivais.
3. Propõe-te as perguntas de partida, em inglês. Tira as que o teu cliente nunca faria e junta em baixo as tuas, uma por linha, também em português.
4. Último passo: uma chave para chegar aos motores. Há dois caminhos, estão na secção 3.
5. Carrega em Run: antes desse botão não se gasta nada. As respostas costumam chegar em menos de um minuto.

O meu conselho: as perguntas contam mais do que tudo o resto. Escreve-as como as escreveria um cliente que não te conhece: o que quer fazer, para quem, com que limitação. Uma base para adaptar:

Qual é a melhor app para [o que a tua app faz]?
Que app me recomendas para [problema] se [limitação, por exemplo: tenho pouco tempo]?
Há alguma app gratuita para [o que a tua app faz]?
Alternativas a [rival]?
Como escolho uma app para [o que a tua app faz]?

3. A chave: a gratuita ou as tuas

O assistente pede-te uma chave, ou seja, o código para usar as APIs dos motores. Dois caminhos:

• A chave gratuita. Entras com o Google no Limelit Cloud, crias a chave e colas no assistente (ou corres limelit login). Chega ao ChatGPT, Gemini, Perplexity e ao AI Overview e AI Mode do Google, dentro de uma quota mensal gratuita. Mas as tuas perguntas passam pelos servidores do Limelit Cloud para chegar aos motores; as respostas ficam contigo.
• As tuas chaves. A mais rápida é a da OpenAI, que abre o ChatGPT; para o Claude precisas da da Anthropic. Em Settings encontras cada fornecedor com o link para a página onde se cria a chave. Pagas aos fornecedores diretamente, às tarifas deles: o projeto não acrescenta custos seus.

Com as tuas chaves há um teto, runs_per_day, que mudas em Settings: uma ronda que o ultrapassasse é recusada antes de gastar. O Limelit conta também chamadas e tokens por motor e por dia.

Se deixares o limelit serve ligado, repete a ronda sozinho todos os dias ou de hora a hora: assim vês quem ganha dia a dia.

4. Liga-o ao Claude Code

O Limelit Open tem um servidor MCP, ou seja, uma porta que deixa o Claude ler os teus dados e responder-te por palavras, com os mesmos números do painel. No Terminal:

claude mcp add limelit -s user -- sh -c 'cd ~/limelit && exec ./limelit mcp'

-s user torna-o disponível em todos os teus projetos. Tem de arrancar a partir de ~/limelit para ler a mesma base de dados do painel: arrancado noutro sítio, abre uma vazia. Depois abre uma sessão nova do Claude Code e escreve /mcp: o limelit tem de aparecer ligado.

Não precisas de saber os nomes das ferramentas. Começa por aqui:

Vamos começar com o Limelit: em que ponto está a minha instalação e o que devo fazer agora?

O Claude diz-te em que ponto estás e o que fazer a seguir. Também pode lançar uma ronda: primeiro mostra-te o plano, e só arranca quando dizes que sim.

Ou com o plugin do Limelit

O repositório também é um marketplace de plugins para o Claude. No Claude Code escreve:

/plugin marketplace add limelit-co/open
/plugin install limelit-open@limelit

O limelit-open liga a tua instalação com a skill limelit-open-visibility-report. Há também o limelit-audit, sem instalação nem conta: o ai-crawler-check diz-te que crawlers de IA o teu robots.txt deixa entrar, o llms-txt-check verifica o teu llms.txt. Podem enviar o domínio para o verificador gratuito do Limelit.

5. As perguntas a fazer ao Claude Code sobre os teus rivais

Depois de ligado, estas são as perguntas que te recomendo. Troca as partes entre [ ] pelas tuas.

Em que perguntas estou a perder? Para cada uma diz-me que rival é nomeado no meu lugar, em que motor e em quantas respostas se baseia o número.

Nas respostas onde não apareço, que sites são citados? Dá-me os endereços exatos das páginas, por ordem de quantas vezes são citadas.

Para a pergunta «[pergunta]», que pesquisas fez o motor antes de responder? Que palavras usa que eu não uso no meu site?

Compara-me com [rival]: em que perguntas ganha ele, em quais ganho eu, e que sites citam as respostas que ele ganha. Se a amostra for pequena, diz-me antes de tirar conclusões.

6. O que fazer com os resultados

Estes são conselhos meus, não funções do Limelit: ele mede, o trabalho fazes tu.

• Entra nas páginas citadas. Se as respostas citam sempre o mesmo ranking «as melhores apps para…», essa página conta mais do que o teu site: escreve a quem a gere e apresenta a tua app.
• Escreve a página que responde à pergunta. Se perdes em «há alguma app gratuita para…?», faz uma página que responde exatamente a isso, com factos precisos.
• Faz uma página de comparação honesta. Para «alternativas a [rival]», explica quando compensa escolher-te e quando não.
• Usa as palavras do motor. Se as pesquisas dele usam palavras diferentes das tuas, põe-nas nos títulos das tuas páginas.
• Volta a medir passadas algumas semanas, não no dia seguinte: as respostas também mudam sozinhas.

Os erros mais comuns

• Encher a lista de perguntas que nomeiam a tua marca. Precisas de perguntas de um cliente que não te conhece.
• Tirar conclusões de poucas rondas. Olha para n: abaixo de 20 respostas é uma amostra pequena, não uma tendência.
• Esquecer que com a chave gratuita as perguntas passam pelo Limelit Cloud. Se não te convém, usa as tuas chaves.

Checklist

• o limelit serve está ligado e o painel abre em localhost:1515
• As perguntas são de cliente, e juntei as minhas na minha língua
• Escolhi a chave: a gratuita (passa pelo Limelit Cloud) ou as minhas
• Verifiquei o runs_per_day antes de ativar a ronda automática
• No Claude Code, o /mcp mostra o limelit ligado

Perguntas frequentes