O Que e llms.txt? -- Formato, Informações Necessárias e Geração Dinâmica Explicados [Estratégia LLMO]

A era da busca por IA chegou. ChatGPT com busca na web, Perplexity, Google AI Overviews -- as oportunidades de os usuários obterem informações por meio de IA estão crescendo rapidamente, e a importância de "fazer a IA entender corretamente o seu site" está cada vez maior.

É aí que entra o llms.txt. Se o robots.txt diz aos rastreadores "você pode / não pode rastrear esta página", o llms.txt é uma placa de orientação que diz à IA "é isto que este site cobre, e os detalhes estão aqui". Porém, não há evidência de que publicá-lo faça seu site ser citado em respostas de IA, e nos logs de acesso deste site nenhum rastreador de IA o buscou nem uma vez em três dias e meio. Este guia mostra também em que tipo de site vale a pena adicioná-lo.

Neste artigo, explicamos em detalhes o formato do llms.txt, quais informações incluir, os critérios para decidir entre arquivo estático e geração dinâmica, e código de implementação para os principais frameworks.

1. O Que é llms.txt

O llms.txt é um arquivo de texto puro (formato Markdown) colocado no diretório raiz do site, cujo objetivo é informar aos LLMs (Modelos de Linguagem de Grande Escala) a visão geral, a estrutura e a lista de conteúdos do site.

Informações Básicas

Em Uma Frase

robots.txt = "Não entre" / llms.txt = "Nosso site é assim"

Enquanto o robots.txt é um arquivo de controle de acesso (permitir/bloquear), o llms.txt é um arquivo de descrição do conteúdo do site (autoapresentacao). Os dois não entram em conflito -- na verdade, são feitos para serem usados juntos.

2. Por Que é Necessário -- Diferença em Relação ao robots.txt

"Mas se eu já tenho sitemap e meta tags, a IA não consegue entender meu site?" -- você pode pensar assim. É verdade, mas o llms.txt tem vantagens próprias.

Comparação de Funções: robots.txt / sitemap.xml / llms.txt

3 Razões Pelas Quais o llms.txt é Necessário

Razão 1: LLMs não conseguem rastrear todo o site de forma eficiente

O Googlebot rastreia bilhões de páginas e constrói um índice massivo, mas os crawlers de LLM não são tão abrangentes. Ao colocar o llms.txt, você pode informar a IA de forma eficiente: "os conteúdos mais importantes deste site são estes".

Motivo 2: Faz as respostas de IA citarem você -- algo muito repetido, mas sem evidência

É comum ler que o llms.txt aumenta as chances de o ChatGPT ou o Perplexity citarem seu site, mas não há dados nem declarações oficiais dos fornecedores que mostrem isso. O Google diz explicitamente que não são necessários arquivos de texto para IA para aparecer no AI Overviews ou no AI Mode (Google Search Central). É mais correto ver o llms.txt como um sumário que ajuda os agentes a chegar rápido à informação certa do que como um jeito de ganhar citações; a seção 9 confere isso com logs reais.

Para uma explicação detalhada sobre LLMO, confira "O Que é LLMO?".

Razão 3: Permite transmitir metainformacoes que o sitemap.xml não tem

O sitemap.xml é apenas uma lista de URLs. Com o llms.txt, você também pode informar:

• Tema e área de especialidade do site
• Resumo e categoria de cada conteúdo
• Frequência de atualização e tamanho do site
• Se há suporte multilinguistico
• Informações de contato

3. Especificação do Formato -- O Que Escrever e Como

O llms.txt é escrito em formato Markdown. O formato baseado na especificação do llmstxt.org e o seguinte:

Estrutura Básica

# Nome do Site

> Descricao geral do site. Em 1 a 3 frases, informe de forma concisa o tema, o publico-alvo e o valor oferecido.

## Nome da Secao 1

- [Titulo da Pagina](URL): Resumo da pagina

## Nome da Secao 2

- [Titulo da Pagina](URL): Resumo da pagina
- [Titulo da Pagina](URL): Resumo da pagina

Regras do Formato

Exemplo Real

# My Tech Blog

> My Tech Blog is a software engineering blog covering web development, cloud infrastructure, and AI tools. Updated weekly with practical tutorials and comparisons.

## Main Sections

