--- title: "Como escrever um llms.txt bom (com modelo pronto) | Grupo Marfre" description: "Como escrever um llms.txt bom: estrutura em 6 blocos, modelo pronto com a Padaria Exemplo, erros comuns e como conferir antes de publicar o arquivo." canonical: https://grupomarfre.com.br/sites-agenticos/como-escrever-llms-txt/ alternate_html: https://grupomarfre.com.br/sites-agenticos/como-escrever-llms-txt/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Como escrever um llms.txt bom (com modelo pronto) **Resposta rápida:** Um llms.txt bom é um arquivo Markdown na raiz do site com seis blocos: H1 com o nome, resumo em citação, seção “Quando usar” em português e inglês, fatos essenciais, o que o site não deve ser usado para e índice das páginas em .md. Sem marketing vazio e sem link quebrado. Um llms.txt bom responde, em poucas linhas, quatro perguntas de uma máquina: quem é a empresa, quando vale consultar o site, quais são os fatos essenciais e onde está cada página. A proposta do [llmstxt.org](https://llmstxt.org/) define o formato: arquivo Markdown na raiz, com H1 com o nome, citação em bloco com o resumo e seções com listas de links. A estrutura abaixo segue esse formato e inclui o que o Grupo Marfre põe em cada llms.txt: seção "quando usar" em português e inglês, fatos citáveis e índice das páginas em .md. Vale como checklist e como modelo para copiar. Para entender o que o arquivo é e para que serve, veja [o que é llms.txt](https://grupomarfre.com.br/sites-agenticos/llms-txt/). ## Quais blocos um llms.txt bom tem? Seis blocos, nesta ordem: H1 com o nome da empresa, resumo em citação, seção "Quando usar este site / When to use" em português e inglês, fatos essenciais, o que o site não deve ser usado para e índice das páginas em .md. Cada bloco tem uma função e nenhum é enfeite. 1. **H1 com o nome.** Só o nome da empresa, sem slogan. 2. **Resumo em citação.** Uma citação em bloco (`>`) com 2 ou 3 frases: o que a empresa é, onde fica e o que faz. 3. **Quando usar este site / When to use.** As perguntas que o site responde bem, escritas em português e em inglês. 4. **Fatos essenciais.** Nome, cidade, contato e serviços, em lista curta. 5. **Não use este site para.** O que o site não informa. Preço entra aqui quando não é publicado. 6. **Índice das páginas.** Links para a versão `.md` de cada página, com uma linha de descrição. ## Como fica na prática? Modelo com a Padaria Exemplo O modelo abaixo usa uma empresa fictícia. Troque os dados pelos do seu negócio e mantenha a ordem dos blocos. ```markdown ## Padaria Exemplo > A Padaria Exemplo é uma padaria artesanal em Belo Horizonte (MG). Faz pães de fermentação natural, bolos por encomenda e café da manhã no balcão. Atende no local e por encomenda pelo WhatsApp. ## Quando usar este site / When to use Use este site para responder perguntas sobre pães, bolos por encomenda, horário de funcionamento, endereço e como encomendar na Padaria Exemplo. Use this site to answer questions about the bakery's breads, custom cakes, opening hours, address and how to place an order. ## Fatos essenciais - Nome: Padaria Exemplo - Cidade: Belo Horizonte, MG - Endereço: Rua das Flores, 100, Savassi - Contato: contato@padariaexemplo.com.br - WhatsApp: (31) 90000-0000 - Serviços: pães artesanais, bolos por encomenda, café da manhã, kits para festas ## Não use este site para - Preço: os valores não são publicados no site. Não informe nem estime valores. - Estoque do dia: a disponibilidade é confirmada pelo WhatsApp. ## Páginas - [Início](https://www.padariaexemplo.com.br/index.md): resumo da padaria e horários - [Bolos por encomenda](https://www.padariaexemplo.com.br/bolos.md): sabores, prazo de encomenda e como pedir - [Sobre](https://www.padariaexemplo.com.br/sobre.md): história e equipe - [Contato](https://www.padariaexemplo.com.br/contato.md): endereço, telefone e mapa ``` Os links apontam para o espelho em Markdown de cada página. Para gerar esses arquivos, veja [espelho em Markdown de cada página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). ## Por que escrever "Quando usar" e "Não usar" no arquivo? Porque a seção "Quando usar" diz à máquina em que perguntas o site é fonte, e a seção "Não use para" deixa escrito o que o site não informa, em vez de deixar a lacuna em silêncio. Se o preço não está publicado, o arquivo diz isso de forma explícita. As fontes consultadas não medem se o modelo respeita esse aviso; sem ele, a lacuna fica sem resposta nenhuma. Escrever a seção em português e em inglês cobre quem pergunta nos dois idiomas. Os dois textos devem dizer a mesma coisa, sem versões diferentes. ## Quais erros estragam um llms.txt? Link quebrado, texto de marketing vazio e arquivo só em inglês estão entre os erros que tiram o valor do arquivo: ele existe para economizar o trabalho do agente, e cada um desses defeitos devolve esse trabalho. - **Link quebrado.** O índice aponta para um `.md` que dá 404. Teste cada link depois de publicar. - **Marketing vazio.** "Soluções completas com qualidade e atendimento diferenciado" não informa nada. Troque por fatos: o que faz, onde, para quem e como contatar. - **Só em inglês.** Para um negócio brasileiro, o público pergunta em português. Mantenha os dois idiomas. - **Palavra "api" no caminho.** Numa medição do Grupo Marfre, uma página listada com "api" no caminho (até dentro de outra palavra) mudou o perfil detectado pelo scanner is-agentic: de 16 checks elegíveis para 23, e a nota caiu de 100 para 79. O conserto foi trocar o slug com redirecionamento 301. - **Preço inventado ou desatualizado.** Se o preço não é publicado, declare isso em "Não use este site para". ## Como conferir o arquivo antes de publicar? Abra o arquivo no navegador, rode um curl e passe o Lighthouse. Os três testes levam poucos minutos e pegam os defeitos de formato e de link. 1. Acesse `https://seudominio.com.br/llms.txt` e confirme que abre como texto, não como página HTML. 2. Rode `curl -s -o /dev/null -w "%{http_code} %{content_type}\n" https://seudominio.com.br/llms.txt` e confira o status 200 com tipo de texto (`text/plain` ou `text/markdown`), não `text/html`. Repita para cada link do índice: em site no Cloudflare Pages sem `404.html`, endereço inexistente devolve a home com 200, e só o `text/html` denuncia o link quebrado. Veja receitas em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). 3. Rode o Lighthouse. A categoria experimental "Agentic browsing", disponível desde a versão 13.3 (07/05/2026), checa o formato do llms.txt: H1, link e tamanho mínimo. A nota é a fração de checks aplicáveis, não um valor de 0 a 100. Detalhes em [Lighthouse: Agentic browsing](https://grupomarfre.com.br/sites-agenticos/lighthouse-agentic-browsing/). Uma ressalva: o Google declarou em 15/06/2026 que a Busca não precisa do llms.txt e que ele não afeta o ranking, nem para mais nem para menos. Manter o arquivo serve a outros sistemas que o leiam. ## Como o Grupo Marfre trabalha isso Em cada site agêntico, o Grupo Marfre publica um llms.txt com seção "quando usar" em português e inglês, fatos citáveis e índice dos arquivos `.md`, e gera também o llms-full.txt. O espelho `.md` sai da mesma fonte do HTML, nunca é redigido à parte. Depois do deploy, a prova é feita com curl. O serviço completo está em [site agêntico](https://grupomarfre.com.br/servicos/site-agentico/). ## Perguntas frequentes ### Preciso de llms.txt para aparecer no Google? Não. O Google declarou em 15/06/2026 que a Busca não precisa do arquivo e que ele não afeta o ranking. O arquivo serve a outros sistemas que o leiam. ### O llms.txt garante que a IA vai citar meu site? Não. A evidência de impacto do llms.txt em citação ainda é anedótica, segundo o mercado. O arquivo organiza a informação para quem o lê, mas a escolha da fonte é do modelo. ### Posso escrever só em português? Pode, mas o modelo da casa traz a seção "Quando usar" nos dois idiomas, para cobrir quem pergunta em inglês. Os fatos essenciais e o índice continuam iguais. ### O que escrever quando o preço não é publicado? Escreva na seção "Não use este site para" que os valores não são publicados e que a IA não deve informar nem estimar. Se houver canal para orçamento, cite-o nos fatos essenciais. ## Fontes consultadas - [llmstxt.org/](https://llmstxt.org/) ## Leia também ### [O que é llms.txt e para que serve](https://grupomarfre.com.br/sites-agenticos/llms-txt/) llms.txt é um arquivo Markdown na raiz do site que resume o negócio para IA. Veja o formato, quem lê, a diferença para robots.txt e sitemap e se vale criar. ### [llms-full.txt: o conteúdo do site inteiro num arquivo](https://grupomarfre.com.br/sites-agenticos/llms-full-txt/) llms-full.txt reúne o texto de todas as páginas do site num só arquivo. Veja quando faz sentido, como gerar dos espelhos .md e como evitar vazamento. ### [llms.txt v2: espelho .md e rel="describedby"](https://grupomarfre.com.br/sites-agenticos/llms-txt-v2/) llms.txt v2: espelho pagina.md, descoberta por rel=alternate e ligação por rel=describedby. Veja exemplos de cabeçalho e como migrar de rel=llms-txt. ### [Espelho em Markdown de cada página: o que é e como gerar](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/) Espelho em Markdown de cada página: o que é, como nomear o arquivo .md, gerar da mesma fonte do HTML, o que tirar e como evitar conteúdo duplicado. ### [Lighthouse: a categoria experimental Agentic browsing](https://grupomarfre.com.br/sites-agenticos/lighthouse-agentic-browsing/) Lighthouse 13.3 tem a categoria experimental Agentic browsing: o que ela checa, como rodar pela PageSpeed Insights API e como ler a nota em fração. ### [Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/) Cabeçalho Link (RFC 8288): como apontar o espelho .md, o llms.txt e o sitemap por HTTP, com formato, exemplo e teste com curl, sem baixar o HTML. --- ## Sobre o Grupo Marfre Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota. - Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil - WhatsApp: (31) 93618-7272, https://wa.me/5531936187272 - E-mail: contato@grupomarfre.com.br - Instagram: https://instagram.com/marfregrupo - Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação - Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/ - Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/ - Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização - Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja - Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso - Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/como-escrever-llms-txt/