Website per API klonen — gebaut für KI-Agenten
Ein Entwicklerleitfaden zur Clonesite Clone API über REST oder gehostetes MCP. Erstelle einen API-Key oder nutze OAuth für Agenten, ergänze Webhook-Signing nur bei Callbacks und lass den Agenten Preflight, Clone Request, Status-Polling und den Download von editierbarem React- und Tailwind-Code übernehmen.
Die meisten APIs gehen davon aus, dass ein Mensch die Dokumentation liest, Calls verdrahtet und die Integration überwacht. Diese API ist anders.
Mit der Clonesite Clone API erledigt ein Mensch nur das Vertrauen-Setup: API-Key erstellen oder OAuth-Agent-Login genehmigen. Ein Webhook-Signing-Secret kommt nur dazu, wenn deine Integration Callbacks braucht. Danach übernimmt der Agent: Preflight ausführen, kostenlosen Mock-Test starten, eine Live-URL in editierbaren React- und Tailwind-Code verwandeln, auf den Build warten und den Code herunterladen.
Ein menschlicher Schritt, danach die Agenten-Schleife: prüfen, erstellen, warten, herunterladen.
Das mentale Modell
Die Integration besteht aus einem Credential-Setup und fünf Clone-Operationen:
- Mensch, einmalig: API-Key in
/developerserstellen oder OAuth-Agent-Login genehmigen. Bei Callbacks zusätzlich das accountweite Webhook-Signing-Secret anzeigen und speichern. - Agent, vor dem Ausgeben von Credits:
POST /clone-requests/preflightund während des SetupsPOST /clone-requests/test-runs. - Agent, Live-Clone: Clone Request erstellen, Status pollen oder Webhook empfangen, danach Source freischalten und herunterladen.
Kein SDK ist erforderlich, keine Browser-Session und keine Dashboard-Klicks nach dem Key-Setup. Die REST-Basis ist:
https://clonesite.ai/api/v1
MCP-fähige Clients können den gehosteten Streamable-HTTP-Endpunkt nutzen:
https://clonesite.ai/mcp
API-Key erstellen
Melde dich an, öffne /developers und erstelle deinen ersten Key. Ein Wert wie cs_live_a1b2c3d4... wird genau einmal angezeigt. Er wird gehasht gespeichert, also kopiere ihn sofort und gib ihn deinem Agenten oder einer Environment-Variable.
Behandle den Key wie ein Passwort: Wer ihn besitzt, kann Credits ausgeben. Übergib einem Agenten keine Session-Cookies, Magic-Link-URLs, Payment-Credentials oder Dashboard-Secrets.
Jeden Call authentifizieren
Jeder Request trägt das Bearer-Credential im Authorization-Header:
curl https://clonesite.ai/api/v1/clone-requests/api_req_example \
-H "Authorization: Bearer cs_live_a1b2c3d4..."
Die Permissions sind bewusst getrennt: clone_requests:create, clone_requests:read und source_downloads:create.
Preflight und kostenloser Test
Preflight vor dem Charge. Test Runs prüfen Polling, Webhooks und Download kostenlos.
Vor dem Live-Clone validierst du denselben Payload mit preflight. Geprüft werden API-Key, Permission, Payload, Credits und bei callbackUrl die Webhook-Konfiguration. Preflight erstellt keinen Request, startet keinen Job, zieht keine Credits ab und sendet keinen Webhook.
Während des Setups nutzt du test-runs mit demselben Key und Webhook-Handler. Das erzeugt einen kostenlosen mode: "test"-Request und sendet signierte clone.ready- oder clone.failed-Events. So testest du Polling, Webhooks und sogar einen Fixture-Source-Download über exakt dieselben Endpoints wie später in Produktion.
Live-Request, Status und Download
Ein Live-Create braucht die öffentliche URL, einen Prompt und einen Idempotency-Key. Dieser Header macht Retries sicher: gleicher Key und gleicher Body geben denselben Request zurück; gleicher Key mit anderem Body liefert einen Konflikt.
Ein Live Request kostet 5 Credits. Die Preview bleibt kostenlos. Der Source-Download ist ein separater Schritt, nachdem die Preview bereit ist.
Ein fertiger Clone zeigt Preview und Source-Verfügbarkeit, aber nie direkt eine Download-URL. Zum Herunterladen rufst du POST /clone-requests/:id/source-downloads auf. Der erste Unlock kostet 100 Credits und gibt eine kurzlebige signierte URL zurück. Spätere Calls signieren nur eine frische URL und berechnen nicht erneut.
Agent Discovery
Die API ist nicht nur REST, sondern für Agenten auffindbar:
- llms.txt beschreibt in natürlicher Sprache, was Clonesite macht und wo die Grenzen liegen.
- openapi.json enthält den maschinenlesbaren Vertrag.
- MCP server card und der MCP-Katalog verweisen auf
https://clonesite.ai/mcp.
Wenn du lieber ohne Code arbeitest, erklärt der Schritt-für-Schritt-Guide denselben Ablauf im UI. Die Preisseite zeigt die Credit-Pakete.
FAQ
Was ist eine Website-Clone-API?+
Eine Website-Clone-API nimmt eine öffentliche URL entgegen und liefert editierbaren Quellcode der Seite über REST oder MCP zurück. Statt manuell im UI zu klonen, erstellt ein Agent oder Skript den Request, pollt den Status und lädt das Ergebnis herunter.
Wie authentifiziere ich mich bei der Clonesite Clone API?+
Jeder Request trägt ein Bearer-Token. Das Token ist entweder ein von Menschen erzeugter API-Key oder ein OAuth-Access-Token mit Clone-API-Scopes. Weitere Authentifizierung ist nicht nötig.
Kann ein KI-Agent die Clone API selbstständig nutzen?+
Ja. Discovery über llms.txt und openapi.json, ein kostenloser Mock-Test, idempotente Create-Calls und optionale Webhooks geben einem Agenten den kompletten Ablauf, nachdem ein Mensch das Credential autorisiert hat.
Gibt es einen kostenlosen API-Test?+
Ja. Der Preflight prüft Request-Form, Credential, Berechtigungen und Credits, ohne Credits auszugeben oder einen echten Clone zu starten.
In welchem Format kommt der Quellcode?+
Der Download ist ein ZIP mit React und Tailwind. Es ist editierbarer Code, kein Screenshot und kein gesperrtes Bundle.
Weitere Guides
Die besten KI Website Cloner Tools 2026Der beste Website Cloner ist der, dessen Input und Output zu deiner Aufgabe passen — URL-zu-Code, um ein echtes Layout wiederzuverwenden, Screenshot-zu-Code für ein statisches Mockup und Prompt-zu-Seite zum Bauen von Grund auf. Vergleiche sie nach Input-Typ, Editierbarkeit und Export-Qualität, bevor du wählst.
URL klonen vs. Screenshot zu Code: Was sich im Output wirklich ändertURL-Klonen liest die echte Struktur einer Live-Seite — DOM, CSS, Schriften, Links und responsive Breakpoints — und baut sie als editierbaren Code neu auf. Screenshot zu Code sieht nur Pixel, erschließt also das Layout und verliert Schriften, Links und Responsiveness. Der Unterschied zeigt sich direkt darin, wie brauchbar der Output ist.
Website mit Claude Code klonen (2026): der echte Pipeline-Ablauf und seine GrenzenEin Builder-Guide zum Website-Klonen mit Claude Code: fünf Phasen, Messung im echten Browser, Rekonstruktion als editierbarer React- und Tailwind-Code, Setup, typische Bruchstellen und wann ein gehosteter KI-Website-Cloner sinnvoller ist.