CrawlCheck
Para desenvolvedores e fornecedores · API, especificações, chaves

O que o seu código pode perguntar sobre qualquer domínio?

Em uma frase

O CrawlCheck para desenvolvedores é uma API documentada — cada operação em um arquivo OpenAPI 3.1 com um exemplo resolvido — que devolve sem chave uma resposta assinada e verificável offline sobre qualquer domínio, além de faixas de medição com cota, SDKs tipados, chaves de assinatura publicadas e uma suíte de conformidade para quem constrói sobre as especificações ou as implementa.

Uma API documentada: 274 operações em 238 caminhos dentro de um arquivo OpenAPI 3.1, cada uma com um exemplo resolvido. Uma resposta assinada por domínio, SDKs tipados no npm e no PyPI, um servidor MCP no registro oficial e chaves com cotas publicadas.
GET https://crawlcheck.io/api/v1/resolve?domain=example.com
POST https://crawlcheck.io/api/v1/preflight

A resposta assinada e a decisão de preflight não precisam de chave. Uma chave acrescenta as faixas de medição — escaneamentos, lotes, registros para máquinas com os bytes por trás de cada achado, exportações OpenTelemetry e PROV, webhooks e um portão de CI — contados contra uma cota publicada com o plano. Toda resposta se verifica offline contra as chaves de assinatura publicadas.

Pagar nunca muda uma medição. Início rápido · openapi.json · Conformidade

Três caminhos para baixo

Documentação. Especificações. Chaves.

API

Cada operação, com um exemplo.

A referência é gerada a partir do serviço em produção: 274 operações, cada uma com um exemplo resolvido e o portão atrás do qual ela fica. O início rápido leva um agente à sua primeira decisão assinada em um minuto.

Referência da API · Início rápido · SDKs

Especificações

Os contratos por trás da resposta.

Resolve é o protocolo; o cabeçalho de recibo, o staple, Resolve sobre DNS, o lockfile de ferramentas e o protocolo de observador são as especificações contra as quais um fornecedor implementa. Cada uma tem um documento versionado e uma suíte de conformidade.

Resolve · Cabeçalho de recibo · Protocolo de observador

Chaves

Publicadas, rotacionadas, verificáveis.

As chaves de assinatura são publicadas com seu registro de rotação; um único script sem dependências verifica offline qualquer resposta, recibo ou exportação. Uma chave de licença é criada na página de preços e mostrada uma única vez; cotas e termos são públicos.

Chaves de assinatura · Termos da API · Planos e cotas

1 · O contrato central

9 operações de que um agente precisa, versionadas e mantidas.

Ficam em /api/v1 e continuam a responder pelo menos 180 dias depois de anunciada uma /api/v2. Os campos estáveis só mudam numa nova versão principal; tudo o que devolvem se verifica offline.

ParaChamadaO que recebe
perguntarGET /api/v1/resolveuma resposta assinada sobre um domínio: o que permite, serve e declara, e uma decisão por ação
perguntarPOST /api/v1/resolveo mesmo para 1 a 100 domínios
decidirPOST /api/v1/preflightuma decisão assinada para uma ação, com um recibo para guardar
reciboGET /api/v1/decisions/{sha256}para um site: verificar o recibo que um agente apresenta no cabeçalho CrawlCheck-Receipt
revogaçãoGET /api/v1/revocationsa lista assinada dos domínios cujas decisões connect e transact estão revogadas agora
visitanteGET /api/v1/visitorpara um site: este pedido vem mesmo do agente que nomeia?
visitantePOST /api/v1/visitoro mesmo para 1 a 100 pedidos
mcpGET /api/v1/mcp/scanantes de ligar: as ferramentas que um servidor MCP remoto lista, analisadas contra envenenamento
mcpPOST /api/v1/mcp/lock/checkantes de cada sessão: comparar as ferramentas de um servidor com o lockfile guardado

Marcadas como x-core em /openapi.json · A lista em JSON · Política de compatibilidade

