CrawlCheck
Para desarrolladores y proveedores · API, especificaciones, claves

¿Qué puede preguntar tu código sobre cualquier dominio?

En una frase

CrawlCheck para desarrolladores es una API documentada — cada operación en un archivo OpenAPI 3.1 con un ejemplo resuelto — que devuelve sin clave una respuesta firmada y verificable sin conexión sobre cualquier dominio, además de carriles de medición con cuota, SDK tipados, claves de firma publicadas y una suite de conformidad para quien construya sobre las especificaciones o las implemente.

Una API documentada: 274 operaciones en 238 rutas dentro de un archivo OpenAPI 3.1, cada una con un ejemplo resuelto. Una respuesta firmada por dominio, SDK tipados en npm y PyPI, un servidor MCP en el registro oficial y claves con cuotas publicadas.
GET https://crawlcheck.io/api/v1/resolve?domain=example.com
POST https://crawlcheck.io/api/v1/preflight

La respuesta firmada y la decisión de preflight no necesitan clave. Una clave añade los carriles de medición — escaneos, lotes, registros para máquinas con los bytes detrás de cada hallazgo, exportaciones OpenTelemetry y PROV, webhooks y una puerta de CI — contados contra una cuota que se publica con el plan. Cada respuesta se verifica sin conexión contra las claves de firma publicadas.

Pagar nunca cambia una medición. Inicio rápido · openapi.json · Conformidad

Tres caminos hacia abajo

Documentación. Especificaciones. Claves.

API

Cada operación, con un ejemplo.

La referencia se genera desde el servicio en producción: 274 operaciones, cada una con un ejemplo resuelto y la puerta tras la que se encuentra. El inicio rápido lleva a un agente a su primera decisión firmada en un minuto.

Referencia de la API · Inicio rápido · SDK

Especificaciones

Los contratos detrás de la respuesta.

Resolve es el protocolo; la cabecera de recibo, la grapa, Resolve sobre DNS, el archivo de bloqueo de herramientas y el protocolo de observador son las especificaciones contra las que implementa un proveedor. Cada una tiene un documento versionado y una suite de conformidad.

Resolve · Cabecera de recibo · Protocolo de observador

Claves

Publicadas, rotadas, verificables.

Las claves de firma se publican con su registro de rotación; un único script sin dependencias verifica sin conexión cualquier respuesta, recibo o exportación. Una clave de licencia se crea desde la página de precios y se muestra una sola vez; las cuotas y los términos son públicos.

Claves de firma · Términos de la API · Planes y cuotas

1 · El contrato central

9 operaciones que necesita un agente, versionadas y mantenidas.

Siguen en /api/v1 y responden al menos 180 días después de anunciarse una /api/v2. Los campos estables solo cambian en una nueva versión mayor; todo lo que devuelven se verifica sin conexión.

ParaLlamadaQué obtienes
preguntarGET /api/v1/resolveuna respuesta firmada sobre un dominio: qué permite, sirve y declara, y una decisión por acción
preguntarPOST /api/v1/resolvelo mismo para 1 a 100 dominios
decidirPOST /api/v1/preflightuna decisión firmada para una acción, con un recibo que guardar
reciboGET /api/v1/decisions/{sha256}para un sitio: comprobar el recibo que un agente presenta en la cabecera CrawlCheck-Receipt
revocaciónGET /api/v1/revocationsla lista firmada de dominios cuyas decisiones connect y transact están revocadas ahora
visitanteGET /api/v1/visitorpara un sitio: ¿viene esta petición realmente del agente que nombra?
visitantePOST /api/v1/visitorlo mismo para 1 a 100 peticiones
mcpGET /api/v1/mcp/scanantes de conectar: las herramientas que lista un servidor MCP remoto, analizadas contra el envenenamiento
mcpPOST /api/v1/mcp/lock/checkantes de cada sesión: comparar las herramientas de un servidor con el lockfile que guardaste

