Busca com Inteligência Artificial
llms.txt funciona: o que o arquivo faz de verdade
llms.txt é um arquivo Markdown proposto para resumir um site a agentes de Inteligência Artificial. Ele não ranqueia no Google e não é requisito do ChatGPT. Funciona como convenção de documentação, opcional, e só ajuda se o conteúdo por trás já for rastreável.
Por que o arquivo virou produto
O arquivo llms.txt virou item de plugin, gerador e proposta de GEO mesmo sem ser requisito da Pesquisa Google nem da busca do ChatGPT. A pessoa que procura o termo costuma encontrar uma ferramenta para criar o arquivo, não uma explicação do que o arquivo decide e do que ele não decide.
A busca brasileira por geradores, tutoriais e checklists trata o arquivo como o próximo robots.txt: coloque na raiz e a Inteligência Artificial passa a citar o site. Essa analogia vende bem porque o nome parece familiar. Ela também é falsa no ponto que importa para quem quer ser encontrado: nem o Google nem a OpenAI listam o arquivo como condição de visibilidade.
Quem sente o problema na prática é a empresa que já ouviu falar de GEO e AEO e agora recebe a oferta de um arquivo mágico. O trabalho de uma agência de SEO continua sendo outro: site rastreável, conteúdo que responde a pergunta e medição no Search Console. O arquivo, se existir, é anexo. Não é o projeto.
O que este guia não promete
Ninguém documenta que um llms.txt aumenta cliques, impressões ou citações. Quem vender prazo de tráfego ou posição em resposta de IA está prometendo uma decisão que não é dele.
O que é llms.txt
- llms.txt
- llms.txt é um arquivo em Markdown, colocado na raiz do site ou num subcaminho, que resume o projeto e aponta para páginas em texto limpo para agentes de linguagem lerem sob demanda, segundo a proposta publicada em llmstxt.org.
A proposta nasceu em 2024 e ganhou uma revisão v2 depois de dois anos de adoção. O argumento original é simples: a página HTML mistura navegação, anúncio e JavaScript, a janela de contexto do modelo ainda não cabe o site inteiro, e um índice curto em Markdown reduz token gasto à toa. O arquivo não substitui o site. Ele aponta para o que o agente deveria abrir depois.
O uso mais pesado, na própria proposta, é documentação de software. Um agente de código abre o /docs/llms.txt, escolhe o tutorial e segue o link da versão .md daquela página. A mesma estrutura pode descrever um negócio, um currículo ou um curso. Isso é convenção de descoberta para agente, não sinal de ranking da Pesquisa Google.
A v2 registra que milhares de sites publicam o arquivo, que plataformas de documentação o geram sozinhas e que os próprios laboratórios de IA publicam o arquivo nas docs de desenvolvedor. Publicar nas docs próprias não é o mesmo que usar o arquivo para decidir o que aparece na busca do consumidor.
Em 30 segundos
llms.txt é um índice em Markdown para agentes. Não é um fator da Pesquisa Google e não é o robots.txt da Inteligência Artificial.
A especificação do arquivo
A especificação do arquivo é Markdown com ordem fixa, não XML nem JSON. O único trecho obrigatório é um título de primeiro nível com o nome do projeto ou do site. O resto é opcional e, se existir, segue uma sequência que um parser clássico também consegue ler.
O formato Markdown
O formato Markdown do llms.txt começa com o nome do site, pode trazer um resumo em citação e depois lista links com nota curta. A proposta descreve, nesta ordem: marca de ordem de bytes opcional, um H1 obrigatório, um blockquote com o resumo, parágrafos de detalhe sem novos títulos, e seções H2 cujas listas são os arquivos que o agente deve abrir.
# Nome do site
> Resumo curto do que o site cobre.
Notas de interpretação, se precisarem.
## Documentos
- [Guia principal](https://exemplo.com/guia.md): o que ler primeiro
## Optional
- [Material secundário](https://exemplo.com/extra.md)
A seção chamada Optional, por convenção, guarda o que o agente pode pular quando o contexto está curto. Cada item de lista leva um link em Markdown e, se fizer falta, dois-pontos e uma nota. A proposta também pede versões Markdown das páginas úteis ao agente, no mesmo endereço da página original com .md no fim, e recomenda rel="alternate" do tipo text/markdown mais rel="describedby" apontando para o llms.txt que cobre aquele caminho.
Onde o arquivo mora
O arquivo mora na raiz do site ou no subcaminho que ele descreve. /llms.txt cobre o domínio. /docs/llms.txt cobre o que está em /docs/. Se dois arquivos se aplicam, a proposta manda o agente usar o mais específico. Isso existe de propósito: quem só controla uma pasta em hospedagem compartilhada, como um projeto em GitHub Pages, não consegue gravar em /.well-known/.
O arquivo é público. Tudo que entrar nele pode ser lido por qualquer um, inclusive concorrente. Senha, dado de cliente, rascunho interno e número que a empresa não publicaria numa página comum não entram. Um resumo honesto e curto basta. Encher o arquivo com toda a árvore do site devolve o problema que a proposta queria evitar: contexto grande demais, cheio de página que o agente não precisava.
Teste da proposta
A própria especificação sugere um teste simples: entregar só o llms.txt a um agente e perguntar sobre o site. Se a resposta sair rasa ou errada, o arquivo não está fazendo o trabalho de índice. O defeito costuma ser link genérico, jargão sem nota ou ausência da versão Markdown da página apontada.
llms.txt vs robots.txt
- robots.txt
- robots.txt é o arquivo que diz aos rastreadores quais URLs eles podem acessar no site, usado sobretudo para gerir tráfego de rastreamento, e não é o mecanismo para esconder uma página do Google, segundo a introdução ao robots.txt do Google Search Central.
A proposta do llms.txt afirma, com todas as letras, que os dois arquivos convivem e não se substituem. robots.txt fala de acesso. sitemap.xml lista o que é indexável para buscador. llms.txt oferece um recorte curado para o agente ler na hora da pergunta. Um sitemap grande demais não cabe no contexto. Um robots.txt que bloqueia o rastreador impede o resumo de chegar a quem deveria lê-lo.
| Arquivo | Pergunta que ele responde | Quando é lido |
|---|---|---|
| robots.txt | Posso rastrear esta URL? | Em todo rastreamento automático respeitoso |
| sitemap.xml | Quais páginas o site quer no índice? | Quando o buscador consulta o mapa |
| llms.txt | Por onde um agente começa neste site? | Sob demanda, se o agente procurar o arquivo |
Uma página bloqueada no robots.txt ainda pode aparecer no Google se outro site apontar para ela, em geral sem descrição. Esconder de verdade pede noindex ou senha, não o llms.txt. Do outro lado, um llms.txt que aponta para URL bloqueada é um índice que manda o agente para uma porta fechada.
O Google e o llms.txt
A Pesquisa Google não usa o arquivo llms.txt para decidir o que exibir, inclusive nos recursos de IA generativa. O guia de otimização para IA generativa do Google Search Central coloca arquivos LLMS.txt e outras marcações especiais na lista do que você não precisa fazer.
Não é necessário criar novos arquivos legíveis por máquina, arquivos de texto de IA, marcações ou Markdown para aparecer na Pesquisa Google, incluindo os recursos de IA generativa, já que a própria Pesquisa Google não os usa.
A mesma página avisa que o Google pode descobrir, rastrear e indexar vários tipos de arquivo além de HTML. Isso não significa tratamento especial. Um llms.txt no índice é, no máximo, mais um documento público. Não é atalho para Visão Geral Criada por IA nem para o Modo IA.
O recado de fechamento do guia é direto: para a Pesquisa Google, ignore táticas como fragmentar o conteúdo, criar arquivos de texto de IA desnecessários (como llms.txt) ou buscar menções não autênticas. O que permanece é SEO de fundação: conteúdo único e útil, estrutura técnica clara, página indexada e elegível a snippet.
O que o Lighthouse checa
O Lighthouse trata o llms.txt como convenção emergente e opcional, não como requisito da Pesquisa. A documentação de auditoria de navegação por agentes do Chrome for Developers descreve o arquivo como um resumo em Markdown para modelos e agentes. Sem o arquivo, o agente pode gastar mais tempo para entender a estrutura do site.
O teste marca a página se o servidor devolver erro ao tentar ler o arquivo. Se o arquivo não existir e a resposta for 404, a auditoria sai como não aplicável, porque fornecer o arquivo é opcional neste momento. Traduzindo: ausência de llms.txt não é falha de SEO no Google. Erro 500 ao pedir o arquivo é que merece conserto, porque um agente que tentou ler bateu numa falha de servidor.
Duas portas do Google, dois recados
Search Central fala da Pesquisa, incluindo Visões Gerais e Modo IA: o arquivo não entra na decisão. Lighthouse fala de agente no navegador: o arquivo é um atalho opcional. Os dois textos são do ecossistema Google e não se contradizem. Confundi-los é o que alimenta a venda do gerador.
ChatGPT e o arquivo
A documentação de crawlers da OpenAI não lista o llms.txt como requisito para aparecer no ChatGPT. A página de bots descreve quatro agentes, cada um com um trabalho, e as configurações são independentes. O detalhe está na documentação de crawlers da OpenAI.
- OAI-SearchBot
- OAI-SearchBot é o rastreador que a OpenAI usa para mostrar sites nas respostas de busca do ChatGPT. Site que bloqueia esse bot no robots.txt não entra como fonte clicável, embora ainda possa aparecer como link de navegação. A configuração é independente da do GPTBot.
- OAI-SearchBot. É o rastreador da busca, descrito no bloco acima. Sem ele liberado, o site não entra como fonte clicável na resposta.
- GPTBot. Coleta conteúdo público que pode entrar no treinamento dos modelos. Bloquear o GPTBot pede para o conteúdo não treinar o modelo de fundação. Não é o controle da busca.
- ChatGPT-User. Visita páginas quando uma pessoa, no ChatGPT, dispara uma ação. Não é rastreamento automático e não decide se o site aparece na Busca. robots.txt pode não se aplicar a essas visitas.
- OAI-AdsBot. Valida páginas enviadas como anúncio no ChatGPT. Só visita URL submetida como anúncio e o dado não treina modelo de fundação.
A OpenAI recomenda, para quem quer aparecer na busca do ChatGPT, permitir o OAI-SearchBot no robots.txt e aceitar os intervalos de IP publicados. Ajuste no robots.txt pode levar cerca de 24 horas para o sistema reagir. Nenhum desses parágrafos pede um arquivo Markdown na raiz.
A OpenAI publica um llms.txt nas próprias docs de desenvolvedor. Isso confirma o uso que a proposta descreveu: índice para agente que está lendo documentação. Não confirma que o ChatGPT Search ranqueia quem tiver o arquivo. O caminho de citação ao vivo está no OAI-SearchBot, e o guia dedicado sobre como aparecer no ChatGPT cobre exatamente essa porta.
Onde o arquivo realmente serve
O arquivo realmente serve quando um agente precisa de um mapa curto para documentação densa. Biblioteca com dezenas de páginas de API, produto com guias técnicos, site de docs que já gera Markdown: aí o llms.txt reduz o custo de o agente achar o ponto de entrada. A proposta descreve esse uso como o mais pesado, e as integrações listadas são quase todas de plataforma de documentação.
Mintlify, GitBook, Yoast, AIOSEO e Wix passam a gerar o arquivo sozinhos. Isso explica por que tanta empresa acorda com um /llms.txt no ar sem ter pedido. Em muitos casos o arquivo é um resumo automático do que o CMS já sabia. Automático não é mentira por si. Automático vira problema quando o resumo inventa serviço, omite o que o site realmente faz ou aponta para URL que não existe.
- Documentação de produto ou API. O agente de código é o leitor natural. Um índice curto com links para a versão Markdown das páginas certas reduz volta no HTML.
- Site que já tem Markdown canônico. Se cada página útil já tem um
.mdao lado, o llms.txt só aponta. Sem a versão limpa, o índice promete um atalho que não existe. - Resumo honesto do que o negócio é. Um H1, um blockquote e três links para as páginas que realmente explicam o serviço. Cabe numa tela e não finge abrangência.
Fora desses casos, o arquivo é decoração técnica. Uma loja, uma clínica ou um escritório cujo site tem dez páginas institucionais já é pequeno o bastante para o agente ler a página. O gargalo deles quase nunca é falta de Markdown. É falta de indexação, de conteúdo que responda a busca ou de rastreamento liberado.
A própria Voh! não tem llms.txt, e este site é o exemplo do parágrafo acima. O que ele faz é a parte da proposta que não depende do arquivo: qualquer página responde em Markdown quando o agente pede com Accept: text/markdown, e o cabeçalho HTTP anuncia essa versão com rel="alternate". O mapa curto, num site deste tamanho, é o sitemap.
O que os geradores vendem
Os geradores vendem a ideia de que um arquivo resolve visibilidade em IA. A SERP de llms.txt está cheia de lista de ferramenta, plugin de WordPress e CMS que grava o arquivo no ar. O produto é fácil de demonstrar: um botão, um Markdown, uma URL nova. O efeito na busca não é demonstrável com a documentação pública dos buscadores.
Três sinais de que a oferta saiu do que as fontes primárias sustentam:
- Promessa de citação ou posição. Google e OpenAI escrevem o contrário: não há arquivo especial, não há garantia de primeira posição, e otimizar para IA generativa continua sendo SEO.
- Arquivo gerado com serviço que o site não oferece. Se o gerador copiar o menu errado ou completar com texto de modelo, o agente lê uma empresa que não existe. Isso é pior do que 404.
- Páginas novas só para variar a pergunta. Fabricar uma URL para cada forma de alguém perguntar à IA cai na política de abuso de conteúdo em escala do Google, descrita nas políticas de spam. Volume de página não aumenta relevância.
Um gerador pode ser inocente: o CMS já emite o arquivo e alguém só confere se o resumo está certo. O teste é o mesmo de qualquer página pública. Leia em voz alta. Se a frase não poderia estar no site, não pode estar no llms.txt.
Checklist do llms.txt
O checklist do llms.txt cabe numa tarde e não exige ferramenta paga. Ele mostra se o arquivo existe, se o rastreamento de busca está liberado e se o site sequer está no índice. Não vira o projeto de SEO. Só evita pagar por um arquivo que o servidor já entrega, ou achar que o arquivo substitui indexação.
-
Abra a URL do arquivo
No navegador, vá em
https://seudominio.com.br/llms.txt. 404 é ausência, e o Lighthouse trata ausência como opcional. 200 com texto é o arquivo no ar. 500 é defeito de servidor, e esse sim vale consertar na hora. - Leia o Markdown em voz alta Confira se o H1 é o nome real da empresa, se o resumo descreve o que o site faz e se cada link abre uma página que existe. Apague serviço inventado, superlativo e qualquer número sem fonte.
-
Confira o robots.txt dos bots de busca
Abra
/robots.txte procureOAI-SearchBot,GPTBote o Googlebot. Bloqueio do OAI-SearchBot tira o site da busca do ChatGPT. Bloqueio do Googlebot tira o site da Pesquisa. O llms.txt não reabre essa porta. -
Confira se o site está no índice
No Google, busque
site:seudominio.com.br. Zero resultado é problema de indexação, não de Markdown. No Search Console, a cobertura e o relatório de IA generativa mostram o que a Pesquisa já vê. Sem página indexada e elegível a snippet, recurso de IA do Google nem entra na conversa.
- O arquivo, se existir, é curto. Índice, não cópia do site. Links apontam para a página certa ou para a versão Markdown dela.
- Nada confidencial. O arquivo é tão público quanto a home.
- Nenhuma frase que o site não sustentaria. Gerador que completa sozinho precisa de revisão humana antes de ir ao ar.
Quando o SEO pesa mais
O SEO pesa mais quando o site tem volume de página, concorrente estabelecido e medição que precisa fechar todo mês. Conferir um arquivo Markdown cabe numa tarde. Decidir o que o Google deve rastrear, o que cada URL responde e o que o Search Console está mostrando de Visão Geral Criada por IA não cabe. Aí o arquivo deixa de ser o centro da conversa, e o trabalho volta a ser o de sempre: busca orgânica.
É esse o trabalho que a Voh! faz, e só ele: busca orgânica, sem Ads e sem rede social. O canal é um só, e ele vale para qualquer site que precise ser encontrado, do institucional à loja virtual, incluindo a criação do site quando ele ainda não existe. São três formas de começar, uma auditoria gratuita, um pacote de implementação com seis meses de acompanhamento e o SEO Mensal, que não exige fidelidade. O que entra em cada frente está descrito nos serviços de SEO. O diagnóstico vem sempre antes da proposta, porque orçar sem olhar o site é chute. E não existe garantia de posição: o algoritmo é do Google, e quem promete o contrário está prometendo uma decisão que não é dele. Para a história e o método, leia sobre a Voh!.
Se o que trava o site for indexação, conteúdo ou rastreamento, e não a ausência de um Markdown na raiz, Fale com a Voh!.
Os limites do llms.txt
Os limites do llms.txt aparecem no minuto em que alguém pede ao arquivo o que ele não foi desenhado para fazer. A seção existe para o resto do guia continuar crível.
- Você precisa de cliente nesta semana. Orgânico, com ou sem arquivo, não substitui um canal pago no curto prazo. O arquivo não acelera indexação.
- O site não está no Google. Sem índice e sem snippet, recurso de IA da Pesquisa nem considera a página. O Markdown na raiz não entra nessa conta.
- O robots.txt bloqueia o rastreador de busca. Googlebot ou OAI-SearchBot barrados vencem qualquer resumo. Liberar o bot certo vem antes de escrever o H1 do arquivo.
- A expectativa é posição em resposta de IA. Ninguém documenta esse efeito. Quem vender o contrário está vendendo uma decisão que pertence ao modelo, não ao arquivo.
- O site tem dez páginas e nenhum doc técnico. Um agente lê a home. O arquivo vira cerimônia. O tempo rende mais em title, conteúdo e Search Console.
Resumo em 10 pontos
- llms.txt é um índice Markdown para agentes, proposto em llmstxt.org.
- O único campo obrigatório é o nome do site num H1.
- O arquivo convive com robots.txt e sitemap. Não os substitui.
- A Pesquisa Google não usa o arquivo para ranking nem para IA generativa.
- O Lighthouse trata o arquivo como opcional. 404 não é falha de SEO.
- A OpenAI não pede o arquivo para citar o site na busca do ChatGPT.
- O que a OpenAI pede para busca é OAI-SearchBot liberado no robots.txt.
- O uso honesto é documentação densa, não atalho de GEO.
- Gerador que inventa serviço ou promete posição sai do que as fontes sustentam.
- Conferir cabe numa tarde: abrir a URL, ler o texto, ver o robots e checar o índice.
Se quiser saber o que especificamente está travando o seu site na busca, Fale com a Voh!: a análise volta por escrito, sem custo e em até 48h.