CrawlCheck
Pour les développeurs et les éditeurs · API, spécifications, clés

Que peut demander votre code sur n’importe quel domaine ?

En une phrase

CrawlCheck pour les développeurs est une API documentée — chaque opération dans un fichier OpenAPI 3.1 avec un exemple complet — qui renvoie sans clé une réponse signée et vérifiable hors ligne sur n’importe quel domaine, ainsi que des volets de mesure comptabilisés, des SDK typés, des clés de signature publiées et une suite de conformité pour quiconque bâtit sur les spécifications ou les implémente.

Une API documentée : 274 opérations sur 238 chemins dans un fichier OpenAPI 3.1, chacune avec un exemple complet. Une réponse signée par domaine, des SDK typés sur npm et PyPI, un serveur MCP dans le registre officiel, et des clés avec des quotas publiés.
GET https://crawlcheck.io/api/v1/resolve?domain=example.com
POST https://crawlcheck.io/api/v1/preflight

La réponse signée et la décision de preflight ne nécessitent aucune clé. Une clé ajoute les volets de mesure — analyses, lots, enregistrements machine avec les octets derrière chaque constat, exports OpenTelemetry et PROV, webhooks et une barrière CI — comptabilisés sur un quota publié avec le forfait. Chaque réponse se vérifie hors ligne avec les clés de signature publiées.

Payer ne change jamais une mesure. Démarrage rapide · openapi.json · Conformité

Trois chemins vers le bas

Docs. Spécifications. Clés.

API

Chaque opération, avec un exemple.

La référence est générée depuis le service en production : 274 opérations, chacune avec un exemple complet et la barrière derrière laquelle elle se trouve. Le démarrage rapide amène un agent à sa première décision signée en une minute.

Référence de l’API · Démarrage rapide · SDK

Spécifications

Les contrats derrière la réponse.

Resolve est le protocole ; l’en-tête de reçu, l’agrafe, Resolve par DNS, le verrou d’outils et le protocole d’observateur sont les spécifications contre lesquelles un éditeur implémente. Chacune a un document versionné et une suite de conformité.

Resolve · En-tête de reçu · Protocole d’observateur

Clés

Publiées, renouvelées, vérifiables.

Les clés de signature sont publiées avec leur registre de rotation ; un seul script sans dépendance vérifie hors ligne toute réponse, tout reçu ou tout export. Une clé de licence est créée depuis la page des tarifs et affichée une seule fois ; les quotas et les conditions sont publics.

Clés de signature · Conditions de l’API · Forfaits et quotas

1 · Le contrat de base

9 opérations dont un agent a besoin, versionnées et maintenues.

Elles restent sous /api/v1 et continuent de répondre au moins 180 jours après l’annonce d’une /api/v2. Les champs stables ne changent que dans une nouvelle version majeure ; tout ce qu’elles renvoient se vérifie hors ligne.

PourAppelCe que vous obtenez
demanderGET /api/v1/resolveune réponse signée sur un domaine : ce qu’il autorise, sert et déclare, et une décision par action
demanderPOST /api/v1/resolvela même chose pour 1 à 100 domaines
déciderPOST /api/v1/preflightune décision signée pour une action, avec un reçu à conserver
reçuGET /api/v1/decisions/{sha256}pour un site : vérifier le reçu qu’un agent présente dans l’en-tête CrawlCheck-Receipt
révocationGET /api/v1/revocationsla liste signée des domaines dont les décisions connect et transact sont révoquées maintenant
visiteurGET /api/v1/visitorpour un site : cette requête vient-elle vraiment de l’agent qu’elle nomme
visiteurPOST /api/v1/visitorla même chose pour 1 à 100 requêtes
mcpGET /api/v1/mcp/scanavant de se connecter : les outils qu’un serveur MCP distant liste, analysés contre l’empoisonnement
mcpPOST /api/v1/mcp/lock/checkavant chaque session : comparer les outils d’un serveur au lockfile conservé

Marquées x-core dans /openapi.json · La liste en JSON · Politique de compatibilité

2 · Les spécifications

9 documents sur lesquels un éditeur s’appuie pour implémenter.