- [Articles](https://example.com/articles): 50+ in-depth technical articles
- [Tutorials](https://example.com/tutorials): Step-by-step coding tutorials

## Popular Articles

- [React vs Vue in 2026](https://example.com/articles/react-vs-vue): A detailed comparison of React and Vue.js for modern web development, covering performance, ecosystem, and learning curve.
- [Docker for Beginners](https://example.com/articles/docker-beginners): Complete guide to Docker containers for developers who have never used containerization.

## Site Information

- URL: https://example.com
- Sitemap: https://example.com/sitemap.xml
- Languages: en, ja
- Contact: admin@example.com

Pontos de Atenção

• Escrever em inglês por padrão. A especificação e os exemplos do llms.txt são em inglês, tornando essa a melhor prática. Para sites multilinguisticos, escreva em inglês e especifique os idiomas suportados com Languages: ja, en, es, .... Porém, para sites em um único idioma (por exemplo, um site inteiramente em francês ou russo), escrever no idioma do site é perfeitamente aceitável. Os principais LLMs (GPT, Claude, Gemini, etc.) processam a maioria dos idiomas com alta precisão, e os usuários desses sites farao consultas no mesmo idioma, garantindo respostas consistentes.
• A codificação deve ser UTF-8. Com Shift-JIS ou outras codificacoes, os caracteres podem ficar corrompidos
• URLs devem ser caminhos absolutos (URLs completas começando com https://)
• Apenas um H1 por arquivo. Use H2 para dividir as seções

4. Informações a Incluir -- Obrigatórias, Recomendadas e Opcionais

Muitas pessoas ficam em dúvida sobre o que escrever, então organizamos por prioridade.

Observe que a especificação (llmstxt.org) exige apenas o H1 com o nome do site; o bloco de citação com o resumo e as listas de links sob H2 são formalmente opcionais. "Obrigatório" aqui significa o mínimo que este guia considera necessário para o arquivo valer a pena.

Informações Obrigatórias (sem elas, o llms.txt perde o sentido)

Informações Recomendadas (melhoram a compreensão da IA)

Informações Opcionais (desejaveis, mas não obrigatórias)

• Stack tecnológico: com o que o site foi construído (framework etc.)
• Frequência de atualização: com que frequência novos conteúdos são adicionados
• Quantidade total de conteúdos: número de artigos etc.
• Licença / política de citação: se a IA pode citar ou não
• Informações de API: se houver acesso programático disponível

Informações Que Não Devem Ser Incluídas

• Informações confidenciais: URLs do painel de administração, endpoints de APIs internas etc.
• Dados pessoais: informações pessoais além do necessário (endereço, telefone etc.)
• Credenciais: chaves de API, senhas etc.

5. Diferença Entre llms.txt e llms-full.txt

O llms-full.txt reúne todo o conteúdo de um site em um único arquivo. Ele não faz parte da especificação do llmstxt.org: é uma convenção que se espalhou porque plataformas de documentação como a Mintlify o geram automaticamente junto com o llms.txt (documentação da Mintlify). A especificação v2 recomenda, em vez de juntar tudo em um arquivo, oferecer uma versão em Markdown de cada página (page.md ou page.html.md) e linká-la a partir do llms.txt.

Quando o llms-full.txt é Necessário

• Documentação técnica: referências de API, documentação de bibliotecas etc., onde ter a IA entendendo o texto completo melhora a precisão das respostas
• Base de conhecimento: colecoes de FAQ, glossários etc., conteúdos que são frequentemente citados em fragmentos

Quando o llms-full.txt Não é Necessário

• Blogs e sites de mídia: com muitos artigos, colocar tudo em um único arquivo ficaria gigantesco. O resumo do llms.txt é suficiente
• E-commerce: informações de produtos são melhor fornecidas via dados estruturados (JSON-LD etc.)
• Sites corporativos: com poucas páginas, o llms.txt sozinho já cobre tudo

Para blogs e sites de mídia em geral, o llms.txt sozinho é suficiente. Pense no llms-full.txt como algo voltado para documentação técnica.

6. Arquivo Estático vs Geração Dinâmica -- Qual Escolher

Existem duas formas principais de operar o llms.txt.

Método 1: Arquivo Estático

Colocar um arquivo de texto diretamente em public/llms.txt (ou caminho equivalente).

Vantagens:

• Implementação mais simples possível (basta colocar o arquivo)
• Zero carga no servidor
• Funciona sem framework

Desvantagens:

• Precisa atualizar o arquivo manualmente toda vez que adicionar ou modificar conteúdo
• Se esquecer de atualizar, informações desatualizadas serão passadas a IA
• A quantidade de conteúdos e categorias fica divergente entre o arquivo e o site real

Método 2: Geração Dinâmica

A aplicação recebe a requisição para /llms.txt e gera o texto dinamicamente, buscando as informações mais recentes do banco de dados.

Vantagens:

• Informações sempre atualizadas
• Ao adicionar um artigo, ele é refletido automaticamente no llms.txt
• Quantidade de conteúdos e nomes de categorias sempre precisos

Desvantagens:

• Requer esforço de implementação (definição de rota + controller)
• Acesso ao banco de dados a cada requisição (pode ser mitigado com cache)
• Necessita de framework

Critérios de Decisão

Conclusão: na dúvida, geração dinâmica. O custo inicial de implementação é maior, mas como você pode "configurar e esquecer", o custo operacional a longo prazo é menor. O pior cenário e começar com arquivo estático e "esquecer de atualizar, passando informações desatualizadas para a IA".

7. Implementação -- Exemplos de Código por Framework

A partir daqui, apresentamos como implementar a geração dinâmica do llms.txt nos principais frameworks.

Laravel (PHP)

Definição de rota (routes/web.php):

use App\Http\Controllers\LlmsTxtController;

Route::get('/llms.txt', [LlmsTxtController::class, 'index']);

Controller (app/Http/Controllers/LlmsTxtController.php):

class LlmsTxtController extends Controller
{
    public function index()
    {
        $articles = Article::published()
            ->with(['translations' => fn($q) => $q->where('locale', 'en')])
            ->orderBy('published_at')
            ->get();

        $lines = [];
        $lines[] = '# My Site Name';
        $lines[] = '';
        $lines[] = '> Site description here.';
        $lines[] = '';
        $lines[] = '## All Articles (' . $articles->count() . ')';
        $lines[] = '';

        foreach ($articles as $article) {
            $t = $article->translations->first();
            if (!$t) continue;
            $url = 'https://example.com/en/articles/' . $article->slug;
            $lines[] = '- [' . $t->title . '](' . $url . '): ' . $t->meta_description;
        }

        $content = implode("\n", $lines);
        return response($content, 200)
            ->header('Content-Type', 'text/plain; charset=utf-8');
    }
}

O ponto importante é declarar explicitamente Content-Type: text/plain; charset=utf-8. Se não fizer isso, pode ser interpretado como HTML.

Django (Python)

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('llms.txt', views.llms_txt, name='llms_txt'),
]

# views.py
from django.http import HttpResponse
from .models import Article

def llms_txt(request):
    articles = Article.objects.filter(
        status='published'
    ).order_by('published_at')

    lines = ['# My Site', '', '> Description.', '', '## Articles', '']
    for a in articles:
        lines.append(f'- [{a.title}](https://example.com/articles/{a.slug}): {a.meta_description}')

    content = '\n'.join(lines)
    return HttpResponse(content, content_type='text/plain; charset=utf-8')

Next.js (TypeScript)

// app/llms.txt/route.ts (App Router)
import { NextResponse } from 'next/server'

export async function GET() {
  // Buscar dados do DB ou CMS
  const posts = await getAllPosts()

  const lines = [
    '# My Site',
    '',
    '> Description.',
    '',
    '## Articles',
    '',
    ...posts.map(p =>
      `- [${p.title}](https://example.com/posts/${p.slug}): ${p.description}`
    ),
  ]

  return new NextResponse(lines.join('\n'), {
    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
  })
}

WordPress (PHP)

Adicionar no functions.php ou como plugin:

// functions.php
add_action('init', function() {
    add_rewrite_rule('^llms\.txt$', 'index.php?llms_txt=1', 'top');
});

add_filter('query_vars', function($vars) {
    $vars[] = 'llms_txt';
    return $vars;
});

add_action('template_redirect', function() {
    if (!get_query_var('llms_txt')) return;

    header('Content-Type: text/plain; charset=utf-8');
    $posts = get_posts(['numberposts' => -1, 'post_status' => 'publish']);

    echo "# " . get_bloginfo('name') . "\n\n";
    echo "> " . get_bloginfo('description') . "\n\n";
    echo "## Articles (" . count($posts) . ")\n\n";

    foreach ($posts as $post) {
        $url = get_permalink($post);
        $desc = get_the_excerpt($post);
        echo "- [{$post->post_title}]({$url}): {$desc}\n";
    }
    exit;
});

No caso do WordPress, não esqueça de salvar novamente as configurações de permalink (flush das regras de rewrite).

Geradores de Sites Estáticos (Hugo / Astro etc.)

Escreva um script para gerar automaticamente durante o build.

# build-llms-txt.sh (exemplo para Hugo)
#!/bin/bash
echo "# My Site" > public/llms.txt
echo "" >> public/llms.txt
echo "> Site description." >> public/llms.txt
echo "" >> public/llms.txt
echo "## Articles" >> public/llms.txt
echo "" >> public/llms.txt

for file in content/posts/*.md; do
  title=$(grep '^title:' "$file" | sed 's/title: //')
  slug=$(basename "$file" .md)
  desc=$(grep '^description:' "$file" | sed 's/description: //')
  echo "- [${title}](https://example.com/posts/${slug}): ${desc}" >> public/llms.txt
done

Se executar no pipeline de CI (GitHub Actions etc.) antes do build, o arquivo será atualizado automaticamente a cada deploy.

8. Verificação e Validação Após a Instalação

Depois de instalar o llms.txt, verifique os seguintes pontos.

Checklist Básico

Verificações Adicionais para Geração Dinâmica

• Confira o llms.txt após adicionar um artigo: o novo artigo está refletido?
• A contagem de conteúdos está correta: o número em "All Articles (27)" bate com a quantidade real de artigos publicados?
• Artigos não publicados não estão aparecendo: confirme que rascunhos e agendamentos não são exibidos

Ferramentas de Validação

Não existe um validador oficial do formato llms.txt (em 29 de setembro de 2026). O Lighthouse do Chrome tem um item de llms.txt entre as auditorias de "agentic browsing", mas ele só verifica se buscar o arquivo retorna um erro de servidor; se o arquivo não existe (404), a auditoria fica como não aplicável (Chrome for Developers). Confira o conteúdo com os métodos abaixo.

• Pedir para ChatGPT ou Claude lerem: pergunte "Leia https://seusite.com/llms.txt e me conte sobre este site"
• Previsualizador de Markdown: cole o conteúdo do llms.txt em um previsualizador para verificar se a estrutura renderiza corretamente
• Ferramentas de auditoria SEO: algumas ferramentas de auditoria SEO já estão começando a verificar a existência do llms.txt

9. Medição real: os rastreadores de IA leem o llms.txt?

Costuma-se dizer que "é só publicar que a IA lê", mas se algo realmente busca o arquivo dá para verificar nos logs de acesso do seu próprio servidor. Este site (arte.itlibra.com) serve um /llms.txt gerado dinamicamente, então contamos as requisições por User-Agent entre 26 de setembro, 07:20, e 29 de setembro, 12:54 UTC (cerca de três dias e meio, 86.696 requisições no total).

Nesse período, o /llms.txt foi requisitado só três vezes: duas pela linha de comando (curl) e uma por uma ferramenta de auditoria de sites. Os rastreadores de IA leram artigos centenas de vezes, mas não abriram o llms.txt nenhuma vez. Muitos deles consultaram o robots.txt, então não é que ignorem arquivos pequenos: eles simplesmente não procuram o llms.txt.

São três dias e meio de logs de um único site, e outros sites ou períodos mais longos podem mostrar outro resultado. Ainda assim, somado às declarações oficiais, o quadro fica claro.

• Google: afirma que "You don't need to create new machine readable files, AI text files, or markup" (não é preciso criar novos arquivos legíveis por máquina, arquivos de texto para IA nem marcação) para aparecer no AI Overviews ou no AI Mode (AI features and your website)
• A especificação (v2, agosto de 2026): prevê que o llms.txt seja usado no momento da inferência, quando um agente precisa de informação enquanto ajuda um usuário, mais do que no treinamento, e diz que quem mais o usa são agentes de programação percorrendo documentação de software (llmstxt.org)
• Lighthouse do Chrome: as auditorias de "agentic browsing" incluem o llms.txt, mas uma página só falha se buscar o arquivo retornar erro de servidor. Se ele não existe (404), fica como não aplicável e não perde nada (Chrome for Developers)

Como decidir se vale a pena adicionar

Se você adicionar, seus próprios logs são o jeito confiável de saber se ele é usado. Em logs de acesso no formato padrão do nginx ou do Apache (combined), esta linha conta os User-Agents que requisitaram o /llms.txt, do mais frequente ao menos.

grep ' /llms.txt ' access.log | awk -F'"' '{print $6}' | sort | uniq -c | sort -rn

10. Exemplos Reais de llms.txt em Sites

OpenAI, Anthropic e Google (Gemini API) publicam um llms.txt para a própria documentação de desenvolvedores (conforme a página da especificação). Não encontramos estatísticas de taxa de adoção, então a tabela abaixo é só uma indicação de tendência.

Características dos Sites Que Estão Adotando

Características de um Bom llms.txt

• Resumo conciso e claro -- a área de especialidade do site e compreendida de imediato
• Todo o conteúdo listado com resumos -- a IA consegue entender a visão completa
• Estrutura de categorias explícita -- a organização da informação fica clara
• Geração dinâmica -- sempre atualizado

Características de um llms.txt Ruim

• Apenas nome do site e contato -- informação insuficiente para ajudar a IA a entender
• Texto completo de todo o conteúdo copiado -- o llms.txt é um "sumário", não o "texto completo". O texto completo e função do llms-full.txt
• Informações desatualizadas abandonadas -- como dizer "10 artigos" quando na verdade há 50, prejudicando a confiabilidade
• Informações confidenciais incluídas -- casos em que URLs do painel admin ou chaves de API aparecem no arquivo

FAQ