CookingMetrics Data-Driven Business
Martín Garay·2 de agosto de 2026·4 min de leituraIndexNowCloudflareGuias

Cloudflare Workers: publique sua chave IndexNow sem tocar na sua loja

O IndexNow exige uma prova de propriedade simples: um arquivo {chave}.txt respondendo na raiz do seu domínio — https://sualoja.com/a1b2c3….txt — com a chave como único conteúdo. Sem ele, cada envio volta com 403. Num servidor próprio são dois minutos. Numa plataforma SaaS, onde você não sobe arquivos à raiz nem toca o servidor, parece impossível. Não é: a solução vive na borda da rede.

O que é um Cloudflare Worker

Cloudflare é a rede que acelera e protege uma parte enorme da internet; se sua loja usa domínio próprio, seu DNS muito provavelmente já passa por ela. Um Worker é um mini-programa que roda nos servidores da Cloudflare, antes de o tráfego chegar à sua loja. Você pode dizer: "quando alguém pedir exatamente esta URL, responda você; deixe todo o resto passar".

Isso transforma o problema impossível em trivial: o arquivo da chave não precisa existir na sua loja — a Cloudflare responde por você.

A arquitetura que usamos (e por que é key-agnóstica)

O primeiro instinto seria escrever a chave dentro do código do Worker. Funciona, mas quebra elegante: se a chave girar (reinstalação, migração), é preciso editar a Cloudflare de novo. Nossa solução elimina essa manutenção para sempre:

  1. Rotas restritas: o Worker se conecta a seudominio.com/{chave}.txt e à variante www. Atenção à restrição da Cloudflare: o curinga só é aceito no final do path, então um padrão como /*.txt é rejeitado. A alternativa ampla é seudominio.com/*, que sobrevive à rotação da chave mas faz todo o tráfego do site passar pelo Worker.
  2. Filtro por formato: só atende nomes de arquivo com forma de chave (hexadecimal); robots.txt e o resto passam intactos à loja.
  3. Consulta ao vivo: numa requisição válida, o Worker pergunta à nossa API qual é a chave vigente do domínio e a serve como text/plain. Se a chave girar amanhã, o Worker serve a nova sem ninguém tocar em nada.

Custo: zero. O plano gratuito de Workers inclui 100.000 requests diários e essa URL recebe um punhado de visitas dos buscadores por semana.

O caso real que nos ensinou DNS: os registros A que engolem seu Worker

Durante o onboarding de uma loja real topamos com um fantasma: Worker perfeito, rotas corretas, e o domínio raiz devolvendo 404 enquanto o www funcionava impecável. A causa, invisível em qualquer tutorial: o domínio raiz tinha registros A apontando direto às IPs da plataforma. Com essa configuração, a Cloudflare roteia o tráfego do apex direto à infraestrutura SaaS da plataforma (que também usa Cloudflare) e a sua própria zona — Workers incluídos — fica bypassada, mesmo com o proxy ativo.

A correção é cirúrgica: substituir esses registros A por um CNAME @ → sualoja.mitiendanube.com com proxy ativado (como o www costuma estar). A mudança é instantânea, reversível, e a loja continua servindo igual — mas o tráfego agora passa pela SUA zona e seus Workers rodam. Se sua chave verifica no www mas não no domínio raiz, você já sabe onde olhar. O resto da configuração da Cloudflare que pesa na sua visibilidade — cache, firewall, bots de IA — está no nosso guia técnico de Cloudflare para SEO e GEO.

Fazer na mão vs. guiado

Tudo acima pode ser configurado manualmente em 10-15 minutos se você estiver confortável com a Cloudflare (e se não estiver, comece pelo guia de implementação sem jargão). O IndexNow Connect transforma isso num checklist: o guia integrado usa seu domínio e chave reais, mostra capturas de cada tela da Cloudflare, entrega o snippet pronto para colar, diagnostica ao vivo o que seu domínio está respondendo — incluindo o caso dos registros A — e verifica a chave automaticamente quando tudo fica no lugar.

Perguntas frequentes

O Worker deixa minha loja mais lenta?

Não. Com rotas restritas, o Worker só roda quando alguém pede o arquivo da chave; o resto do tráfego nem passa por ele — e essa URL recebe um punhado de visitas de buscadores por semana.

Preciso do plano pago da Cloudflare?

Não: o plano gratuito inclui 100.000 requests de Workers por dia, milhares de vezes mais do que essa URL vai consumir.

O que acontece se minha chave IndexNow girar?

Nada: a arquitetura é key-agnóstica. O Worker consulta a chave vigente a cada requisição, então uma rotação (reinstalação, migração) nunca exige tocar na Cloudflare.

Isso serve para qualquer plataforma SaaS?

Sim, desde que seu domínio use a Cloudflare como DNS: a condição é poder criar a rota do Worker na sua zona. O diagnóstico ao vivo do IndexNow Connect mostra se seu domínio está pronto.

Conecte sua loja grátis → — o plano gratuito inclui o guia completo e 500 URLs por mês.