Cloner un site web avec une API — conçue pour les agents
Guide développeur de la Clone API de Clonesite via REST ou MCP hébergé. Créez une clé API ou utilisez OAuth pour agent, ajoutez un secret webhook seulement si vous voulez des callbacks, puis laissez l'agent prévalider, créer les requêtes, suivre le statut et télécharger du code React et Tailwind éditable.
La plupart des APIs supposent qu'un humain va lire la documentation, connecter les appels et surveiller l'intégration. Celle-ci non.
Avec la Clone API de Clonesite, l'humain configure la confiance: il crée une clé ou approuve le login OAuth de l'agent. Si votre intégration a besoin de callbacks, il révèle aussi un secret de signature webhook. Ensuite l'agent fait le reste: preflight, test mock gratuit, transformation d'une URL vivante en source React et Tailwind éditable, attente du build et téléchargement du code.
Une étape humaine, puis une boucle contrôlée par l'agent: vérifier, créer, attendre, télécharger.
Le modèle mental
L'intégration a une seule voie de credential et cinq opérations:
- Humain, une fois: créer une clé API dans
/developersou approuver OAuth agent login. Si vous voulez des callbacks, révéler et stocker le secret webhook du compte. - Agent, avant de dépenser: appeler
POST /clone-requests/preflightet, pendant le setup,POST /clone-requests/test-runs. - Agent, clonage réel: créer la requête, lire le statut ou recevoir un webhook, puis déverrouiller et télécharger le source.
Aucun SDK n'est requis, aucune session navigateur, aucun clic dashboard après création de la clé. La base REST est:
https://clonesite.ai/api/v1
Les clients compatibles MCP peuvent utiliser l'endpoint Streamable HTTP hébergé:
https://clonesite.ai/mcp
Créer la clé et authentifier les appels
Connectez-vous, ouvrez /developers et créez votre première clé. Une valeur comme cs_live_a1b2c3d4... s'affiche une seule fois. Elle est stockée hachée: copiez-la immédiatement et donnez-la à votre agent ou à une variable d'environnement.
Chaque appel porte ensuite l'en-tête Authorization:
curl https://clonesite.ai/api/v1/clone-requests/api_req_example \
-H "Authorization: Bearer cs_live_a1b2c3d4..."
Les permissions séparent création, lecture et téléchargement: clone_requests:create, clone_requests:read et source_downloads:create.
Preflight et test gratuit
Preflight avant de facturer. Test-runs exerce polling, webhooks et téléchargement gratuitement.
Avant de dépenser des crédits, validez le même payload avec preflight. Il vérifie la clé, les permissions, le payload, les crédits et la configuration webhook si callbackUrl est présent. Il ne crée pas de requête, ne lance pas de job, ne facture rien et n'envoie pas de webhook.
Pendant le setup, utilisez test-runs avec la même clé et le même handler webhook. Cela crée une requête mode: "test" gratuite et envoie des événements signés clone.ready ou clone.failed. Vous testez donc le polling, les webhooks et le téléchargement fixture par les mêmes endpoints que la production.
Créer, attendre, télécharger
Une requête live reçoit l'URL publique, un prompt et un Idempotency-Key. Cette clé rend les retries sûrs: même clé et même body retournent la même requête; même clé et body différent produit un conflit.
Créer une requête live coûte 5 crédits. Le statut évolue de queued à processing, puis ready ou failed. Un échec rembourse automatiquement ces 5 crédits.
Quand la preview est prête, POST /clone-requests/:id/source-downloads déverrouille le ZIP source. Le premier déverrouillage coûte 100 crédits et retourne une URL signée de courte durée. Les appels suivants ne refacturent pas; ils re-signent seulement une nouvelle URL.
Webhooks et discovery agent
Si vous passez callbackUrl, Clonesite publie un événement signé à l'état terminal. Vérifiez la signature avec whsec_..., puis relisez le statut: le webhook est une notification, pas la source de vérité.
L'API est aussi conçue pour qu'un agent se débrouille:
- llms.txt décrit Clonesite et ses limites en langage clair.
- openapi.json donne le contrat machine-readable.
- MCP server card annonce le serveur MCP hébergé.
Vous préférez l'interface? Le guide pas à pas couvre le même flux sans écrire de code, et la page de prix liste les packs de crédits.
FAQ
Qu'est-ce qu'une API de clonage de site web?+
C'est une API qui reçoit une URL publique et retourne le code source éditable de la page via REST ou MCP. Un agent ou un script crée la requête, suit son statut et télécharge le résultat.
Comment s'authentifier auprès de la Clone API?+
Chaque requête porte un token Bearer. Ce token peut être une clé API créée par un humain ou un access token OAuth avec les scopes Clone API.
Un agent IA peut-il utiliser l'API seul?+
Oui. Discovery via llms.txt et openapi.json, test mock gratuit, création idempotente et webhooks optionnels permettent à l'agent d'exécuter tout le flux après autorisation humaine.
Existe-t-il un test gratuit?+
Oui. Le preflight valide la forme de la requête et les credentials sans dépenser de crédits ni lancer un vrai clonage.
Quel format est téléchargé?+
Un zip React et Tailwind. C'est du code éditable, pas une capture ni un bundle verrouillé.
Guides associés
Clonage d'URL vs capture d'écran vers code : ce qui change vraiment dans le résultatLe clonage d'URL lit la vraie structure d'une page en ligne — DOM, CSS, polices, liens et points de rupture responsive — et la reconstruit en code éditable. La capture d'écran vers code ne voit que des pixels : elle déduit la mise en page et perd les polices, les liens et le responsive. La différence se voit directement dans l'utilisabilité du résultat.
Les meilleurs cloneurs de site web IA en 2026Le meilleur cloneur de site web IA est celui dont l'entrée et la sortie correspondent à votre besoin : URL-vers-code pour réutiliser une vraie mise en page, capture-vers-code pour une maquette figée, prompt-vers-site pour partir de zéro. Comparez-les selon le type d'entrée, l'éditabilité et la qualité d'export avant de choisir.
Comment cloner un site avec Claude Code (2026): le vrai pipeline et ses limitesGuide builder du clonage avec Claude Code: pipeline agentique en cinq phases, mesure d'une page réelle, reconstruction en React et Tailwind éditable, setup requis, cas qui cassent sans supervision et moment où choisir un cloner hébergé.