2 · As especificações

9 documentos contra os quais um fornecedor implementa.

Cada um é um documento versionado; este serviço é a implementação de referência.

3 · SDK

Perguntar, verificar e proteger numa chamada.

TypeScript e JavaScript

npm i @crawlcheck/sdk

Versão 1.5.2 no npm; o mesmo tarball é servido em /sdk.

Python

pip install crawlcheck

Versão 1.5.3 no PyPI, sem dependências.

MCP

claude mcp add --transport http crawlcheck https://crawlcheck.io/mcp

Listado no registo MCP oficial como io.github.emmanuelorta/crawlcheck.

4 · Chaves e conformidade

Nada aqui precisa ser aceito na confiança.

curl -o bundle.json "https://crawlcheck.io/api/bundle?id=<id>"
curl -O https://crawlcheck.io/crawlcheck-verify.mjs
node crawlcheck-verify.mjs bundle.json

SHA-256 do verificador servido hoje: b22547e95463d03e1c4177ae6de8ba23c1316629766f0138375edf12d9d77183. Conferir um registro no navegador →

5 · Quotas e termos

Publicadas com o plano.

PlanoAnálises por mêsConsultas com chave por mês
Developer2.000100.000
Growth20.0001.000.000
Watch50010.000
Agency5.00050.000
Network20.000250.000

A resposta assinada, a decisão de preflight e a análise gratuita não são contabilizadas. Planos → · Termos da API → · Política de compatibilidade →

A API, por faixa

104 de 274 operações, mapeadas em 5 faixas.

O mapa de faixas é o subconjunto guiado; as contagens de operações e a referência completa são geradas a partir do arquivo OpenAPI que o serviço publica.

FaixaOperaçõesPor exemplo
Decidir57 operações · 46 sem chaveGET /api/v1/resolve
POST /api/v1/preflight
GET /api/v1/resolve-prefix/{prefix}
Medida6 operações · 3 sem chaveGET /sandbox
POST /api/v1/scan
POST /api/scan
Ler23 operações · 9 sem chaveGET /api/v1/reports/{id}
GET /r/{id}.json
GET /r/{id}.raw.json
Dados5 operações · 5 sem chaveGET /api/public/counts
GET /api/corpus/state
GET /api/telemetry
Ferramentas13 operações · 9 sem chavePOST /api/tool/verify
GET /api/tool/robots
GET /api/tool/llms

Cada operação, com um exemplo resolvido →

Documentação

Tudo o resto, numa lista.

Legível por máquinas

Perguntas sobre esta página

QPreciso de uma chave?
Não para a resposta assinada, a decisão de preflight nem o escaneamento gratuito. Uma chave acrescenta as faixas de medição — escaneamentos, lotes, registros para máquinas, exportações, webhooks, o portão de CI — com uma cota publicada com o plano.
QQuais SDKs existem?
Clientes tipados no npm e no PyPI, idênticos byte a byte aos pacotes servidos a partir deste site, com o verificador offline incluso. Um servidor MCP está listado no registro MCP oficial, e o HTTP simples funciona em todo o resto.
QComo verifico uma resposta offline?
Toda resposta, recibo e exportação é assinada com Ed25519 e uma chave publicada. Um único script sem dependências, o crawlcheck-verify.mjs, confere qualquer um deles na sua própria máquina; pacotes de provas também carregam a raiz selada do dia e o carimbo de tempo no Bitcoin.
QOnde estão as especificações?
Resolve é o protocolo; o cabeçalho de recibo, o staple, Resolve sobre DNS, o lockfile de ferramentas e o protocolo de observador têm cada um um documento versionado e uma suíte de conformidade que você pode executar contra a sua própria implementação.
QQuais são as cotas?
Developer 2.000 escaneamentos por mês, Studio 1.500, Agency 5.000, Growth e Network 20.000. A resposta assinada e a decisão de preflight não são contabilizadas. Cotas e termos são públicos e só mudam com aviso.