--- title: "Site estático no Cloudflare Pages: o caminho mais completo | Grupo Marfre" description: "Site estático no Cloudflare Pages para IA: arquivos na raiz, 404.html, _headers, _redirects, Pages Functions e Markdown for Agents. Veja o que configurar." canonical: https://grupomarfre.com.br/sites-agenticos/site-estatico-no-cloudflare-pages/ alternate_html: https://grupomarfre.com.br/sites-agenticos/site-estatico-no-cloudflare-pages/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Site estático no Cloudflare Pages: o caminho mais completo **Resposta rápida:** O Cloudflare Pages serve bem o site agêntico estático porque aceita arquivos na raiz (robots.txt, llms.txt, 404.html), cabeçalhos por \_headers, 301 por \_redirects e Pages Functions para entregar Markdown a quem pede. Dois pontos de atenção: sem 404.html o Pages devolve a home com status 200, e o Markdown for Agents só está disponível nos planos Pro, Business e Enterprise e para SSL for SaaS. O Cloudflare Pages é o caminho mais completo para um site agêntico estático porque reúne, no mesmo lugar, arquivos na raiz, cabeçalhos por caminho, redirecionamentos e código na borda (Pages Functions) para servir Markdown a quem pede. Cada peça tem um ponto de falha conhecido, e esta página mostra onde ele está. Os itens marcados como "na régua do Grupo Marfre" vêm de testes nos sites que a agência publica, e os marcados como "método do Grupo Marfre" descrevem como ela configura esses sites. O que o texto atribui à Cloudflare vem da documentação dela. ## O que vai na raiz da pasta publicada? Vão na raiz o `robots.txt`, o `sitemap.xml`, o `llms.txt` e o `llms-full.txt`, e os arquivos que o próprio Pages lê (`404.html`, `_headers` e `_redirects`). Os espelhos `.md` ficam ao lado de cada página. Como o site é estático, o que está na pasta é o que o robô recebe, sem JavaScript no meio. Atenção ao que sobe sem querer. Arquivo de ferramenta (README, configuração) vai no deploy junto com o resto. Na régua do Grupo Marfre, sem uma regra que barre esses arquivos, `/README` com cabeçalho de Markdown virava `/README.md` e saía inteiro para robô de IA. A prova é um teste que deve devolver 404. ## Por que o 404.html é obrigatório? Sem `404.html` na pasta, o Cloudflare Pages entra em modo SPA e devolve a home com HTTP 200 para qualquer endereço que não existe. Isso é um soft 404: o agente lê a home como se fosse a página pedida. Na régua do Grupo Marfre, o problema foi achado por controle negativo em 3 sites. O teste é um comando só: ```bash curl -s -o /dev/null -w "%{http_code}\n" https://www.exemplo.com.br/endereco-que-nao-existe ``` O resultado esperado é `404`. Se vier `200`, falta o arquivo. Veja o que o agente espera dessa resposta em [Página 404 que o agente entende](https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/). ## O que \_headers e \_redirects resolvem? O `_headers` define cabeçalhos por caminho, e o `_redirects` define os redirecionamentos. No método do Grupo Marfre, o `_redirects` leva os 301 dos caminhos em inglês (`/about`, `/contact`, `/privacy`) para as páginas em português. Exemplo fictício de `_redirects`: ``` /about /sobre/ 301 /contact /contato/ 301 /privacy /privacidade/ 301 ``` Exemplo fictício de `_headers` para arquivos `.md` servidos como estáticos: ``` /*.md X-Robots-Tag: noindex ``` Sobre o que o agente segue e o que quebra, leia [Redirecionamentos 301 limpos](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/). ## Como as Pages Functions servem Markdown? Uma Function na borda decide, a cada pedido, se a resposta é o HTML ou o espelho `.md`. É o item de middleware do método do Grupo Marfre. O modelo completo está em [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/). | Quem pede | Recebe | | --- | --- | | `Accept: text/markdown` | Espelho `.md` | | `?mode=agent` na URL | Espelho `.md` | | User-agent de robô de IA | Espelho `.md` | | Googlebot e Bingbot | HTML (a canônica) | Toda resposta leva `Vary: Accept, Accept-Encoding, User-Agent`, porque a regra decide também por user-agent, e um cabeçalho `Link` apontando o `.md`, o `llms.txt` e o sitemap. O navegador segue o `Vary` pelo padrão HTTP; segundo a documentação da Cloudflare, a borda dela só respeita o `Vary` configurado nas Cache Rules, no Vary for Images ou o `Accept-Encoding`. O `.md` leva `X-Robots-Tag: noindex` e fica fora do sitemap, porque seria conteúdo duplicado. Para endereço inexistente, a Function responde 404 em Markdown. Um cuidado no regex de user-agent: `claudebot` sozinho não casa `Claude-SearchBot` nem `Claude-User`. Use `claude-searchbot|claude-user` no padrão. E `Google-Extended` é token de robots.txt, não user-agent, então pô-lo no regex não faz nada. A prova em produção vem de [receitas com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/): ```bash curl -s -D - -o /dev/null -H "Accept: text/markdown" https://www.exemplo.com.br/ curl -s -D - -o /dev/null -A "GPTBot" https://www.exemplo.com.br/ curl -s -D - -o /dev/null -A "Googlebot" https://www.exemplo.com.br/ ``` Cada linha faz um GET normal e imprime só os cabeçalhos. Nos dois primeiros, o `content-type` deve ser `text/markdown`. No terceiro, `text/html`. ## E o Markdown for Agents da Cloudflare? É um recurso beta que converte o HTML em Markdown na borda quando o pedido manda `Accept: text/markdown`. Segundo a documentação da Cloudflare (atualizada em 09/10/2026), está disponível sem custo nos planos Pro, Business e Enterprise e para SSL for SaaS. Liga-se na seção AI Crawl Control da zona e só converte HTML. Na régua do Grupo Marfre, ele não foi testado, e não cobre user-agent de robô de IA nem `?mode=agent`. Quem precisa dessas duas portas continua com a Function. Detalhes em [Markdown for Agents da Cloudflare](https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/). ## O que o AI Crawl Control mostra? Mostra quais serviços de IA acessam o site e permite liberar ou bloquear por robô. Segundo a documentação da Cloudflare (14/08/2026), está disponível em todos os planos, e inclui o Pay Per Crawl, ainda em beta. Antes se chamava AI Audit. Use a tela como painel de conferência: ela mostra se os robôs de busca e de usuário chegam ao site. Qualquer regra de bloqueio criada ali precisa ser compatível com o robots.txt, que o método do Grupo Marfre mantém liberando busca e usuário de cada empresa de IA. ## Perguntas frequentes ### Preciso de plano pago para ter um site agêntico no Cloudflare Pages? Segundo a documentação da Cloudflare, o Markdown for Agents está disponível nos planos Pro, Business e Enterprise e para SSL for SaaS, e o AI Crawl Control, em todos os planos. A negociação por Function é código do próprio projeto. ### Posso usar o Markdown for Agents junto com a Function própria? Na régua do Grupo Marfre, o uso combinado não foi testado. Se for ligar os dois, rode os curl acima antes e depois, e confira se o Googlebot continua recebendo HTML. ### O que acontece se eu esquecer o 404.html? O Pages entra em modo SPA e responde a home com status 200 em qualquer endereço inexistente. O agente passa a ver páginas duplicadas da home, e o teste com curl em um endereço falso revela o problema. ### O robots.txt também fica na raiz da pasta? Sim. Ele fica na raiz, junto com o `sitemap.xml` e o `llms.txt`. Uma mudança nele pode levar até cerca de 24 horas para valer em alguns robôs, como Perplexity e Amazon. ## Fontes consultadas - [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/) - [developers.cloudflare.com/ai-crawl-control/](https://developers.cloudflare.com/ai-crawl-control/) ## Leia também ### [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/) Guia para montar a camada agêntica no Cloudflare Pages com Pages Functions (Markdown por Accept, Vary, Link, 404 em Markdown) e provar com curl. ### [Markdown for Agents da Cloudflare: o que é e quando usar](https://grupomarfre.com.br/sites-agenticos/markdown-for-agents-cloudflare/) Markdown for Agents da Cloudflare converte HTML em Markdown para quem pede Accept: text/markdown. Veja planos, limites e quando o espelho gerado é melhor. ### [Página 404 que o agente entende (e o soft 404 que engana)](https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/) Página 404 para agentes de IA: por que endereço inexistente deve responder 404 e não a home com 200, o caso do Cloudflare Pages e como testar com curl. ### [Como testar a camada agêntica com curl (receitas prontas)](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/) Receitas de curl para testar a camada agêntica: Accept text/markdown, ?mode=agent, GPTBot, Googlebot, Vary, Link, 404 e robots.txt, com a saída esperada. ### [Redirecionamentos 301 limpos: o que o agente segue e o que quebra](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/) Redirecionamento 301 para site agêntico: cadeia, 301 x 302, barra final, http para https e www. Veja o que o agente segue e como testar com curl -sIL. ### [Meu construtor de site não deixa mexer na raiz: e agora?](https://grupomarfre.com.br/sites-agenticos/construtor-sem-acesso-a-raiz/) Construtor de site sem acesso à raiz: veja o que ainda dá para fazer, quando um proxy na borda resolve e em que ponto vale migrar de plataforma. --- ## 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/site-estatico-no-cloudflare-pages/