Radar de Citação em IAs
Hoje muita gente não pergunta mais pro Google: pergunta pro ChatGPT, pro Perplexity, pra Busca com IA do Google, e a IA responde recomendando marcas. Se a sua não aparece nessa resposta, você virou invisível pra quem está decidindo. Este sistema coloca a URL da sua página e faz duas coisas: mede se a IA te cita no seu setor, e te entrega o plano do que fazer pra passar a ser citado, já escrevendo parte do conteúdo pronto. É o mesmo que roda no meu Laboratório, em público.
O que resolve
Existem dois problemas, e o sistema resolve os dois juntos. Primeiro: descobrir a situação. Ele faz umas 30 perguntas de comprador (do tipo "qual a melhor empresa de X?") pras três IAs mais usadas e conta quantas vezes a sua marca aparece, quantas o concorrente aparece, e quais sites a IA usa como fonte no seu setor, o mapa de onde você precisa estar. Segundo: resolver. Ele lê a sua página e dá uma nota de "citabilidade" em 5 partes (o texto está no formato que a IA gosta de citar? tem pergunta e resposta? tem dado com fonte? o conteúdo aparece sem depender de programação?), monta a lista do que consertar em ordem de importância, e já escreve o rascunho do conserto, o resumo de abertura, o bloco de perguntas frequentes com a marcação técnica que a IA lê. Diagnóstico de graça é comum; o que quase ninguém entrega é o conserto. É essa a diferença aqui.
Os ingredientes
- O programa em si (a pasta com todo o código pronto, o "repositório", ou "repo"). É só baixar.
- Um programa que "enxerga" a página como um navegador de verdade (chama-se crawl4ai). Ele é preciso porque muita página só monta o conteúdo depois que o navegador roda uma programação por dentro, e os robôs da IA não rodam essa programação. Este ingrediente serve pra medir exatamente o que a IA vê e o que ela perde.
- Uma "chave de acesso" de uma IA (a sua), é o que autoriza o programa a escrever os rascunhos de conteúdo. Você pega no painel do fornecedor de IA e cola no arquivo de configuração.
- Um lugar na nuvem pra ele morar (um servidor barato), pra a ferramenta ficar no ar pros seus clientes usarem.
- O Claude Code pra instalar e ajustar. Nunca usou? O "01 · Instalação do zero" começa do zero absoluto.
.env.example) pra você preencher. A parte que escreve o conteúdo é trocável, se amanhã você quiser usar outro modelo de IA, muda uma linha de configuração, sem reescrever nada.Acesso liberado pra membro. O repo é privado no GitHub, amarrado ao seu login.
O modo de preparo
- Baixa a pasta do programa e abre ela no Claude Code.
- Instala o "enxergador" de páginas. São dois comandos que o Claude Code roda pra você: um baixa o crawl4ai, o outro baixa o navegador que ele usa por dentro. É uma vez só.
- Põe a sua chave de IA no arquivo de configuração (copia o modelo
.env.example, renomeia pra.enve cola a chave). Sem chave, a ferramenta ainda dá a nota e o plano, só não escreve os rascunhos. - Sobe no servidor do jeito que já vem pronto (ele expõe um endereço que a sua página do site chama por trás). O passo a passo está no arquivo de deploy dentro do repo.
- Roda numa página de teste, a sua mesmo, e confere: saiu a nota, saiu o plano, saíram os rascunhos. Deu certo? Tá no ar.
O que queimou
Os perrengues que você não passa de novo porque eu já passei:
- O robô da IA não roda JavaScript, e isso engana. Metade dos sites monta o conteúdo só depois que o navegador executa uma programação por dentro (o "JavaScript"). Pra um olho humano parece que está tudo lá; mas o robô da IA não roda essa programação, então ele não vê essa parte, e o que ele não vê, ele não cita. Descobrir isso de verdade exigiu comparar dois jeitos de baixar a página: o cru (como o robô vê) e o renderizado (como você vê). A diferença é o tanto que você está perdendo. O "parece que tá lá" mentia.
- Honestidade acima de cobertura. Se um dos motores de IA falha na hora de medir, o resultado dele vira "não medido", nunca "não aparece". É desonesto dizer que a marca sumiu quando na verdade foi a medição que caiu. Isso está cravado no código; o número que a ferramenta te dá é sempre verdadeiro.
- O conteúdo gerado é rascunho, sempre. A ferramenta escreve o resumo e as perguntas, mas rotula tudo como "rascunho, revise antes de publicar". Ela entrega a matéria-prima pronta; quem bate o martelo é você. IA que cospe texto autoritário e você publica no susto é como você vira o que está errado, aqui não.
- Programa novo demais reclama. Montei numa versão de Python muito recente e vários pedaços ainda não tinham "encaixe" pronto pra ela. Antes de sair instalando, o programa checa se tudo encaixa e avisa, você não descobre no meio do caminho.