Checker e validador LLMs.txt

Introduza um domínio, o URL completo do llms.txt ou cole um rascunho. O Checker e validador LLMs.txt descarrega o ficheiro, valida a sua estrutura Markdown face à proposta llmstxt.org, reproduz os critérios relevantes do Chrome Lighthouse e testa os URL que contém. Recebe um relatório que separa erros, avisos e recomendações. Gratuito, sem conta.

O que o checker de llms.txt valida

Entrega do ficheiro

Muitos ficheiros parecem corretos mas nunca chegam a ser servidos. O checker indica o estado HTTP e o tipo de conteúdo e deteta o 404 suave, quando o servidor responde a /llms.txt com uma página HTML em vez de um ficheiro de texto. Lê também o robots.txt, porque um ficheiro aí bloqueado fica fora do alcance dos agentes que o respeitam, e assinala se existe um llms-full.txt ao lado.

Estrutura Markdown

Na proposta llmstxt.org o H1 com o nome do site é o único elemento obrigatório, por isso é a única coisa reportada como erro. O resumo em citação, as secções H2, os URL absolutos, as descrições por ligação, os URL duplicados, as ligações para outros domínios e o tamanho do ficheiro surgem como avisos ou recomendações, porque afetam a utilidade e não a validade. Um ficheiro servido a partir de um subcaminho é verificado face ao caminho que descreve, e um BOM inicial é aceite em vez de confundido com um título em falta.

Critérios do Chrome Lighthouse

O checker reproduz os três critérios da auditoria experimental Agentic Browsing do Lighthouse 13.3 e mostra o resultado numa escala de três. Na prática um falha muito mais do que os restantes: ligações escritas como URL simples em vez de Markdown, o defeito clássico dos ficheiros feitos à mão.

É uma auditoria de estrutura, não um sinal de posicionamento na Pesquisa Google. Para a auditoria, um ficheiro ausente é tratado como não aplicável, enquanto um ficheiro publicado que falhe pode ser reportado como erro.

Estado das ligações

Cada endereço ligado recebe um pedido, e os que devolvem erro são listados com o respetivo estado HTTP. Os redirecionamentos são reportados à parte com o destino, pelo que um ficheiro que ainda aponta para URL antigos surge como desatualizado e não como quebrado.

Como corrigir as falhas mais comuns

H1 em falta

A primeira linha tem de ser um cabeçalho Markdown com o nome do site, por exemplo # Acme Lda.. Texto simples ou um H2 não contam. É o único elemento obrigatório do formato.

As ligações não estão em Markdown

Escreva - [Preços](https://example.com/precos): o que inclui cada plano. em vez de um URL simples.

URL relativos

Use ligações absolutas. Um modelo que lê o ficheiro não tem um URL base para resolver /precos.

Descrições em falta

Uma ligação sem descrição não diz ao modelo nada além do título. Acrescente uma frase concreta depois dos dois pontos.

As ligações mortas surgem depois de uma reestruturação do site, por isso gere o ficheiro de novo sempre que URL importantes mudarem. O gerador de llms.txt cria-lhe um ficheiro validado.

Perguntas frequentes

• Um checker de llms.txt é o mesmo que um validador ou um tester?

  Na prática, checker, validador, tester e linter descrevem a mesma intenção. Esta ferramenta cobre os dois lados: verifica se o ficheiro está mesmo a ser servido e valida a estrutura Markdown face à proposta llmstxt.org.

• O que torna um llms.txt válido?

  Na proposta v2, um H1 com o nome do site é o único elemento obrigatório. Tudo o resto, do resumo às descrições por ligação, são recomendações que o tornam mais útil - por isso o relatório separa erros de avisos e recomendações.

• Posso verificar um rascunho antes de publicar?

  Sim. Abra a opção de colar e insira o conteúdo do ficheiro. Correm os mesmos testes de estrutura e critérios do Lighthouse, embora a entrega e o estado das ligações exijam um URL online.

• Porque é que o meu ficheiro falha a verificação de ligações?

  Quase sempre porque as ligações são URL simples em vez de ligações Markdown. Só conta a forma [Título](URL).

• Um llms.txt ausente baixa o meu resultado no Lighthouse?

  Não. Para essa auditoria um ficheiro ausente é tratado como não aplicável e sai do cálculo. Um ficheiro publicado que falhe pode ser reportado como erro.

• O checker consegue validar um ficheiro numa subpasta?

  Sim. Cole o endereço completo, por exemplo example.com/docs/llms.txt. A proposta v2 permite ficheiros em qualquer caminho, e o checker assinala também as ligações que saem do caminho descrito por esse ficheiro.

• O checker é gratuito?

  Sim. Verificar um ficheiro é gratuito e não exige conta. A ferramenta lê um ficheiro público e as páginas a que este liga.

Verifique o seu llms.txt

Introduza um domínio e veja se o seu ficheiro é servido corretamente, segue a estrutura e não tem ligações mortas. Precisa de um ficheiro novo ou quer reconstruir um que falha? Use o gerador de llms.txt.