O novo auditoria de Navegação Agente do Lighthouse do Chrome trata seu .txt arquivo como um documento markdown. Se o seu llms.txt não usar a sintaxe de link markdown, você falha na auditoria, mesmo quando todos os links no arquivo são precisos e funcionam. Eu executei a auditoria em nohacks.co. Dois dos seis auditorias passaram. Três retornaram como não aplicáveis. Um falhou: a auditoria llms.txt, com a mensagem de erro literal “O arquivo não parece conter nenhum link.” A correção foi cinco caracteres por link. O arquivo ainda é servido como texto simples. Apenas o resultado da auditoria mudou.
O Lighthouse 13.3.0 foi lançado na categoria de Navegação Agente ao lado de Performance, Acessibilidade, SEO e Melhores Práticas. Seis auditorias no conjunto padrão: bem-formação da árvore de acessibilidade (agent-accessibility-tree), deslocamento de layout cumulativo (cumulative-layout-shift), descobrimento de llms.txt (llms-txt), e três verificações do WebMCP (webmcp-registered-tools, webmcp-form-coverage, webmcp-schema-validity). A categoria retorna uma razão 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 Falhou Em Nohacks.co
Eu executei a auditoria via CLI do Lighthouse: npx lighthouse@latest https://nohacks.co --only-categories=agentic-browsing. Seis auditorias retornaram. Três vieram como não aplicáveis, todos WebMCP: webmcp-registered-tools, webmcp-form-coverage, e webmcp-schema-validity. O Lighthouse não dá razão para um resultado não aplicável, apenas marca a auditoria e segue em frente. nohacks.co expõe WebMCP, mas apenas através da API experimental navigator.modelContext (duas ferramentas de glossário, duas para um diretório de navegador agente), sem anotações de formulário declarativas. A varredura foi executada em um Chrome 150 padrão sem a flag WebMCP, então 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 varredura não tinha a API WebMCP ativa no momento. O Lighthouse não diz qual. Duas auditorias passaram limpas: agent-accessibility-tree relatou “Todas as auditorias passaram,” confirmando que o HTML semântico e a estrutura ARIA estão bem formadas o suficiente para que os agentes naveguem, e cumulative-layout-shift retornou 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 0.67. Essa foi a primeira surpresa. O arquivo em nohacks.co/llms.txt tem muitos links. Caminhos de navegação para artigos, episódios, convidados, o glossário. URLs de feeds RSS. Padrões de URLs de arquivos de áudio. O arquivo tem mais de cinco kilobytes de conteúdo estruturado. Então, por que o Lighthouse relatou zero links?
O Lighthouse Analisa .txt Como Markdown E Rejeita Links De Texto Simples
A extensão do arquivo é .txt, mas o Lighthouse analisa o conteúdo como markdown e exige a sintaxe de link markdown para que qualquer texto conte como um link. O arquivo é nomeado llms.txt. O servidor HTTP o retorna com um tipo MIME text/plain. 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 em markdown. 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, [texto](url), com colchetes ao redor do texto do link e parênteses ao redor da URL.
Meu arquivo estava usando um formato de texto simples mais natural:
- Página inicial: / - Cabeçalho da publicação, série fundamental, últimos artigos e episódios
- Artigos: /blog - Todos os artigos sobre AXO, a web agente e agentes de IA
- Episódio: /episode/[slug] - Notas completas do show, transcrição, player de áudio
Mesmos destinos. Mesmas descrições. Mesmas informações. O analisador do Lighthouse não registra essas linhas como links. Em todo o arquivo, ele registrou exatamente zero. Auditoria falha.
Um arquivo com uma extensão .txt, servido com um tipo MIME text/plain, que falha em uma auditoria a menos que seja formatado como markdown. Essa é uma incompatibilidade que a camada de auditoria terá que ser mais honesta sobre. A extensão diz uma coisa. O tipo MIME diz uma coisa. O analisador é a fonte da verdade, e o analisador exige markdown.
A Correção É 5 Caracteres Por Link
Envolva cada alvo de link na sintaxe de colchetes e parênteses markdown, [texto](url), e substitua o separador - antes de cada descrição por : . Cinco caracteres por link. Conversão mecânica, repetida em todo o arquivo.
- [Página Inicial](/): Cabeçalho da publicação, série fundamental, últimos artigos e episódios
- [Artigos](/blog): Todos os artigos sobre AXO, a web agente e agentes de IA
- [Episódio](/episode/[slug]): Notas completas do show, transcrição, player de áudio
Eu fiz a edição. Re-executei a auditoria. A pontuação subiu de 0.67 para 1.0. O título da auditoria mudou de “llms.txt não segue as recomendações” para “llms.txt segue as recomendações.” Nenhum item de detalhe no relatório posterior. Aprovação limpa.
O arquivo ainda é servido como text/plain. A extensão do arquivo ainda é .txt. O conteúdo do arquivo ainda é o mesmo conteúdo. Apenas a codificação do link mudou.
O Lighthouse Mede Sintaxe De Link Parseável, Não Qualidade Do Arquivo
A auditoria verifica se seu arquivo é mecanicamente parseável. Não verifica se o arquivo descreve seu site de forma útil. Ambas as leituras são verdadeiras ao mesmo tempo.
A primeira leitura: A auditoria está medindo algo real. A sintaxe de link markdown é mecanicamente parseável. Linhas descritivas de texto simples não são. Se um agente de IA (ou o analisador do Lighthouse representando um agente) precisa extrair links do arquivo programaticamente, o formato markdown é necessário. A auditoria está correta que o arquivo antes da minha correção não poderia ser analisado para links pelas ferramentas padrão. A conversão para a sintaxe de link markdown corrige uma verdadeira lacuna de interoperabilidade.
A segunda leitura: conformidade de formato não é a mesma coisa que qualidade do arquivo. Um llms.txt bem escrito, preciso e abrangente que usa descrições em texto simples falha nesta auditoria. Um llms.txt fino, gerado automaticamente, com sintaxe de link markdown passa. A auditoria não consegue distinguir entre os dois. O plugin WordPress AIOSEO, usado por mais de 3 milhões de sites segundo sua listagem no WordPress.org, gera arquivos llms.txt com sintaxe de link markdown por padrão, um comportamento padrão destacado por Glenn Gabe, e a própria documentação do plugin confirma. Esses arquivos gerados automaticamente usam sintaxe de link markdown porque é isso que o gerador emite. A maioria deles provavelmente passa nesta auditoria. A maioria dos arquivos llms.txt curados manualmente e cientes do proprietário provavelmente falham.
Essa lacuna vale a pena pensar antes de tratar a aprovação/reprovação da auditoria como uma medida de quão pronto para agentes seu site realmente é. A auditoria está verificando se seu arquivo é parseável. Não está verificando se seu arquivo é útil.
Você Deveria Se Importar Com A Verificação Llms.txt Do Lighthouse Agentic Browsing?
Sim, mas de forma restrita. Luz
