O que é o arquivo llms.txt e para que serve?
Entende-se por llms.txt um arquivo de texto em Markdown, publicado na raiz do site ou em uma pasta, que lista as páginas mais úteis com uma descrição curta de cada uma. Agente de IA é um programa que consulta páginas e executa tarefas em nome de uma pessoa ou empresa. A proposta foi publicada por Jeremy Howard em 3 de setembro de 2024, e a versão 2 é de 10 de agosto de 2026.
O llms.txt organiza links e contexto para agentes que precisam consultar seu site. Ele pode ajudar quem mantém documentação ou informações empresariais extensas. Comece por um índice pequeno de páginas confiáveis e teste se o consumidor que você usa consegue lê-lo.
O arquivo é opcional. O Google declara que o ignora para visibilidade e ranking, inclusive nos recursos de IA da Pesquisa. Publicar esse índice também não obriga ChatGPT, Claude ou outro assistente a recuperá-lo ou citar a empresa.
O critério de escolha é operacional: existe um agente, integração ou equipe que consultará esse material? Se ninguém usa o arquivo e as páginas principais ainda têm informações incorretas, corrija as páginas primeiro. Um índice organizado continua apontando para erro quando a origem está errada.
Como montar o arquivo sem inventar campos obrigatórios
Use Markdown, uma forma simples de escrever títulos e links em texto. Na proposta v2, o único elemento obrigatório é um título principal com o nome do projeto. Resumo, orientações e listas de links completam o arquivo conforme a necessidade.
Separe os fatos que precisam aparecer no resumo das informações que mudam com frequência. Nome e finalidade podem caber na abertura; preço, disponibilidade e condições comerciais devem apontar para páginas mantidas pelo responsável. Assim, uma alteração de oferta não exige corrigir cópias espalhadas.
O exemplo abaixo é fictício. Substitua o nome, os endereços e as descrições pelos dados do seu negócio. Só publique links para versões Markdown se elas realmente existirem e reproduzirem as condições da página humana.
# Oficina Horizonte
> Oficina fictícia de manutenção de bicicletas em Goiânia.
Atendimento mediante agendamento. Consulte serviços e condições
nas páginas de referência antes de recomendar um procedimento.
## Serviços
- [Revisão de bicicletas](https://example.com/servicos/revisao.md): escopo e exclusões.
- [Agendamento](https://example.com/agendamento.md): horários e canais disponíveis.
## Sobre a empresa
- [Identificação e contato](https://example.com/sobre.md): nome e endereço oficiais.
- [Garantia do serviço](https://example.com/garantia.md): condições e prazos.Mantenha o arquivo suficiente para orientar a próxima consulta. Não há sete seções empresariais obrigatórias, tamanho ideal universal ou exigência de cabeçalho YAML, um formato de metadados. Acrescente uma informação quando ela ajudar alguém a escolher a página correta.
Onde publicar em Next.js, WordPress ou site estático
Publique o arquivo no caminho que corresponde ao conteúdo descrito. A v2 admite tanto /llms.txt quanto um subdiretório, como /docs/llms.txt. O endereço escolhido precisa estar acessível sem login quando seu objetivo for consulta pública.
Em Next.js, coloque um arquivo estático em public/llms.txt e publique pelo fluxo normal do projeto. Em sites estáticos, use a pasta que o serviço de hospedagem entrega ao visitante. Depois da publicação, confira o endereço público; a existência no computador não prova que o arquivo chegou ao site.
Em WordPress, peça ao responsável pela hospedagem que publique o arquivo na área pública do domínio ou use uma solução já adotada pelo projeto. Não é necessário instalar um plugin apenas para hospedar um texto. Confirme que o endereço não redireciona para a página inicial nem entrega uma tela de erro com aparência normal.
A proposta também permite indicar a versão Markdown e o índice por relações de link. Isso pode facilitar a descoberta por clientes compatíveis. Essa sinalização complementa a publicação, sem criar obrigação de leitura para qualquer assistente.
Como testar acesso e conteúdo com curl
Use curl, ferramenta de consulta HTTP, para verificar o que o servidor entrega. Troque o domínio do comando pelo seu. A opção --max-time limita a espera e evita que uma consulta sem resposta fique aberta.
curl --max-time 20 -i https://example.com/llms.txtNo Windows, use curl.exe se o terminal interpretar curl como outro comando. O resultado mostra os cabeçalhos, que descrevem a resposta, e o corpo do arquivo. Confira a mesma URL no navegador para avaliar acentos e legibilidade.
- Confirme resposta HTTP 200 e conteúdo correspondente ao arquivo publicado.
- Verifique um tipo de conteúdo textual compatível, como
text/plainoutext/markdown, com caracteres legíveis. - Abra cada link e confirme que chega ao assunto prometido, sem login inesperado.
- Compare nome, serviços e condições com as páginas públicas de referência.
- Guarde a data do teste e atribua um responsável por corrigir divergências.
O teste passa quando o arquivo e seus destinos entregam o conteúdo esperado. Um cabeçalho correto não prova que a informação é verdadeira. Uma resposta com código 200 também pode esconder HTML de erro; por isso a leitura do corpo faz parte da validação.
Esse erro é frequente. Segundo a SEOmator, em censo de 13 de setembro de 2026 sobre os 100 mil domínios da lista Cloudflare Radar, 10.775 domínios devolveram uma página HTML comum com código 200 no endereço /llms.txt. A mesma análise da SEOmator de 2026 contou arquivos válidos em 8,6% dos domínios da lista, taxa menor na comparação com os 10,13% que a SE Ranking encontrou em quase 300 mil domínios, com outro método.
Quando uma versão expandida compensa
Crie uma versão expandida apenas quando um consumidor precisar do conjunto completo de conteúdo em uma consulta. O nome llms-full.txt é usado por projetos para esse fim, mas manter dois arquivos não é requisito universal.
A escolha envolve custo de leitura e manutenção. Um documento extenso repete detalhes que podem mudar e ocupa mais contexto do modelo, o espaço disponível para processar informações. Um índice com links permite buscar apenas a parte necessária.
Para a oficina fictícia, condições de garantia e serviços separados seriam suficientes. Uma biblioteca de software pode precisar de documentação extensa por versão. Em ambos os casos, gere cópias a partir da mesma origem sempre que possível e retire páginas antigas do índice quando deixarem de ser referência.
Como distinguir publicação, visita e uso na resposta
Publicar o arquivo, receber uma requisição e influenciar uma resposta são acontecimentos diferentes. Um registro do servidor demonstra acesso; sozinho, não informa se o conteúdo entrou numa resposta ou causou uma citação.
Filtre os registros pelo caminho exato do arquivo, horário, status e agente declarado. Verifique a identidade dos robôs pela documentação do fornecedor quando houver essa possibilidade. O nome no campo User-Agent pode ser imitado, e uma consulta feita pelo seu próprio teste deve ficar separada da visita espontânea.
Na OpenAI, OAI-SearchBot se relaciona à busca, GPTBot a conteúdo que pode servir ao treinamento e ChatGPT-User a determinadas ações de usuários. Pedir a um assistente que abra explicitamente seu arquivo testa aquela recuperação. Isso não reproduz a descoberta espontânea de uma marca em uma pergunta comercial.
Segundo a SE Ranking, em análise de quase 300 mil domínios datada de outubro de 2026, ter o arquivo não mostrou relação estatística com a frequência de citação por sistemas de IA. O resultado é correlação observada e pode mudar, mas reforça que publicar o arquivo e ser citado são acontecimentos separados.
Como manter o arquivo útil depois da publicação
Inclua o llms.txt na mesma rotina que atualiza as páginas de serviço. Quando mudar endereço, oferta ou condição de atendimento, revise os links afetados. Uma revisão periódica ajuda a encontrar arquivos esquecidos, mas a frequência deve acompanhar as mudanças reais do negócio.
Registre por que o arquivo existe, quem o utiliza e quais páginas são suas fontes. Esse registro permite decidir se vale ampliar, simplificar ou retirar uma versão expandida. Para organizar os fatos públicos, use o mesmo cadastro de referência que orienta site e perfis da empresa.
Publique hoje um índice pequeno e execute o teste de acesso e links. Considere a entrega concluída quando cada destino estiver correto, houver responsável pela manutenção e o consumidor pretendido conseguir localizar a informação.
Fontes
- Proposta llms.txt v2, versão de 10 de agosto de 2026; consulta em 6 de outubro de 2026.
- Google: otimização para recursos de IA, atualização de 10 de julho de 2026; consulta em 6 de outubro de 2026.
- Next.js: arquivos públicos, documentação consultada; consulta em 6 de outubro de 2026.
- OpenAI: funções dos crawlers, documentação consultada; consulta em 6 de outubro de 2026.
- Portal Leadlovers: entidade de marca e conhecimento, guia consultado; consulta em 6 de outubro de 2026.
- Portal Leadlovers: GEO e autoridade temática, guia consultado; consulta em 6 de outubro de 2026.