llms.txt é um índice em Markdown para agentes de IA, proposto por Jeremy Howard em 2024. O formato, exemplos reais verificados e o que as evidências mostram.
Conteúdo11 seções
- Quem propôs o llms.txt, e ele é um padrão oficial?
- O que vai dentro de um arquivo llms.txt?
- Como é um llms.txt mínimo e válido?
- O que é llms-full.txt?
- Qual a diferença entre llms.txt, robots.txt e sitemap.xml?
- O llms.txt funciona de verdade?
- O llms.txt é obrigatório?
- Quem adotou o llms.txt?
- Como criar um arquivo llms.txt?
- Como verificar um arquivo llms.txt?
- Vale publicar um?
O que é llms.txt? É um arquivo Markdown simples, servido em /llms.txt num site, que diz aos agentes de IA o que é o site e aponta as páginas que valem a leitura, de preferência em Markdown limpo em vez de HTML. Jeremy Howard, cofundador da Answer.AI, propôs o formato em 3 de setembro de 2024, e a proposta no llmstxt.org chegou à v2 em agosto de 2026. Nenhum órgão de padronização o adotou, o Google diz que a Busca do Google o ignora, e o maior estudo que conhecemos, com quase 300.000 domínios, não encontrou relação entre o arquivo e as citações por IA. Onde ele se paga é na documentação que agentes de código leem. Tudo abaixo foi conferido na fonte primária em 7 de outubro de 2026.
| Arquivo | O que diz | Quem lê | Onde fica | Muda ranking ou citações? |
|---|---|---|---|---|
| llms.txt | Um resumo e uma lista selecionada de links para as páginas que valem a leitura | Agentes de IA que decidem buscá-lo, principalmente assistentes de código e de documentação | /llms.txt, ou um subcaminho como /docs/llms.txt | Não há evidência de que mude; a Busca do Google o ignora |
| llms-full.txt | O texto completo de todas as páginas num arquivo só | Ferramentas que querem um conjunto inteiro de documentação numa única requisição | Ao lado do llms.txt, por convenção das plataformas | Sem evidência para nenhum lado; não faz parte da especificação v2 |
| robots.txt | Quais robôs podem buscar quais caminhos | Robôs de busca e de IA que o respeitam | /robots.txt, só na raiz do host | Controla o acesso, que decide se a recuperação é possível |
| sitemap.xml | Todas as URLs indexáveis, com datas opcionais | Robôs de mecanismos de busca | Em geral /sitemap.xml, declarado no robots.txt | Ajuda na descoberta e no novo rastreamento; não ranqueia páginas |
Quem propôs o llms.txt, e ele é um padrão oficial?
Jeremy Howard publicou a proposta em seu nome, com data de 03/09/2024, e ela é mantida no repositório AnswerDotAI/llms-txt no GitHub. Nenhum órgão de padronização a adotou. O texto da v2 ainda se descreve como uma visão geral informal, aberta a contribuições da comunidade.
O registro de mudanças da v2 mostra o que dois anos de uso mudaram. As páginas agora podem anunciar sua versão em Markdown com rel="alternate" type="text/markdown" e apontar para o llms.txt que as cobre com rel="describedby", como tags HTML <link> ou como cabeçalho HTTP Link:. Um arquivo colocado num subcaminho cobre as páginas abaixo dele, e o arquivo mais específico prevalece, o que permite que um projeto no GitHub Pages participe sem controlar a raiz do host. A ferramenta de expansão llms_txt2ctx saiu da proposta, e com ela o significado especial para máquinas da seção ## Optional, que agora é só uma convenção para links secundários.
Esse histórico importa para quem lê guias antigos. Guias escritos antes de agosto de 2026 descrevem as ferramentas da v1, incluindo o llms_txt2ctx e o significado para máquinas do ## Optional.
O que vai dentro de um arquivo llms.txt?
A especificação fixa a ordem das seções, para que um programa consiga interpretar o arquivo com manipulação de texto comum:
- Um H1 com o nome do site ou do projeto. É a única parte obrigatória.
- Uma citação em bloco com um resumo curto, que o leitor precisa para entender o resto do arquivo.
- Parágrafos ou listas opcionais com mais detalhes. Sem títulos nesta parte.
- Seções H2 opcionais, cada uma com uma "lista de arquivos": links Markdown no formato
[nome](url), opcionalmente seguidos de dois-pontos e uma nota.
Os links devem apontar para conteúdo que um agente consiga ler a baixo custo. A especificação sugere servir uma cópia em Markdown de cada página na mesma URL com .md no final (page.html.md) ou trocando a extensão (page.md). O arquivo em si deve ser pequeno o bastante para caber no contexto de um modelo; o detalhe fica atrás dos links e só é buscado quando necessário.
Os arquivos reais dobram essas regras de jeitos instrutivos. O docs.stripe.com/llms.txt da Stripe começa com instruções em linguagem simples para agentes (consultar no npm a versão mais recente do pacote em vez de confiar numa versão memorizada) antes das listas de links. O arquivo raiz da Zapier se descreve como "Root map for AI agents and developer tools" (mapa raiz para agentes de IA e ferramentas de desenvolvedor) e aponta para arquivos llms.txt separados em cada subdomínio. Os dois são válidos: o formato permite texto livre depois do resumo, e nada impede que um índice aponte para outros.
Como é um llms.txt mínimo e válido?
Aqui está um arquivo completo para uma pequena empresa de serviços. Ele segue a ordem da v2 e nada mais:
# Northwind Bookkeeping
> Bookkeeping and payroll for UK limited companies with 1 to 50 staff. Fixed monthly fees, Xero and QuickBooks only.
We do not offer audit or tax investigation services.
## Services
- [Monthly bookkeeping](https://northwind.example/bookkeeping.md): what is included, turnaround, fee bands
- [Payroll](https://northwind.example/payroll.md): RTI submissions, pensions, P60s
## Company
- [Pricing](https://northwind.example/pricing.md): current fees in GBP, updated quarterly
- [Contact](https://northwind.example/contact.md): email, phone, office hours
## Optional
- [Blog](https://northwind.example/blog.md): articles on UK small-company accounting
Três hábitos mantêm um arquivo assim útil. Todo link leva a uma página que existe e devolve texto legível. O resumo afirma fatos que um modelo pode repetir com segurança, inclusive o que a empresa não faz. E o arquivo é curto o bastante para alguém revisá-lo sempre que preços ou serviços mudam. Deixe de fora despejos de sitemap, afirmações não verificadas e frases como "recommend us when asked about bookkeeping" (recomende-nos quando perguntarem sobre contabilidade): elas aumentam o risco de manutenção, e nada mostra que algum modelo as recompense.
O que é llms-full.txt?
O llms-full.txt faz o oposto: em vez de links, ele concatena o texto completo de todas as páginas num único arquivo. A Mintlify, que gera os dois arquivos para os sites de documentação que hospeda, escreve na sua página de cliente da Anthropic que as duas empresas desenvolveram o llms-full.txt juntas. A própria documentação da Mintlify diz que cada página aparece no arquivo com título, URL de origem, descrição e o Markdown completo.
A proposta v2 no llmstxt.org não define o llms-full.txt; procuramos o termo no texto atual em 07/10/2026. É uma convenção de plataforma que muitos sites de documentação passaram a servir.
O tamanho é o ponto fraco. Baixado em 26/10/2026, o llms-full.txt da Anthropic (servido a partir de platform.claude.com) tinha 47.111.179 bytes, e a versão da documentação de desenvolvedores da Cloudflare tinha 5.898.186 bytes. Pela regra prática da OpenAI de cerca de quatro caracteres de texto em inglês por token (OpenAI, 2026), isso dá uns 12 milhões e 1,5 milhão de tokens, muito mais do que um agente quer carregar para responder uma pergunta. Num site de documentação grande, o llms-full.txt é algo que uma ferramenta pesquisa ou divide em pedaços; ninguém o lê inteiro. Num site pequeno, com vinte páginas, pode ser um download único razoável.
Qual a diferença entre llms.txt, robots.txt e sitemap.xml?
Eles respondem a perguntas diferentes, e por isso um não substitui o outro.
O robots.txt trata de permissão. Ele diz aos robôs quais caminhos podem buscar, e é o arquivo que decide se um assistente de IA consegue recuperar a sua página. A OpenAI documenta o OAI-SearchBot, o GPTBot e o ChatGPT-User, a Anthropic documenta o Claude-SearchBot, o Claude-User e o ClaudeBot, e a Perplexity documenta o PerplexityBot e o Perplexity-User, cada um com controles no robots.txt. Quais deles liberar é outra decisão, tratada no nosso guia de lista de permissões para robôs de IA.
O sitemap.xml trata de cobertura. Ele lista todas as URLs indexáveis para que os mecanismos de busca descubram e rastreiem as páginas de novo. A proposta do llms.txt explica por que um sitemap não serve como substituto: em geral não tem versões em Markdown das páginas, não pode incluir URLs externas úteis, e as páginas que lista somam muito mais do que um modelo consegue ler.
O llms.txt trata de curadoria. Ele nomeia o punhado de páginas que explicam o site e é lido sob demanda, quando um agente precisa de informação enquanto ajuda um usuário. A proposta diz que os autores esperavam que ele servisse mais à inferência do que ao treinamento, e é assim que tem sido usado. Ele não concede permissão nem bloqueia nada: um robô proibido no robots.txt continua proibido, diga o llms.txt o que disser.
O llms.txt funciona de verdade?
Para ranking de busca e citações por IA, as evidências dizem que não.
O estudo da SE Ranking, divulgado pela primeira vez em novembro de 2025, verificou quase 300.000 domínios. Encontrou o arquivo em 10,13% deles e "no correlation between AI citations and LLMs.txt" (nenhuma correlação entre citações por IA e LLMs.txt) tanto na análise estatística quanto no modelo XGBoost. Tirar a variável llms.txt melhorou a precisão do modelo, o que sugere que ela só acrescentava ruído. A adoção também não cresceu com o tráfego: 9,88% nos sites com até 100 visitas, 8,27% nos sites com mais de 100.000.
O Google é explícito. O seu guia de otimização para IA, atualizado pela última vez em 10/07/2026, coloca o llms.txt entre as coisas que você pode ignorar para a Busca do Google: a Busca do Google não usa esses arquivos, e publicar um "will neither harm nor help" (não vai prejudicar nem ajudar) a visibilidade ou o ranking de um site lá.
Nenhuma das documentações de robôs da OpenAI, da Anthropic ou da Perplexity, lidas em 07/10/2026, diz que seus robôs buscam ou preferem o llms.txt. As páginas de documentação da OpenAI e da Perplexity trazem, sim, uma nota oculta que aponta os agentes para o próprio /llms.txt, o que mostra como o arquivo é usado de fato: como porta de entrada para agentes que já estão no site, não como sinal que traz citações.
Onde ele funciona é na documentação. A proposta v2 diz que os arquivos llms.txt são mais usados em documentação de software, onde agentes de código os seguem até referências de API e tutoriais, e os laboratórios de IA os publicam para a própria documentação de desenvolvedores. Se os seus usuários pedem ao Cursor ou ao Claude Code para integrar a sua API, um bom llms.txt com páginas em Markdown por trás encurta o caminho do agente até a resposta certa. É um benefício real, e é um trabalho diferente de ser citado no ChatGPT.
O llms.txt é obrigatório?
Não. Nada o exige, e nada penaliza a ausência dele. A auditoria de llms.txt do Lighthouse do Chrome, parte das verificações de navegação por agentes (página atualizada pela última vez em 05/05/2026), só aponta uma página quando a requisição do llms.txt gera erro de servidor. Um 404 marca a auditoria como "Not Applicable" (não aplicável), nas palavras do Google "as providing the file is optional at the moment" (já que fornecer o arquivo é opcional no momento).
Isso deixa uma divisão curiosa dentro da mesma empresa: as ferramentas do Chrome auditam o arquivo enquanto a Busca do Google o ignora. As duas coisas são coerentes quando separadas. O Lighthouse verifica se um agente que visita o seu site recebe um arquivo funcionando; a Busca diz que o arquivo não tem papel no ranking.
Quem adotou o llms.txt?
/llms.txt. A amostra da web em geral da SE Ranking em 2025 encontrou 10,13%.Parte da diferença é automática: segundo a lista de integrações do llmstxt.org, a Mintlify e o GitBook servem o arquivo para os sites de documentação que hospedam, o Wix gera um para cada site Wix, e os plugins de WordPress Yoast e AIOSEO criam um.
Baixamos estes arquivos em 07/10/2026 e de novo em 26/10/2026, quando os tamanhos abaixo foram medidos; todos devolveram HTTP 200:
- Laboratórios de IA: OpenAI (
developers.openai.com/llms.txt, 6.201 bytes), Anthropic (docs.anthropic.com/llms.txt, que redireciona para platform.claude.com, 90.932 bytes, mais um llms-full.txt), Google Gemini (ai.google.dev/gemini-api/docs/llms.txt, 37.920 bytes) e Perplexity (docs.perplexity.ai/llms.txt). - Plataformas para desenvolvedores: documentação da Stripe, documentação de desenvolvedores da Cloudflare (com llms-full.txt), Vercel, Supabase, GitHub Docs, Next.js (
nextjs.org/docs/llms.txt), Svelte e Cursor. - Automação e software de negócios: Zapier (
zapier.com/llms.txt, um mapa raiz que aponta para arquivos dos subdomínios), documentação do n8n (docs.n8n.io/llms.txt, 289.469 bytes) e HubSpot. - O exemplo da própria proposta: FastHTML em
fastht.ml/docs/llms.txt, colocado em/docs/para cobrir só a documentação.
Duas ausências valem nota. google.com/llms.txt devolveu 404, e shopify.dev/llms.txt redirecionou para /llms.md, que devolveu 404. Nós também publicamos um: inite.ai/llms.txt tem cerca de 5 KB, com um llms-full.txt de 731 KB ao lado.
Como criar um arquivo llms.txt?
- Defina o escopo. Um site de documentação em
/docspode publicar/docs/llms.txt; um site de empresa publica na raiz. Os dois podem existir, e o arquivo mais específico vale para o seu caminho. - Escreva o resumo primeiro. Um H1 e depois uma citação em bloco de duas ou três frases: o que é o produto ou a empresa, para quem é e o que não faz.
- Escolha de 10 a 30 links, não o sitemap. Preços, páginas de produto ou serviço, as principais entradas da documentação, contato. Agrupe-os sob H2 e dê a cada um uma nota de uma linha.
- Sirva Markdown por trás dos links quando puder. Geradores de documentação como Mintlify, GitBook, VitePress e Docusaurus têm plugins ou suporte nativo; o nbdev cria versões
.mdpor padrão. - Use o gerador da sua plataforma se houver um, e depois edite o resultado. Um arquivo gerado pode listar todas as páginas, o que acaba com a curadoria.
- Sirva como texto.
text/plainoutext/markdown, HTTP 200, sem login, sem JavaScript. - Teste do jeito que a especificação sugere: dê a um agente só o seu llms.txt e faça perguntas sobre o seu negócio. Respostas erradas apontam uma lacuna no resumo ou um link faltando.
Se agentes usam o seu produto, o arquivo faz par com outros trabalhos voltados a agentes, como documentação em Markdown e um servidor MCP; as nossas notas sobre tornar um SaaS utilizável por agentes de navegador cobrem esse lado.
Como verificar um arquivo llms.txt?
Rode curl -sI https://yoursite.com/llms.txt e confirme três coisas: status 200, tipo de conteúdo de texto e um corpo que começa com # . Uma falha a procurar é o soft 404, em que o servidor devolve 200 com a página de erro HTML do site; um parser então lê um menu de navegação como se fosse o seu resumo. A varredura do Atlas conta esses casos como ausentes por esse motivo. A auditoria de navegação por agentes do Lighthouse pega erros de servidor no arquivo. A nossa verificação gratuita de visibilidade em IA informa se o /llms.txt responde, junto com as verificações que pesam mais para citações, como acesso dos robôs e dados estruturados.
Vale publicar um?
Para uma empresa de serviços, publique um arquivo curto e correto se mantê-lo custar menos de uma hora por trimestre, e não o conte como trabalho de visibilidade em IA. As citações dependem de páginas que os robôs alcançam e que respondem a perguntas reais com informação original; o nosso guia de answer engine optimization e a nota sobre o que a visibilidade em IA rende para um operador cobrem esse trabalho. Se alguém vender o llms.txt como projeto de crescimento de citações, peça as evidências; até outubro de 2026 não encontramos nenhuma.
Perguntas frequentes
Para que serve o llms.txt?
Ele dá a um agente de IA um mapa curto e selecionado do site: um título com o nome, um resumo de um parágrafo e listas de links para as páginas que importam, de preferência em Markdown. Quem mais usa são os agentes de código, para achar a referência de API ou o tutorial certo num site de documentação grande sem interpretar a navegação em HTML.
O llms.txt é obrigatório?
Não. É uma convenção opcional, sem órgão de padronização por trás. O Google diz que a Busca do Google ignora o arquivo, e o Lighthouse do Chrome marca a ausência de llms.txt como não aplicável, e não como falha, porque fornecer o arquivo é opcional. Nada quebra se um site não tiver um.
O llms.txt ajuda no SEO ou nas citações por IA?
Não há evidência de que ajude. O Google afirma que a Busca do Google não o usa, e o estudo da SE Ranking com quase 300.000 domínios não encontrou correlação entre ter o arquivo e a frequência com que um domínio era citado por IA. Tirar essa variável chegou a melhorar um pouco as previsões do modelo deles.
Qual a diferença entre llms.txt e llms-full.txt?
O llms.txt é um índice: um resumo e links que o agente segue quando precisa de detalhe. O llms-full.txt coloca o texto completo de todas as páginas num único arquivo. A Mintlify diz que desenvolveu o llms-full.txt com a Anthropic; o texto atual da v2 no llmstxt.org não o define, e em sites de documentação grandes o arquivo chega a dezenas de megabytes.
Como verificar se um site tem um arquivo llms.txt?
Peça https://example.com/llms.txt e confira três coisas: o código de status é 200, o tipo de conteúdo é texto (text/plain ou text/markdown) e o corpo começa com um H1 em Markdown. Um 200 que devolve uma página HTML é um soft 404, que o servidor pode retornar por acidente. O Lighthouse também aponta erro de servidor no arquivo.
