Você caprichou no seu arquivo llms.txt, listou todas as URLs certas, e mesmo assim o Lighthouse do Chrome reprovou a auditoria. Não é bug seu: é uma exigência de formato que pega muita gente de surpresa e vale entender antes de sair mexendo no site.
A auditoria de navegação agêntica do Lighthouse trata o llms.txt como um documento markdown. Se os links não estiverem em sintaxe markdown, a auditoria falha, mesmo que cada link funcione perfeitamente, como mostrou o Search Engine Journal.
O detalhe que reprova o arquivo
O problema está na forma como o parser lê os links. Escrever a URL em texto puro, seguida de uma descrição separada por dois-pontos, não é reconhecido como link. Cada endereço precisa estar na sintaxe markdown, com o texto entre colchetes e a URL entre parênteses. Segundo a documentação oficial do Chrome for Developers, essa exigência existe porque o agente de IA precisa extrair os links de forma programática, e o markdown garante isso.
| Formato | Exemplo | Passa no Lighthouse? |
|---|---|---|
| Texto puro | Página inicial: / | Não |
| Markdown | [Página inicial](/) | Sim |
Passo a passo para corrigir
A boa notícia é que o ajuste é rápido. Em poucos minutos você deixa o arquivo pronto para os agentes e livre do alerta.
- Abra o seu llms.txt e reescreva cada link no formato markdown, com o texto entre colchetes e a URL entre parênteses.
- Sirva o arquivo na raiz do domínio, garantindo que ele esteja acessível de forma pública.
- Rode a auditoria de navegação agêntica no Lighthouse e confira se todos os links foram reconhecidos.
- Revise as descrições para que fiquem claras e úteis para um agente que lê o arquivo por conta própria.
Vale a pena manter um llms.txt?
O llms.txt é um padrão proposto para orientar como agentes de IA leem o conteúdo de um site, uma espécie de mapa pensado para máquinas. Vale lembrar que o próprio Google já afirmou que o arquivo não ajuda nem prejudica o ranking na Busca, então ele não é um atalho de SEO. O valor está em outro lugar: tornar o seu conteúdo mais legível para assistentes e agentes, o que conversa direto com a visibilidade em respostas de IA. Não à toa, o Google adicionou a checagem de llms.txt ao Lighthouse, e a proposta vem sendo debatida como um novo padrão para o rastreamento de conteúdo por IA. Esse movimento se conecta ao que já discutimos sobre ser uma das fontes preferidas na busca com IA.
Perguntas frequentes
O que é o llms.txt?
É um arquivo proposto para orientar como agentes de IA leem o conteúdo de um site, funcionando como um mapa pensado para máquinas.
Por que meu llms.txt falha no Lighthouse?
Porque a auditoria trata o arquivo como markdown. Se os links não estiverem em sintaxe markdown, com texto entre colchetes e URL entre parênteses, ela reprova, mesmo que os links funcionem.
Como escrever o link do jeito certo?
No formato [texto](url). Por exemplo, [Página inicial](/). O texto puro seguido de dois-pontos não é reconhecido como link pelo parser.
O llms.txt ajuda no ranking do Google?
Não diretamente. O próprio Google afirmou que o arquivo não ajuda nem prejudica o ranking na Busca. O ganho é de legibilidade por agentes de IA, cada vez mais relevante para a visibilidade em respostas generativas.
Preciso ter um llms.txt?
Não é obrigatório, mas ajuda os agentes de IA a interpretar o seu site. Se você mantém um, vale garantir que ele passe na auditoria com links em markdown.
