Clona un sitio web con una API — pensada para agentes

La mayoría de las APIs asumen que una persona leerá la documentación, conectará las llamadas y vigilará la integración. Esta no.

Con la Clone API de Clonesite, una persona configura la confianza: crea una key o aprueba el login OAuth del agente. Si la integración necesita callbacks, también revela un secreto de firma para webhooks. Después el agente hace el resto: valida el payload, ejecuta una prueba mock gratuita, convierte una URL viva en código React y Tailwind editable, espera el build y descarga el zip.

Un paso humano, luego un bucle del agente: validar, crear, esperar, descargar.

Modelo mental

La integración tiene una ruta de credenciales y cinco operaciones de clonación:

• Persona, una vez: crea una API key en /developers o aprueba el login OAuth del agente. Si quieres callbacks, revela y guarda el secreto de webhook de la cuenta.
• Agente, antes de gastar: ejecuta POST /clone-requests/preflight y, durante el setup, POST /clone-requests/test-runs.
• Agente, clon real: crea la solicitud, consulta el estado o recibe un webhook, y finalmente desbloquea y descarga el código.

No necesitas SDK, sesión de navegador ni clicks en el dashboard después de crear la key. La base REST es:

https://clonesite.ai/api/v1

Los clientes compatibles con MCP pueden usar el endpoint Streamable HTTP alojado:

https://clonesite.ai/mcp

Paso 1 — Crea la key

Inicia sesión, abre /developers y crea tu primera key. Verás un valor como cs_live_a1b2c3d4... una sola vez. Se guarda hasheado, así que cópialo de inmediato y pásalo al agente, o guárdalo como variable de entorno.

Trata la key como una contraseña: quien la tenga puede gastar tus créditos. No entregues cookies de sesión, magic links, credenciales de pago ni secretos que solo pertenecen al dashboard.

Si envías callbackUrl, abre el panel de webhooks, rota el secreto y guarda el valor whsec_... en tu servidor. El secreto pertenece a la cuenta; el callback pertenece a cada solicitud, así que distintos jobs pueden publicar en endpoints distintos.

Paso 2 — Autentica cada llamada

Cada request lleva la credencial en el header Authorization:

curl https://clonesite.ai/api/v1/clone-requests/api_req_example \
  -H "Authorization: Bearer cs_live_a1b2c3d4..."

Los permisos separan crear solicitudes, leer estado y descargar código: clone_requests:create, clone_requests:read y source_downloads:create.

Paso 3 — Preflight y prueba gratuita

Preflight antes de cobrar. Test runs prueban polling, webhooks y descarga sin coste.

Antes de gastar créditos, valida el mismo payload con preflight. Comprueba key, permisos, payload, créditos y configuración de webhook cuando existe callbackUrl. No crea una solicitud, no lanza un job, no cobra créditos y no envía webhook.

Durante el setup, usa test-runs con la misma key y el mismo handler de webhook. Crea una solicitud mode: "test" gratuita y envía eventos firmados clone.ready o clone.failed. Así pruebas polling, webhooks y descarga fixture por los mismos endpoints que usará producción.

Paso 4 — Crea y espera el clon real

Envía la URL pública y un prompt. En llamadas live y test-runs, el header Idempotency-Key es obligatorio para que los reintentos sean seguros.

Crear una solicitud live cuesta 5 créditos y devuelve un id estable api_req_*. La vista previa es gratuita; descargar el código es un paso posterior.

El clon corre de forma asíncrona y normalmente tarda entre una y tres horas. Puedes consultar:

curl https://clonesite.ai/api/v1/clone-requests/api_req_abc123 \
  -H "Authorization: Bearer cs_live_a1b2c3d4..."

Cinco créditos al crear. Si falla, se reembolsan automáticamente. La preview sigue siendo gratuita.

Webhooks, descarga y discovery

Si pasaste callbackUrl, Clonesite publica un evento firmado cuando la solicitud termina. Verifica la firma con el secreto whsec_... y luego llama al endpoint de estado: el webhook notifica, pero el estado sigue siendo la fuente de verdad.

Cuando la preview está lista y quieres el código, llama a POST /clone-requests/:id/source-downloads. El primer desbloqueo cuesta 100 créditos y devuelve una URL firmada de corta duración. Llamar de nuevo solo firma otra URL; no vuelve a cobrar si ya estaba desbloqueada.

La API también está hecha para discovery por agentes:

• llms.txt explica qué hace Clonesite y sus límites.
• openapi.json contiene contratos, permisos y códigos de error.
• MCP server card anuncia el servidor MCP alojado en https://clonesite.ai/mcp.

Si prefieres la interfaz alojada, la guía paso a paso cubre el mismo flujo sin escribir código, y la página de precios lista los paquetes de créditos.