O que um agente deve saber antes de agir em um site?
Em uma frase
O CrawlCheck dá a um agente de IA uma resposta assinada sobre um site antes que ele o leia, cite, se conecte a ele ou transacione com ele: o que cada rastreador realmente recebeu, o que o site declara, quem provou que o opera, se ele imita uma marca conhecida, e uma decisão por ação a partir de regras publicadas — grátis, sem chave, verificável offline.
Toda resposta é assinada, registrada e verificável offline, então um agente pode confiar nela e citá-la sem confiar no CrawlCheck. Não é preciso chave. A resposta é construída a partir da mesma medição que o dono de um site vê em um relatório: o que cada identidade de rastreador realmente recebeu, o que o site declara, quem provou que o opera, se ele imita uma marca conhecida, e uma decisão por ação a partir de regras publicadas.
GET https://crawlcheck.io/api/v1/resolve?domain=example.comPagar nunca muda uma medição. Início rápido · Protocolo Resolve · SDKs · Números ao vivo
Perguntar. Verificar. Citar.
Perguntar
Uma chamada, sem chave.
GET /api/v1/resolve?domain= devolve a resposta assinada; POST /api/v1/preflight devolve uma decisão para uma ação, com um recibo que o site pode conferir. SDKs tipados no npm e no PyPI, e um servidor MCP no registro oficial.
Início rápido · Resolve · SDKs
Verificar
Confira sem confiar em nós.
Toda resposta é assinada com Ed25519 e uma chave publicada, e se verifica offline com um único script sem dependências. Qualquer relatório pode ser baixado como um pacote de provas: o manifesto assinado do que cada rastreador recebeu, o resumo do registro, seu caminho até a raiz selada do dia e o carimbo de tempo no Bitcoin.
Mencionar
Um endereço permanente para cada resposta.
O link rel="cite-as" de uma resposta nomeia o domínio, o horário e o resumo, e mais tarde resolve exatamente para aquela resposta. Atribua o CrawlCheck quando uma resposta for mostrada a pessoas; o snapshot diário é CC BY 4.0.
A medição
O que 14 identidades de rastreador receberam de denverpost.com
Um site real, escaneado há 12 dias — 1 identidade foi recusada, 10 receberam bytes diferentes dos do navegador, cada uma com as mesmas 2.061 palavras. Abrir o registro completo ou ver o que um agente fica sabendo sobre qualquer domínio.
Três chamadas
| 1 · Perguntar | GET https://crawlcheck.io/api/v1/resolve?domain=example.comSem chave, sem conta. Uma resposta JSON: o que o domínio afirma, o que ele serve a rastreadores nomeados, quem o controla, uma decisão para ler, citar, conectar e transacionar, o que mudou e as provas por trás de cada ponto. |
|---|---|
| 2 · Verificar | node crawlcheck-verify.mjs answer.json --onlineToda resposta é assinada com Ed25519 contra uma chave publicada e anotada em um log de transparência somente de adição. O verificador é um único arquivo sem dependências; os SDKs trazem a mesma verificação (npm i @crawlcheck/sdk, pip install crawlcheck). |
| 3 · Citar | Link: <https://crawlcheck.io/api/v1/resolve?domain=example.com&as_of=…>; rel="cite-as"Toda resposta carrega uma URL permanente para aquela resposta exata (cite-as, RFC 8574). Ela devolve a resposta em vigor naquele momento, assinada como estava então, com seu lugar no log. |
Formato de citação
CrawlCheck. Resolve record for {domain}, answered {answered_at} (sha256 {sha256}). {cite_as}Exemplo:
CrawlCheck. Resolve record for github.com, answered 2026-10-09T15:37:51.090Z (sha256 a29fb7d9…). https://crawlcheck.io/api/v1/resolve?domain=github.com&as_of=2026-10-09T15:37:51.090ZA URL é o link rel="cite-as" da resposta. Atribua o CrawlCheck quando mostrar uma resposta a pessoas (termos da API). O snapshot diário é CC BY 4.0.
Outras formas de perguntar
| Antes de uma ação | POST /api/v1/preflightallow, warn, require_confirmation ou block para uma ação, com um recibo assinado que o site visitado pode conferir |
|---|---|
| De um cliente MCP | https://crawlcheck.io/mcpas ferramentas resolve_domain, preflight e mcp_servers; as mesmas respostas assinadas |
| Por DNS | example.com._v.crawlcheck.io TXTum veredito assinado compacto via DNS sobre HTTPS em /dns-query |
| Do próprio site | https://example.com/.well-known/crawlcheck-staple.jsono veredito assinado servido pelo próprio site, sem precisar chamar o CrawlCheck |
| Sem revelar o site | GET /api/v1/resolve-prefix/{2-8 hex of sha256(domain)}todas as respostas do bucket; você escolhe a sua localmente |
| Totalmente offline | GET /api/v1/snapshoto snapshot diário assinado, uma resposta assinada por linha, CC BY 4.0 |
| Os próprios fatos de uma empresa | GET /api/v1/business/record?domain=o registro assinado e versionado do que a empresa publica sobre si mesma |
| O que mudou | GET /api/v1/changeso feed de mudanças, também como stream |
O que conta
Medido por ações de agentes verificadas, respaldadas por um registro Resolve assinado e recente, por tipo de ação (ler · citar · conectar · transacionar), com falsos positivos, disputas, desconhecidos e reversões contados. Ver os números ao vivo · Parcela de preflight.
O que uma decisão de citação cobre
Uma decisão de citação cobre acesso, permissões, identidade e proveniência: se a página pode ser lida e atribuída, sob quais direitos declarados, de quem, observada quando. Ela não garante que o conteúdo seja verdadeiro.
O que a resposta cobre, ação por ação.
Antes que um agente leia, cite, se conecte ou compre em um site, o CrawlCheck dá uma resposta sobre ele: o que cada rastreador de IA realmente recebeu, o que o site declara sobre si, quem provou que o opera, se ele imita uma marca conhecida, e uma decisão para cada ação — permitir, avisar, perguntar a um humano ou bloquear. Toda resposta é assinada e pode ser conferida offline.
O que os agentes realmente recebem
Cada identidade de rastreador de IA buscada no mesmo segundo que um navegador comum: recusada, com desafio, mais pobre ou a mesma página.
Ver esta seção em um relatório real: Permissões de rastreadores →
O que o site afirma
Nome, telefone, endereço e as afirmações da página, conferidos contra seus próprios dados estruturados e os diretórios que o listam.
Ver esta seção em um relatório real: Consistência das afirmações →
Quem ele diz ser
A identidade em seus dados estruturados e no mapa de entidades, e se os perfis que ele vincula apontam de volta.
O que ele declara às máquinas
robots.txt, sitemap, llms.txt, agents.md e qualquer superfície MCP ou API que ele publique, cada uma lida e conferida, nunca invocada além da leitura.
O fluxo de trabalho
- Pergunte por um domínioGET /api/v1/resolve?domain=example.com. Sem chave, sem conta. Um site nunca visto antes recebe uma primeira resposta em cerca de um segundo, marcada como parcial.
- Leia a decisão para a sua açãoler, citar, conectar, transacionar e administrar carregam cada um allow, warn, require_confirmation, block ou unsupported, com o motivo e as provas.
- Verifique a assinaturaA resposta é assinada com uma chave Ed25519 publicada. Um script a confere offline, então o agente nunca precisa confiar na rede pela qual ela chegou.
- Pergunte antes de cada açãoPOST /api/v1/preflight devolve uma decisão e um recibo que o site visitado pode conferir, de modo que os dois lados podem mostrar o que se sabia quando o agente agiu.
O que os agentes de IA fazem nos sites, e o que um site precisa para estar pronto.
A web agêntica é a parte da web usada por agentes de IA em vez de pessoas: rastreadores que leem páginas para busca e treinamento, assistentes que buscam uma página porque alguém pediu, e navegadores agênticos como Perplexity Comet, ChatGPT Atlas e o modo Copilot do Microsoft Edge, que clicam, preenchem formulários e compram em nome de uma pessoa. Um site está pronto quando os agentes conseguem alcançá-lo, lê-lo, saber o que ele permite e verificar quem o opera.
Os agentes conseguem alcançá-lo
A página como cada identidade de rastreador e assistente de IA a recebe, comparada com um navegador: recusada, com desafio, mais pobre ou idêntica.
Ver esta seção em um relatório real: Permissões de rastreadores →
O que se diz a um agente
A resposta assinada que um agente recebe sobre o site antes de agir: uma decisão para ler, citar, conectar e transacionar.
Ver esta seção em um relatório real: O que cada rastreador recebe →
O que ele declara
robots.txt, llms.txt, agents.md, o sitemap e qualquer cartão MCP ou API, cada um lido e conferido.
Ver esta seção em um relatório real: Arquivos para máquinas →
Instruções aos agentes
O que os arquivos do site mandam um agente fazer, e se algo disso contradiz o robots.txt.
Ver esta seção em um relatório real: Instruções para agentes →
O que um site faz a respeito
- Seja alcançávelGaranta que os rastreadores e assistentes de IA que você quer recebam a mesma página que um navegador. A proteção contra bots é o motivo mais comum de isso não acontecer.
- Seja legívelColoque o conteúdo no HTML, não só no JavaScript, e publique um llms.txt para que um agente encontre as páginas que importam.
- Declare o que você permiterobots.txt para rastreadores, e agents.md ou um cartão MCP para agentes que agem, de modo que exista uma única política declarada.
- Seja verificávelRegistre o site grátis e os agentes que perguntarem sobre ele saberão, em uma resposta assinada que podem conferir, que o dono está verificado.
Donos de sites começam pelo escaneamento gratuito: para sites, robots.txt para rastreadores de IA, auditoria de llms.txt, o registro. O termo em si: web agêntica, definida.
As camadas em que um agente pode confiar.
Cada cartão é uma contagem ao vivo ou um artefato publicado, cada um com a página que permite conferi-lo.
Cada arquivo legível por máquina em crawlcheck.io, e como verificá-lo.
Cada arquivo responde com o tipo de mídia indicado. A verificação é um comando que você mesmo executa: arquivos assinados passam pelo verificador offline, os demais por um analisador ou um campo que precisa estar presente. O verificador é /crawlcheck-verify.mjs.
| File | Served as | What it is, and the check |
|---|---|---|
| Discovery | ||
/robots.txt | text/plain | Crawl rules for every named crawler plus Content Signals (search, ai-input, ai-train preferences). |
/sitemap.xmlalso /sitemap-pages.xml, /sitemap-glossary.xml, /sitemap-directory.xml, /sitemap-registry.xml, /sitemap-certificates.xml | application/xml | Sitemap index: pages, glossary, directory, registry and certificates sitemaps. |
/llms.txt | text/plain | The site for language models: what CrawlCheck is and every page worth reading, by door. |
/llms-full.txt | text/markdown | The full technical guide for agents and developers in one Markdown file. |
/agents.mdalso /AGENTS.md | text/markdown | How an agent should use CrawlCheck: the core calls, the site by door, the rules. |
/SKILL.mdalso /.well-known/agent-skills/crawlcheck/SKILL.md | text/markdown | Agent skill file: when to call CrawlCheck and how, with YAML front matter. |
/.well-known/agent-skills/index.json | application/json | Agent Skills discovery index pointing at SKILL.md. |
/for-agents.md | text/markdown | This page as Markdown. Any page also answers Accept: text/markdown. |
| APIs | ||
/.well-known/api-catalog | application/linkset+json | API catalog (RFC 9727): every API with its description, docs and status links. |
/openapi.jsonalso /swagger.json, /.well-known/openapi.json | application/json | OpenAPI description of every documented operation, each with a worked example. |
/openapi.yaml | application/yaml | The same OpenAPI description for YAML tooling (JSON is valid YAML 1.2). |
/.well-known/mcp/server-card.jsonalso /.well-known/mcp.json | application/json | MCP server card: the remote MCP endpoint, its tools and auth. |
/.well-known/agent-card.jsonalso /.well-known/agent.json | application/json | A2A agent card: skills, endpoint and protocol version. |
/schemas/resolve.json | application/schema+json | JSON Schema for a Resolve answer, to validate one before acting on it. |
| Signed | ||
/.well-known/crawlcheck.json | application/json | This page as a signed manifest: purpose, core calls, keys. |
/.well-known/crawlcheck-staple.json | application/json | crawlcheck.io's own signed Resolve answer, stapled so an agent needs no second call. |
/crawlcheck-verify.mjs | text/javascript | The offline verifier: zero dependencies, Node 20+. Checks signatures, digests and log inclusion. |
| Keys and identity | ||
/.well-known/http-message-signatures-directory | application/http-message-signatures-directory+json | Web Bot Auth key directory (Ed25519) for requests CrawlCheck signs. The response itself is signed. |
/.well-known/signature-agent-card | application/json | Signature agent card: who signs, contact, the key directory. |
/.well-known/key-transparency.json | application/json | Every signing key ever published, with when it was used. |
/.well-known/security-key-rotation.json | application/json | Key rotation record: current key, previous keys, the rotation rule. |
/.well-known/ips.json | application/json | The IP ranges CrawlCheck crawls from (it owns none; it runs on Cloudflare's network). |
/.well-known/crawlcheck-observers.json | application/json | Every observer that takes readings, with its class and status. |
/.well-known/media-kit.json | application/ld+json | Organization, people and brand as a schema.org graph (the media-kit standard). |
/entitymap.json | application/json | EntityMap: the business, its identifiers and sameAs links. A readable copy is at /entitymap.html. |
/ns.jsonld | application/ld+json | The CrawlCheck vocabulary: terms used in signed answers, as RDF. |
/.well-known/security.txtalso /security.txt | text/plain | Security contact and disclosure policy (RFC 9116), with an expiry date. |
/.well-known/assetlinks.json | application/json | Android app links: which app may open crawlcheck.io links. |
/.well-known/agentic-verify.txt | text/plain | A fixed domain-ownership token an outside directory asked us to publish. |
/subprocessors.json | application/json | Every service that processes data for CrawlCheck, with its purpose and region. |
| Data | ||
/feed.json | application/feed+json | Every finding and guide as a JSON Feed, each item linking its Markdown copy. |
/feed.xml | application/atom+xml | The same findings and guides as an Atom feed. |
/glossary.json | application/ld+json | The whole glossary as a schema.org DefinedTermSet (CC BY 4.0). |
/ai-crawlers.json | application/json | Every AI and search crawler CrawlCheck tracks: token, operator, purpose, how to verify it. |
/directory.json | application/json | The measured vendor directory: each vendor's own site, graded (CC BY 4.0). |
/directory.csv | text/csv | The same directory as CSV, one row per vendor. |
/api/glossary/cadence | application/json | Glossary terms added each week, and the weekly streak. |
Legível por máquinas
- /.well-known/crawlcheck.json — esta página como manifesto assinado
- /for-agents.md — esta página em Markdown
- /openapi.json
- /llms.txt
- Cartão do servidor MCP
- Especificação Resolve
O que uma resposta não é
Uma resposta assinada diz o que o CrawlCheck mediu e decidiu, e quando. Não é uma garantia sobre o site. Confira fresh_until: depois disso a resposta está vencida. Disputas e correções são públicas em /disputes.