--- title: "is-agentic: 4 armadilhas que enganam quem lê a nota | Grupo Marfre" description: "is-agentic: 4 armadilhas na leitura da nota: relatório cacheado, scan em sequência, palavra api no caminho e soft 404. Veja como evitar cada uma." canonical: https://grupomarfre.com.br/sites-agenticos/armadilhas-do-is-agentic/ alternate_html: https://grupomarfre.com.br/sites-agenticos/armadilhas-do-is-agentic/ language: pt-BR last_updated: 2026-10-27 type: guia --- # is-agentic: 4 armadilhas que enganam quem lê a nota **Resposta rápida:** Quatro armadilhas enganam quem mede o site com o is-agentic: relatório cacheado lido como novo, scan em sequência que devolve o anterior, a palavra “api” no caminho de uma página (nota de 100 para 79 na medição do Grupo Marfre) e soft 404 por falta de 404.html no Cloudflare Pages. Cada uma tem um teste que você consegue rodar. Nem todo número que aparece quando você mede o site descreve o site de hoje. Quatro situações distorcem a leitura: ler um relatório antigo como se fosse novo, disparar scans em sequência, deixar a palavra "api" aparecer num endereço e publicar um site que não devolve 404 de verdade. As duas últimas foram medidas nos sites que o Grupo Marfre publica. Antes de comemorar ou se assustar com um número, rode o teste de cada seção abaixo. Para entender o que a ferramenta mede, veja [is-agentic.com: o que mede e como ler a nota](https://grupomarfre.com.br/sites-agenticos/is-agentic/). ## Armadilha 1: como saber se o relatório é novo ou cacheado? O is-agentic guarda o relatório em cache. Sem pedir um scan novo (botão Rescan ou o parâmetro `force=1`), ele devolve a nota antiga. Quem corrige o site, abre a página da ferramenta e vê o mesmo número pode concluir que a correção não funcionou, quando só não foi medida. Como evitar, em ordem: 1. Publique a correção e confirme em produção com `curl` antes de pedir o scan. 2. Peça o scan novo (Rescan ou `force=1`). 3. Espere. O relatório pode chegar de 5 a 10 minutos depois do disparo. 4. Confira se o resultado dos checks que você mexeu mudou. Se nada mudou, desconfie do cache antes de desconfiar da correção. ## Armadilha 2: por que um scan disparado em sequência pode mostrar o anterior? O cache de frescor é de 6 horas, e a ferramenta limita 10 scans por minuto por IP, além de ter um orçamento diário de scans. Por isso, quem ajusta um item, dispara o scan, ajusta outro e dispara de novo dentro dessa janela pode ler o relatório anterior como se fosse o novo, e cada scan novo pedido conta no orçamento diário. | Limite | Valor | | --- | --- | | Frescor do cache | 6 horas | | Scans por minuto, por IP | 10 | | Atraso até o relatório chegar | 5 a 10 minutos | | Orçamento diário | existe, por isso não vale disparar em rajada | O método que evita o problema é agrupar as correções, provar tudo com `curl` (as receitas estão em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/)), pedir um único scan novo e esperar a janela. Para comparar antes e depois, guarde a nota anterior com data e horário. ## Armadilha 3: como a palavra "api" no caminho muda a nota? O scanner escolhe o perfil do site pelo que encontra, e isso inclui os endereços listados no llms.txt. Na medição do Grupo Marfre, a palavra "api" no caminho de uma página listada (até dentro de outra palavra) mudou o perfil detectado: os 16 checks elegíveis viraram 23, e a nota caiu de 100 para 79. O motivo é que o scanner passou a cobrar OpenAPI e erro em JSON, coisas que um site de conteúdo não tem. Exemplo fictício: um endereço como `/servicos/terapia-cognitiva/` contém "api" dentro de "terapia". O site não ganhou API nenhuma, mas o perfil pode mudar do mesmo jeito. Teste que você roda em segundos: ```bash curl -s https://www.exemplo.com.br/llms.txt | grep -i "api" ``` Se aparecer algum caminho, o conserto da casa foi trocar o slug e criar um 301 do endereço antigo para o novo, o que mantém quem já chegava pelo link velho. Detalhes em [redirecionamentos 301 limpos](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/). Depois, atualize o llms.txt e o sitemap e peça um scan novo. Na medição do Grupo Marfre, a queda de 100 para 79 depois dessa mudança não significou que o site piorou: a régua mudou de 16 para 23 checks. ## Armadilha 4: o que é soft 404 e por que falta de 404.html no Cloudflare Pages causa isso? Soft 404 é o endereço que não existe e mesmo assim responde HTTP 200 com conteúdo de página. Na medição do Grupo Marfre, um site no Cloudflare Pages sem `404.html` na pasta entra em modo SPA e devolve a home com status 200 em qualquer endereço inexistente. O achado veio de um controle negativo em 3 sites da casa. Controle negativo é pedir de propósito uma página que não existe: ```bash curl -s -o /dev/null -w "%{http_code}\n" https://www.exemplo.com.br/pagina-que-nao-existe-123 ``` O esperado é `404`. Se vier `200`, o site está dizendo a qualquer cliente que aquele endereço existe. O conserto é colocar um `404.html` na pasta publicada e repetir o teste. Para entender o que o agente espera dessa resposta, leia [página 404 que o agente entende](https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/). ## O que essas armadilhas têm em comum? Nas quatro, o número na tela não descreve o site de hoje. Ele descreve um cache, um perfil errado ou uma resposta que mente. O hábito que resolve é medir com um controle: um scan novo depois de provar em produção, um slug conferido, um endereço inexistente testado. Mesmo com a leitura limpa, a nota tem limite: [nota 100 não é citação](https://grupomarfre.com.br/sites-agenticos/nota-100-nao-e-citacao/). Ela mede se o site está pronto para agentes, não se a IA cita a empresa. ## Como o Grupo Marfre trabalha isso O Grupo Marfre mede antes, com is-agentic em scan novo, e guarda a linha de base. A prova em produção é feita com `curl`, incluindo uma rota inexistente (que deve dar 404 em Markdown) e o README (que deve dar 404), e só depois vem o scan novo no is-agentic. O middleware na borda, em Cloudflare Pages Functions, entrega o 404 em Markdown. O Grupo Marfre não promete citação por IA: controla o site e as fontes, e a escolha é do modelo. ## Perguntas frequentes ### Quanto tempo esperar depois de pedir o scan novo? O relatório pode chegar de 5 a 10 minutos depois do disparo. Dentro desse intervalo, evite disparar outro scan, porque isso só atrapalha a leitura. ### A nota caiu depois de eu criar uma página. O site piorou? Não necessariamente. Se a página nova ou algum endereço listado no llms.txt tem "api" no caminho, o perfil detectado pode ter mudado e a ferramenta passou a cobrar checks que não se aplicam a site de conteúdo. Compare o número de checks elegíveis antes e depois. ### O soft 404 acontece em qualquer hospedagem? O comportamento descrito aqui foi medido no Cloudflare Pages, sem `404.html` na pasta. Em outras hospedagens o resultado depende da configuração, e o teste com endereço inexistente mostra qual é o caso do seu site. ### Preciso zerar os checks que aparecem como não aplicáveis? Não. Na medição do Grupo Marfre, site de conteúdo com 100 no is-agentic fica em warning ou fail nos checks que não se aplicam a ele, como MCP, OAuth e OpenAPI. Na régua do Grupo Marfre, não vale perseguir esses itens. ## Leia também ### [is-agentic.com: o que mede e como ler a nota](https://grupomarfre.com.br/sites-agenticos/is-agentic/) is-agentic.com mede se o site está pronto para agentes de IA. Veja como a nota é composta, por que o número de checks varia e como pedir scan novo. ### [Os checks do is-agentic, um por um, para site de conteúdo](https://grupomarfre.com.br/sites-agenticos/checks-do-is-agentic/) Checks do is-agentic para site de conteúdo, um por um: o que cada um pede, como consertar e como provar com curl antes de pedir um scan novo. ### [Nota 100 não é citação: o que a medição de agente prova](https://grupomarfre.com.br/sites-agenticos/nota-100-nao-e-citacao/) Nota máxima no is-agentic e no Lighthouse prova que o site está pronto para agentes, não que a IA vai citar. Veja o caso medido e o que acompanha a citação. ### [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. ### [Auditoria de site agêntico: roteiro em 12 passos](https://grupomarfre.com.br/sites-agenticos/auditoria-site-agentico/) Auditoria de site agêntico em 12 passos: robots.txt, firewall, JSON-LD, 404, Markdown, llms.txt e sitemap, cada um com o teste que prova que funciona. --- ## 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/armadilhas-do-is-agentic/