Dev & EngARTIGO

O seu site existe para a IA? Comece pelo terminal

Um site pode funcionar normalmente no navegador e ainda estar inacessível para crawlers de IA. O artigo apresenta testes de terminal para identificar bloqueios por firewall ou CDN e verificar se o conteúdo está no HTML enviado pelo servidor. Também explica a ordem das verificações de GEO Técnico: acesso, leitura, interpretação e medição.

O seu site existe para a IA? Comece pelo terminal
Imagem: Leandro Vieira
O seu site existe para a IA↳Inteligência artificial440 conteúdosUX e IA: Transformando Experiências Digitais com Inteligência ArtificialProduto & UX · jan 2025MCP: O que é e por que você vai ouvir falar disso em breve?AI · jul 2025IA generativa e a urgência de reconstruir nossa relação com a verdadeAI · jun 2025Ver tudo em AI →? Comece pelo terminal

Abra um terminal e rode estes dois comandos apontando para um site que você mantém:

curl -sI -A "Mozilla/5.0" https://seusite.com.br | head -1

curl -sI -A "GPTBot" https://seusite.com.br | head -1

Se o primeiro devolve 200 e o segundo devolve 403, 429 ou 503, o seu site está bloqueando robôs de IA na porta de entrada. E, na maioria dos casos que vejo, ninguém decidiu isso. O firewall, a CDN ou o plugin de segurança decidiram por você.

Agora o segundo teste:

curl -s https://seusite.com.br | perl -0777 -pe 's/<(script|style)[^>]*>.*?<\/\1>//gis; s/<[^>]+>//g' | tr -s '[:space:]' ' ' | wc -c

Se o resultado é um número pequeno demais para o conteúdo que você vê no navegador, o texto do site só existe depois que o JavaScript roda. E a maioria dos crawlers de IA não executa JavaScript.

Esses dois testes levam trinta segundos e resumem um problema que a maior parte dos times de engenharia ainda não colocou no backlog: o site pode estar perfeito para humanos e, ao mesmo tempo, não existir para as máquinas que hoje respondem perguntas no lugar do buscador.

A pergunta mudou

Durante duas décadas, otimizar um site significava responder a uma pergunta: como ele aparece no Google? Essa pergunta está sendo substituída por outra: como a marca aparece quando uma IA responde?

ChatGPT, Gemini, Perplexity, Claude e os modos de IA dos buscadores não entregam uma lista de links. Entregam uma resposta. Para compor essa resposta, eles precisam ter acessado, lido e interpretado as fontes. 

Se o seu site falha em qualquer uma dessas três etapas, ele não é fonte. Não aparece na resposta, não é citado, não recebe o clique que sobra.

E o clique que sobra vale mais. 

Em novembro de 2025, dados do Microsoft Clarity apontaram que visitantes vindos de respostas de IA convertem cerca de três vezes mais que visitantes de outros canais. 

Menos volume, muito mais intenção.

GEO é a sigla para Generative Engine Optimization, a otimização para motores generativos. 

Dentro dela, chamo de GEO Técnico o recorte que trata do que o desenvolvedor controla: código, servidor, configuração. Não é sobre narrativa e nem sobre marca. É engenharia.

Três verbos, uma ordem

A definição que uso é curta: GEO Técnico é garantir que a IA consiga acessar, ler e interpretar o seu site.

Os três verbos não são sinônimos. São dependências sequenciais:

  • A IA só lê o que conseguiu acessar.
  • A IA só interpreta o que conseguiu ler.

É um funil, e a ordem não é negociável. 

Um schema JSON-LD impecável não vale nada se o robots.txt bloqueia o GPTBot. Um conteúdo excelente não vale nada se ele só existe no DOM renderizado. Muita equipe começa pelo schema porque é o que aparece nas ferramentas de SEO↳SEO4 conteúdosPor que a transição do SEO clássico para a Otimização de Motores Generativos (GEO) exige que se repense a modelagem semânticaMarketing Tech · mai 2026O impacto da pesquisa e do SEO no comércio eletrônico: insights da State of Search Brasil 5Marketing Tech · fev 2025SEO por Elas 2025: Impulsionando e promovendo mulheres no Marketing DigitalMarketing Tech · fev 2025Ver tudo em Marketing Tech →, e descobre meses depois que o crawler nunca passou da porta.

Acima dos três verbos existe um quarto, que é o resultado: agir. 

