Lighthouse falha em seu Llms.txt sem links de markdown
A nova auditoria Lighthouse Agentic Browsing do Chrome trata seu .txt arquivo como um documento de remarcação. Se o seu llms.txt não usar a sintaxe do link markdown, você será reprovado na auditoria, mesmo quando todos os links no arquivo forem precisos e funcionarem. Executei a auditoria em nohacks.co. Duas das seis auditorias foram aprovadas. Três voltaram não aplicáveis. Um falhou: a auditoria llms.txt, com o erro literal “O arquivo não parece conter nenhum link.” A correção foi de cinco caracteres por link. O arquivo ainda é exibido como texto simples. Apenas o resultado da auditoria mudou.
O Lighthouse 13.3.0 incluiu a categoria Agentic Browsing junto com Desempenho, Acessibilidade, SEO e Melhores Práticas. Seis auditorias no conjunto padrão: boa formação da árvore de acessibilidade (agent-accessibility-tree), mudança cumulativa de layout (cumulative-layout-shift), capacidade de descoberta do llms.txt (llms-txt) e três verificações WebMCP (webmcp-registered-tools, webmcp-form-coverage, webmcp-schema-validity). A categoria retorna uma taxa de aprovação fracionária em vez de uma pontuação de 0 a 100, porque os padrões para a web agente ainda estão em movimento.
1 de 6 auditorias falharam em Nohacks.co
Executei a auditoria por meio do Lighthouse CLI: npx lighthouse@latest https://nohacks.co --only-categories=agentic-browsing. Seis auditorias retornaram. Três voltaram não aplicáveis, todos WebMCP: webmcp-registered-tools, webmcp-form-coveragee webmcp-schema-validity. O Lighthouse não dá motivos para um resultado não aplicável, apenas marca a auditoria e segue em frente. nohacks.co expõe o WebMCP, mas apenas através do imperativo experimental navigator.modelContext API (duas ferramentas de glossário, duas para um diretório de navegador agente), sem anotações de formulário declarativo. A verificação foi executada em um Chrome 150 headless padrão sem sinalizador WebMCP, portanto, o veredicto não aplicável pode significar que o site não expõe nada que essas auditorias reconheçam ou que o ambiente de verificação não tinha API WebMCP ativa no momento. Farol não diz qual. Duas auditorias foram aprovadas de forma limpa: agent-accessibility-tree relatado “Todas as auditorias foram aprovadas,” confirmar que a estrutura semântica HTML e ARIA está bem formada o suficiente para os agentes navegarem, e cumulative-layout-shift voltou a zero.
Uma auditoria falhou: llms-txt. A mensagem de erro literal do Lighthouse foi:
O arquivo não parece conter nenhum link.
A pontuação da categoria foi de 0,67. Essa foi a primeira surpresa. O arquivo em nohacks.co/llms.txt possui muitos links. Caminhos de navegação para artigos, episódios, convidados, glossário. URLs de feeds RSS. Padrões de URL de arquivos de áudio. O arquivo tem mais de cinco kilobytes de conteúdo estruturado. Então, por que o Lighthouse não relatou nenhum link?
Análise do farol .txt Como Markdown e rejeita links de texto simples
A extensão do arquivo é .txtmas o Lighthouse analisa o conteúdo como markdown e exige a sintaxe do link markdown para que qualquer texto conte como um link. O arquivo é nomeado llms.txt. O servidor HTTP retorna com um text/plain Tipo MIME. Abra-o em um navegador e você verá texto simples. Mas a especificação llms.txt em llmstxt.org define o formato como um documento markdown. A especificação é explícita: “Cada seção contém uma lista de links com marcadores. Cada item da lista tem um link seguido por notas opcionais sobre o link, separadas do link por dois pontos.” O analisador do Lighthouse impõe isso estritamente. Cada link deve ser codificado como sintaxe de link markdown, (text)(url)com colchetes ao redor do texto do link e parênteses ao redor do URL.
Meu arquivo estava usando um formato de texto simples mais natural:
- Homepage: / - Publication masthead, cornerstone series, latest articles and episodes
- Articles: /blog - All articles on AXO, the agentic web, and AI agents
- Episode: /episode/(slug) - Full show notes, transcript, audio player
Mesmos destinos. Mesmas descrições. Mesma informação. O analisador do Lighthouse não registra essas linhas como links. Em todo o arquivo, registrou exatamente zero. A auditoria falha.
Um arquivo com um .txt extensão, servido com um text/plain Tipo MIME, que falha na auditoria, a menos que seja formatado como markdown. Essa é uma incompatibilidade sobre a qual a camada de auditoria terá que ser mais honesta. A extensão diz uma coisa. O tipo MIME diz uma coisa. O analisador é a fonte da verdade e exige redução.
A correção são 5 caracteres por link
Envolva cada destino de link na sintaxe de parêntese de colchete de marcação, (text)(url)e substitua o - separador antes de cada descrição com : . Cinco caracteres por link. Conversão mecânica, repetida em todo o arquivo.
- (Homepage)(/): Publication masthead, cornerstone series, latest articles and episodes
- (Articles)(/blog): All articles on AXO, the agentic web, and AI agents
- (Episode)(/episode/(slug)): Full show notes, transcript, audio player
Eu fiz a edição. Executei novamente a auditoria. A pontuação passou de 0,67 para 1,0. O título da auditoria mudou de “llms.txt não segue recomendações” para “llms.txt segue recomendações.” Nenhum item detalhado no relatório posterior. Passe limpo.
O arquivo ainda é servido como text/plain. A extensão do arquivo ainda é .txt. O conteúdo do arquivo ainda é o mesmo. Apenas a codificação do link foi alterada.
Lighthouse mede sintaxe de link analisável, não qualidade de arquivo
A auditoria verifica se o seu arquivo pode ser analisado mecanicamente. Ele não verifica se o arquivo descreve o seu site de maneira útil. Ambas as leituras são verdadeiras ao mesmo tempo.
A primeira leitura: A auditoria está medindo algo real. A sintaxe do link Markdown pode ser analisada mecanicamente. Linhas descritivas de texto simples não são. Se um agente de IA (ou o analisador Lighthouse que substitui um agente) precisar extrair links do arquivo programaticamente, o formato markdown será necessário. A auditoria está correta ao afirmar que o arquivo anterior à minha correção não pôde ser analisado em busca de links pelas ferramentas padrão. A conversão para a sintaxe do link markdown corrige uma lacuna real de interoperabilidade.
A segunda leitura: conformidade de formato não é o mesmo que qualidade de arquivo. Um llms.txt cuidadosamente escrito, preciso e abrangente que usa descrições em texto simples falha nesta auditoria. Um llms.txt fino e gerado automaticamente com sintaxe de link de remarcação é aprovado. A auditoria não pode dizer a diferença entre os dois. O plugin WordPress AIOSEO, usado por mais de 3 milhões de sites de acordo com sua listagem WordPress.org, gera arquivos llms.txt com sintaxe de link markdown por padrão, um comportamento padrão de Glenn Gabe surgiu e a própria documentação do plugin confirma. Esses arquivos gerados automaticamente usam a sintaxe do link markdown porque é isso que o gerador emite. A maioria deles provavelmente passa nesta auditoria. A maioria dos arquivos llms.txt, selecionados manualmente e com reconhecimento do proprietário, provavelmente falham.
Vale a pena pensar nessa lacuna antes de tratar a aprovação/reprovação da auditoria como uma medida de quão realmente seu site está pronto para o agente. A auditoria está verificando se o seu arquivo pode ser analisado. Não está verificando se o seu arquivo é útil.
Você deve se preocupar com a verificação Llms.txt do Lighthouse Agentic Browsing?
Sim, mas de forma restrita. O Lighthouse pode dizer se seu llms.txt pode ser analisado como markdown. Ele não pode dizer se o arquivo descreve seu site honestamente. Esse cheque é seu. Abra o Chrome DevTools, clique na guia Lighthouse, verifique se a categoria Agentic Browsing está marcada e execute Analisar em seu URL. A auditoria leva menos de um minuto. Se falhar no erro sem links, a correção será de cinco caracteres por link e cinco minutos de edição. Se for aprovado, a pergunta mais difícil será aquela que Lighthouse não pode fazer. O arquivo foi gerado automaticamente por um plugin que você não configurou ou você mesmo o escreveu e, de qualquer forma, ele descreve o que realmente é o seu site?
A arquitetura que prioriza a máquina Pilar da estrutura está por trás de tudo isso: modelos de dados antes dos layouts de página, independência de renderização, conteúdo que não depende de JavaScript do lado do cliente ou padrões de exibição humana para ser legível por máquina. A auditoria llms.txt é uma verificação restrita nessa camada. A questão estrutural maior, se a sua superfície legível por máquina descreve o seu site com precisão, é sua.
Mais recursos:
Este post foi publicado originalmente no No Hacks.
Imagem em destaque: Darko 1981/Shutterstock