Marcadas como x-core en /openapi.json · La lista en JSON · Política de compatibilidad

2 · Las especificaciones

9 documentos contra los que implementa un proveedor.

Cada uno es un documento versionado; este servicio es la implementación de referencia.

3 · SDK

Preguntar, verificar y proteger en una llamada.

TypeScript y JavaScript

npm i @crawlcheck/sdk

Versión 1.5.2 en npm; el mismo tarball se sirve en /sdk.

Python

pip install crawlcheck

Versión 1.5.3 en PyPI, sin dependencias.

MCP

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

Listado en el registro MCP oficial como io.github.emmanuelorta/crawlcheck.

4 · Claves y conformidad

Nada de esto hay que creerlo a ciegas.

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 del verificador servido hoy: b22547e95463d03e1c4177ae6de8ba23c1316629766f0138375edf12d9d77183. Comprobar un registro en el navegador →

5 · Cuotas y condiciones

Publicadas con el plan.

PlanEscaneos al mesConsultas con clave al mes
Developer2.000100.000
Growth20.0001.000.000
Watch50010.000
Agency5.00050.000
Network20.000250.000

La respuesta firmada, la decisión de preflight y el escaneo gratuito no se contabilizan. Planes → · Condiciones de la API → · Política de compatibilidad →

La API, por carriles

104 de 274 operaciones, asignadas a 5 carriles.

El mapa de carriles es el subconjunto guiado; los recuentos de operaciones y la referencia completa se generan desde el archivo OpenAPI que publica el servicio.

CarrilOperacionesPor ejemplo
Decidir57 operaciones · 46 sin claveGET /api/v1/resolve
POST /api/v1/preflight
GET /api/v1/resolve-prefix/{prefix}
Medida6 operaciones · 3 sin claveGET /sandbox
POST /api/v1/scan
POST /api/scan
Leer23 operaciones · 9 sin claveGET /api/v1/reports/{id}
GET /r/{id}.json
GET /r/{id}.raw.json
Datos5 operaciones · 5 sin claveGET /api/public/counts
GET /api/corpus/state
GET /api/telemetry
Herramientas13 operaciones · 9 sin clavePOST /api/tool/verify
GET /api/tool/robots
GET /api/tool/llms

Cada operación, con un ejemplo resuelto →

Documentación

Todo lo demás, en una lista.

Legible por máquinas

Preguntas sobre esta página

Q¿Necesito una clave?
No para la respuesta firmada, la decisión de preflight ni el escaneo gratuito. Una clave añade los carriles de medición — escaneos, lotes, registros para máquinas, exportaciones, webhooks, la puerta de CI — con una cuota publicada con el plan.
Q¿Qué SDK existen?
Clientes tipados en npm y PyPI, idénticos byte a byte a los paquetes servidos desde este sitio, con el verificador sin conexión incluido. Un servidor MCP está listado en el registro MCP oficial, y el HTTP simple funciona en todo lo demás.
Q¿Cómo verifico una respuesta sin conexión?
Cada respuesta, recibo y exportación está firmada con Ed25519 y una clave publicada. Un único script sin dependencias, crawlcheck-verify.mjs, comprueba cualquiera de ellos en tu propia máquina; los paquetes de pruebas llevan además la raíz sellada del día y la marca de tiempo en Bitcoin.
Q¿Dónde están las especificaciones?
Resolve es el protocolo; la cabecera de recibo, la grapa, Resolve sobre DNS, el archivo de bloqueo de herramientas y el protocolo de observador tienen cada uno un documento versionado y una suite de conformidad que puedes ejecutar contra tu propia implementación.
Q¿Cuáles son las cuotas?
Developer 2.000 escaneos al mes, Studio 1.500, Agency 5.000, Growth y Network 20.000. La respuesta firmada y la decisión de preflight no se contabilizan. Las cuotas y los términos son públicos y solo cambian con aviso.