Validador de llms.txt

O que o llms.txt faz — e o que não faz

llms.txt é uma proposta de convenção em Markdown para apresentar uma visão geral concisa do site e links selecionados. Não é uma política de robots, um acordo de licenciamento, um controle de autenticação nem um requisito universal de indexação por IA. O nome do site em um H1, um resumo útil e links organizados em Markdown ajudam os leitores a entender o site. A proposta não exige uma seção literalmente chamada Docs nem um resumo universal de 150 caracteres. A adoção varia conforme quem utiliza o arquivo; não afirme que todos os principais rastreadores de IA o leem.

Publique na raiz pública sem alterar o site

Disponibilize o arquivo em /llms.txt com uma resposta bem-sucedida contendo o texto pretendido, não uma página de erro HTML com o visual do site nem uma tela de login. Use o recurso de arquivos públicos compatível com seu CMS, um arquivo de hospedagem estática ou uma resposta de texto configurada explicitamente. Se a plataforma reservar caminhos na raiz, confirme um método de implantação oficialmente compatível antes de adicionar um plugin ou proxy. Verifique tanto o domínio personalizado quanto a prévia da hospedagem, pois redirecionamentos e caches podem se comportar de forma diferente.

Escolha um pequeno conjunto de páginas de destino úteis

Inclua links para páginas canônicas estáveis: visão geral do produto, preços, documentação, políticas de suporte e guias importantes. Use textos descritivos nos links e, opcionalmente, um contexto conciso para que o leitor saiba o que cada página aborda. Links HTTPS absolutos são uma escolha prática de publicação, não uma evidência de que links relativos causam automaticamente erros HTTP. Exclua painéis privados, páginas em rascunho, URLs de rastreamento e conteúdo obsoleto. Mantenha as informações vinculadas e as traduções atualizadas; não liste uma página apenas para aumentar o arquivo.

Verifique após a publicação e após mudanças importantes

Busque o arquivo implantado e examine o corpo da resposta, o status e o tipo de conteúdo; text/plain com conjunto de caracteres UTF-8 é um padrão sensato. Acesse os links de destino para confirmar que são públicos e relevantes. Compare o arquivo publicado com a versão que você pretendia implantar após a invalidação do cache. Um validador pode identificar problemas de formatação e de links, mas não pode provar que um mecanismo leu o arquivo ou que uma resposta futura citará seu site.

Interprete os avisos sem confundi-los com a especificação

Um validador local pode recomendar URLs absolutas, uma seção de documentação com um nome específico ou um resumo curto como verificações editoriais. Essas recomendações não são requisitos universais da proposta do llms.txt. Verifique o Markdown real e as páginas vinculadas e mantenha as preferências de acesso no robots.txt. A aprovação significa que as verificações realizadas não encontraram nenhum dos problemas listados; ela não certifica adoção por fornecedores, acessibilidade dos links, a menos que tenha sido testada, conformidade de licenciamento ou visibilidade futura em IA.

Evidências e próximas ações

Lista de verificação da implementação

• Confirme que seu CMS é compatível com o método escolhido para publicação em um caminho público na raiz.
• Use Markdown, não um modelo copiado de robots.txt.
• Descreva o que o site realmente oferece.
• Inclua URLs públicas estáveis e textos de link claros.
• Teste o domínio real após a implantação.
• Trate o arquivo como contexto opcional, não como garantia de citação.

Passo a passo

1. 1
   Estabeleça uma linha de base

   Salve a URL da página, a data, o idioma, o mercado-alvo e as perguntas exatas antes de editar. Registre o que a página realmente diz e o que cada resposta testada cita; uma menção sem link para a fonte não é uma citação.

2. 2
   Faça uma alteração coerente

   Resolva primeiro a falha mais evidente e depois verifique a página publicada, não apenas a prévia no editor. Mantenha um registro da implementação para que reformulações de design, campanhas ou mudanças no produto sem relação com esse trabalho não sejam confundidas com seus efeitos.

3. 3
   Repita e compare

   Repita as mesmas perguntas e verificações técnicas após a implantação. Mantenha os mecanismos e as condições de medição consistentes, informe o tamanho da amostra e examine a precisão das respostas junto com as citações. Uma única resposta não representa uma posição estável.