Testar grátis

InícioBlog › Auditoria técnica

Ultra SEO · AEO · GEOAuditoria técnica

Testando o acesso de agente pelo terminal, passo a passo

Auditoria técnica 14/set
Testando o acesso de agente pelo terminal, passo a passo
Resposta direta

Quatro comandos de terminal respondem se os leitores de IA entram no seu site: o código de resposta com o agente no cabeçalho, o tamanho do HTML que veio, a leitura do robots.txt e o mesmo teste numa página interna. Leva menos de cinco minutos e não precisa instalar nada além do que já vem no seu computador.

O que você precisa antes de começar

Um terminal e o endereço do site. No Mac e no Linux o curl já vem instalado; no Windows ele existe no PowerShell. Nenhum dos comandos abaixo altera nada: são todos leitura.

Passo 1: a resposta que o agente recebe

# troque o endereço pelo seu
SITE="https://seusite.com.br"

for AG in "GPTBot/1.1" "ClaudeBot/1.0" "PerplexityBot/1.0" "Googlebot/2.1"; do
  CODE=$(curl -sS -o /dev/null -w "%{http_code}" -A "Mozilla/5.0 (compatible; $AG)" "$SITE")
  echo "$AG -> $CODE"
done

Como ler: 200 é entrada liberada. 403 é bloqueio. 429 é limite de requisição, que na prática também barra. 503 costuma ser página de desafio da proteção.

Passo 2: o conteúdo que veio junto

# tamanho do HTML e presença do seu texto principal
curl -sS -A "Mozilla/5.0 (compatible; GPTBot/1.1)" "$SITE" \
  | tee /tmp/pagina.html | wc -c

grep -c "um pedaço da sua frase de abertura" /tmp/pagina.html

Código 200 com HTML de poucos milhares de caracteres e a busca dando zero significa que a porta está aberta mas não há conteúdo do outro lado: a página é montada no navegador. É um problema diferente do bloqueio, e igualmente fatal.

Passo 3: o robots, agente por agente

curl -sS "$SITE/robots.txt"

Procure por Disallow: / logo abaixo de qualquer um destes nomes: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, Claude-User, PerplexityBot, Perplexity-User, Google-Extended. Um Disallow: / num bloco User-agent: * vale para todos que não têm bloco próprio.

Passo 4: uma página interna, não só a home

curl -sS -o /dev/null -w "%{http_code}\n" \
  -A "Mozilla/5.0 (compatible; GPTBot/1.1)" \
  "$SITE/uma-pagina-de-conteudo"

É o passo que a maioria pula, e é onde o problema costuma estar. As regras de proteção frequentemente tratam a raiz de um jeito e o resto do site de outro. As páginas internas são as que respondem às perguntas do mercado.

Como ler o resultado

O que apareceuO que significaPara onde ir
Todos em 200, com o texto no HTMLAcesso está saudávelO problema, se houver, é de conteúdo ou de entidade
403 ou 503 só para os agentes de IABloqueio seletivo na proteção do servidorExceção por lista na CDN, com verificação de origem
200 com HTML pequeno e sem o seu textoO conteúdo é montado no navegadorEntregar do servidor as páginas que importam
200 na home e 403 na página internaRegra por caminhoRevisar a regra da proteção, não só o robots
Disallow: / no robotsVocê está pedindo para não ser lidoLiberar os agentes que você quer, por grupo de fornecedor

Perguntas frequentes

Posso usar o navegador em vez do terminal?

O navegador executa script e envia o agente dele, então ele mostra a experiência humana, não a do leitor automático. É justamente a diferença entre as duas que este teste mede.

Fingir ser um robô não é problema?

O cabeçalho do agente é texto livre e mudá-lo é prática comum de diagnóstico. Você está pedindo a sua própria página, com um rótulo diferente.

Descobri um bloqueio. E agora?

O conserto é uma regra de exceção na camada de proteção, quase sempre alguns cliques para quem administra a CDN. Depois, respeite a régua de entrada antes de medir de novo.

Para agências

Vynco Partners

Opere presença em IA para a carteira inteira, com a sua marca na frente, formação do time e o selo que entra no diretório.

Entrar no Vynco Partners
Para empresas

Ache quem faz por você

Agências e profissionais certificados para cuidar da sua presença nas IAs. Você mede primeiro, e o diagnóstico vai anexo ao pedido.

Buscar uma agência parceira
Ultra SEO · AEO · GEOLista de novidades

Uma matéria por dia útil, direto no seu e-mail

Presença de marca no Google e nas IAs, com a pergunta que rodou e o número de verificações ao lado. Você escolhe o nível e recebe a trilha certa.

  • Uma matéria por dia útil, com o dado que a sustenta
  • As ferramentas novas antes de virarem oferta pública
  • Nenhuma promoção disfarçada de conteúdo