Chacun est un document versionné ; ce service en est l’implémentation de référence.

  • Protocole Resolve
    La réponse signée sur un domaine : points d’accès, signature, vérification hors ligne et versionnage.
  • En-tête de reçu
    Comment un agent qui a demandé avant d’agir le prouve au site sur lequel il agit.
  • Staple
    Un site sert sa propre réponse signée, pour qu’un agent la vérifie sans requête supplémentaire.
  • Resolve par DNS
    La réponse signée de chaque domaine sous forme d’enregistrement TXT.
  • Lockfile d’outils MCP
    Fige les outils qu’un opérateur a approuvés sur un serveur MCP ; le client refuse tout changement.
  • Protocole d’observateur
    Faire tourner un observateur indépendant : enregistrer une clé et signer ce que votre réseau a reçu.
  • Suite d’acceptation du guard
    Les cas de test signés que tout guard doit réussir avant qu’un agent n’agisse.
  • Accord de niveau de service
    Objectifs de disponibilité et de latence pour les offres payantes.
  • Erreurs, sécurité et confidentialité
    Ce qui peut échouer, et comment chaque réponse et chaque document signé traitent la sécurité et la confidentialité.
3 · SDK

Demander, vérifier et protéger en un appel.

TypeScript et JavaScript

npm i @crawlcheck/sdk

Version 1.5.2 sur npm ; la même archive est servie sur /sdk.

Python

pip install crawlcheck

Version 1.5.3 sur PyPI, sans dépendances.

MCP

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

Référencé dans le registre MCP officiel sous io.github.emmanuelorta/crawlcheck.

4 · Clés et conformité

Rien ici n’a besoin d’être cru sur parole.

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 du vérificateur servi aujourd’hui : b22547e95463d03e1c4177ae6de8ba23c1316629766f0138375edf12d9d77183. Vérifier un enregistrement dans le navigateur →

5 · Quotas et conditions

Publiés avec le forfait.

OffreAnalyses par moisRequêtes avec clé par mois
Developer2 000100 000
Growth20 0001 000 000
Watch50010 000
Agency5 00050 000
Network20 000250 000

La réponse signée, la décision de preflight et l’analyse gratuite ne sont pas décomptées. Offres → · Conditions de l’API → · Politique de compatibilité →

L’API, par volet

104 des 274 opérations, réparties en 5 volets.

La carte des volets est le sous-ensemble guidé ; le nombre d’opérations et la référence complète sont générés depuis le fichier OpenAPI que le service publie.

VoletOpérationsPar exemple
Décider57 opérations · 46 sans cléGET /api/v1/resolve
POST /api/v1/preflight
GET /api/v1/resolve-prefix/{prefix}
Mesure6 opérations · 3 sans cléGET /sandbox
POST /api/v1/scan
POST /api/scan
Lire23 opérations · 9 sans cléGET /api/v1/reports/{id}
GET /r/{id}.json
GET /r/{id}.raw.json
Données5 opérations · 5 sans cléGET /api/public/counts
GET /api/corpus/state
GET /api/telemetry
Outils13 opérations · 9 sans cléPOST /api/tool/verify
GET /api/tool/robots
GET /api/tool/llms

Chaque opération, avec un exemple complet →

Documentation

Tout le reste, en une liste.

Lisible par les machines

Questions sur cette page

QAi-je besoin d’une clé ?
Pas pour la réponse signée, la décision de preflight ou l’analyse gratuite. Une clé ajoute les volets de mesure — analyses, lots, enregistrements machine, exports, webhooks, la barrière CI — sur un quota publié avec le forfait.
QQuels SDK existent ?
Des clients typés sur npm et PyPI, identiques octet pour octet aux archives servies depuis ce site, avec le vérificateur hors ligne inclus. Un serveur MCP est listé dans le registre MCP officiel, et le HTTP simple fonctionne partout ailleurs.
QComment vérifier une réponse hors ligne ?
Chaque réponse, reçu et export est signé en Ed25519 avec une clé publiée. Un seul script sans dépendance, crawlcheck-verify.mjs, vérifie n’importe lequel sur votre propre machine ; les lots de preuves portent aussi la racine scellée du jour et l’horodatage Bitcoin.
QOù sont les spécifications ?
Resolve est le protocole ; l’en-tête de reçu, l’agrafe, Resolve par DNS, le verrou d’outils et le protocole d’observateur ont chacun un document versionné et une suite de conformité que vous pouvez exécuter contre votre propre implémentation.
QQuels sont les quotas ?
Developer 2 000 analyses par mois, Studio 1 500, Agency 5 000, Growth et Network 20 000. La réponse signée et la décision de preflight ne sont pas comptabilisées. Les quotas et les conditions sont publics et ne changent qu’avec préavis.