Quando o site é acessível, legível e interpretável, ele passa a ser operável por agentes de IA, software que não só consome informação, mas preenche formulários e navega fluxos. Abaixo dos três verbos existe uma camada transversal: medição. O que não é medido não é gerido, e sem medição cada correção vira opinião.

A falha mais comum é silenciosa

Dos problemas que encontro em auditorias, o mais frequente também é o mais invisível: o robots.txt libera o crawler, mas o WAF ou a CDN devolvem 403 para o user-agent dele.

Acontece porque regras de proteção contra bots classificam GPTBot, ClaudeBot, PerplexityBot e companhia como tráfego malicioso. O site funciona normalmente no navegador, o Search Console não reclama, o Lighthouse dá nota verde. E o site está fechado para IA há meses.

O teste é o do início do artigo, repetido para cada user-agent que você quer permitir. A lista relevante hoje inclui GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, Applebot-Extended, Meta-ExternalAgent, Amazonbot e CCBot. Ela muda com frequência, então trate como configuração versionada no repositório, não como conhecimento de cabeça.

O segundo problema mais frequente é o que chamo de Response versus Render. O servidor responde um HTML; o navegador renderiza um DOM depois do JavaScript. 

Humanos veem o render. A maioria dos crawlers de IA vê só a response. SPA sem SSR, tema montado por page builder que injeta texto via JS, bloco que busca conteúdo por API no client: tudo isso pode estar perfeito na tela e vazio na resposta bruta.

O teste é ainda mais simples que o do terminal: desative o JavaScript no navegador e recarregue a página. O que sumiu não existe para a máquina.

Isso não é problema só de WordPress

Vou dedicar uma seção do guia ao WordPress porque é onde a Apiki opera há mais de 17 anos e onde esses problemas assumem formas específicas: plugins de segurança bloqueando crawlers por padrão, dois plugins de SEO gerando schemas conflitantes, page builders entregando HTML raso.

Mas o framework é agnóstico. Boa parte dos projetos que mantemos hoje usa WordPress só como CMS, com o front em React ou Next.js. Nesses casos, o problema de Response versus Render é exatamente o mesmo de qualquer aplicação JavaScript, e a solução passa por SSR, prerender ou geração estática. Um dos próximos artigos desta série vai dissecar um portal de notícias sobre IA que construímos com WordPress headless e Next.js, mostrando o que a IA recebe de cada rota.

Por onde começar

Se você chegou até aqui, tem um backlog mental. A ordem que funciona é a ordem do funil:

  1. Acesso primeiro. Se o crawler está bloqueado, nada depois tem efeito. É a verificação mais rápida e a de maior impacto.
  2. Depois, conteúdo na resposta bruta. Confirme que o texto que importa está no HTML servido.
  3. Então, navegação e entidade: sitemap, llms.txt, links internos reais no HTML, um bloco JSON-LD de organização com name, url, logo e sameAs.
  4. Por fim, acessibilidade↳Acessibilidade11 conteúdosO que é Acessibilidade Web e como tornar seu site mais acessívelDev (Back & Front) · mar 2019Design para veteranos digitais: acessibilidade para nós mesmosProduto & UX · jan 2020Dicas de Front-End para usabilidade, acessibilidade, performance e responsividadeProduto & UX · fev 2025Ver tudo em Produto & UX →, que é o que torna o site operável por agentes.

E meça antes e depois. Cada correção precisa virar um delta: a nota antes, a nota depois, a evidência de cada check.

As seis camadas do framework, com checklist e comandos de verificação para cada uma, estão no guia “O seu site existe para a IA?”, que o iMasters está distribuindo. E todo o framework está codificado em uma ferramenta gratuita: você informa a URL e recebe uma nota de 0 a 100, com o resultado por camada e as correções na ordem do funil. Fica em geo.apiki.com e leva menos de um minuto.

Uma nota de honestidade metodológica: a página de resultado da ferramenta é auditável por ela mesma, e precisa pontuar bem. Um diagnóstico de GEO que não cumpre GEO contradiz a própria tese. Rode no seu site. Depois rode no nosso.

Artigo de Leandro Vieira

Leandro Vieira é fundador e CEO da Apiki, que opera WordPress em engenharia, performance e ambientes gerenciados desde 2008. Criou o GEO Técnico, framework que organiza a otimização para motores generativos em seis camadas verificáveis, e o BotIAudit, ferramenta de auditoria de logs de crawlers de IA. Palestrante em Gramado Summit, Digitalks e AI Brasil.

Mais de Leandro Vieira
Ver perfil →