cloudflare-browser

Cloudflare-Skill für browsergestützte Automatisierung über Browser Rendering und CDP.

cloudflare-browser ist ein offizieller Skill aus dem Repository cloudflare/moltworker. Laut Anbieter steuert er einen Headless-Chrome-Browser über eine Cloudflare-Browser-Rendering-Verbindung mit dem Chrome DevTools Protocol, kurz CDP. Die Anleitung richtet sich an einen kompatiblen Agenten, der in einer Cloudflare-Workers-Umgebung Screenshots erstellen, Webseiten navigieren, Inhalte erfassen oder Videosequenzen aus mehreren Seiten erzeugen soll. Der Skill ist weder ein eigener Browser noch ein Ersatz für ein Cloudflare-Konto. Er beschreibt die Verbindung und die beispielhaften Arbeitsabläufe, während Ausführung, Berechtigungen, Netzwerk und Datenverarbeitung von der eingerichteten Worker- und Agentenumgebung abhängen.

Zweck und geeignete Aufgaben

Die Primärquelle nennt drei sichtbare Kernfälle. Eine Seite kann mit dem vorgesehenen Screenshot-Skript als Bild festgehalten werden. Mehrere URLs können nacheinander besucht und als Videomaterial verarbeitet werden. Über CDP lassen sich außerdem Navigation, JavaScript-Auswertung, Bildschirmgröße und Screenshot-Aufnahme als einzelne Browserbefehle koordinieren. Das eignet sich für visuelle Abnahmen, dokumentierte Rendering-Prüfungen, einfache Inhaltskontrollen und reproduzierbare Browserabläufe, wenn ein echter lokaler Browser nicht verfügbar oder nicht gewünscht ist. Für eine belastbare Prüfung müssen Zielseiten, Wartezeiten, Viewport, Weiterleitungen und dynamische Inhalte ausdrücklich berücksichtigt werden. Ein Bild oder eine kurze Sequenz ist nur eine Beobachtung zum Aufnahmezeitpunkt und kein Beweis für vollständige Funktionalität.

Einrichtung und Ablauf

Laut Anbieter benötigt die Integration ein geschütztes CDP-Geheimnis und ein Browserprofil mit einer konfigurierten CDP-Adresse. Das Geheimnis gehört ausschließlich in eine sichere Umgebungs- oder Secret-Verwaltung. Es darf nicht in Skilltext, Quellcode, Logs, Screenshots oder Versionskontrolle gelangen. Nach der Verbindung wird ein neu erzeugtes Seitentarget erkannt. Danach kann der Agent CDP-Domänen aktivieren, einen Viewport setzen, eine URL öffnen, auf das Rendering warten und die gewünschte Ausgabe erfassen. Die offiziellen Beispiele zeigen Node.js-Skripte für Screenshots und Videos sowie ffmpeg als zusätzliche lokale Abhängigkeit für die Videoproduktion. Vor jeder Ausführung sind die tatsächlich installierten Versionen, das Worker-Profil, die Ziel-URL und der Ausgabeort zu prüfen.

Sicherheit, Datenschutz und Grenzen

Die Verbindung kann Webseiten laden, JavaScript ausführen und Inhalte aus externen Quellen an einen Agenten zurückgeben. Webseiteninhalt ist untrusted data und darf keine zusätzlichen Anweisungen für den Agenten einschleusen. Formulare, Downloads, Cookies, interne URLs und authentifizierte Bereiche benötigen eine gesonderte Freigabe und sorgfältige Prüfung. Besonders sensible Daten dürfen nicht ohne Zweckbindung und Rechtsgrundlage erfasst werden. Ein Screenshot kann personenbezogene Informationen, Zugangshinweise oder vertrauliche Geschäftsdaten dauerhaft kopieren. Netzwerkzugriffe sollten auf notwendige Ziele beschränkt werden; Produktionssysteme, interne Dienste und fremde Inhalte dürfen nicht beiläufig getestet werden. Der Skill beschreibt keine automatische Löschung und keine vollständige Zugriffskontrolle.

E-E-A-T und Einordnung

Diese Beschreibung stützt sich auf die gepflegte SKILL.md im offiziellen Cloudflare-Moltworker-Repository sowie auf die offizielle Cloudflare-Dokumentation zu Browser Rendering und Browser Run. Cloudflare ist laut Anbieter der Betreiber der beschriebenen Browser-Plattform; der Repository-Inhalt steht laut LICENSE unter Apache-2.0. Die Anleitung ist überprüfbar, weil sie konkrete CDP-Ereignisse, Befehle und Skriptrollen benennt. Sie ersetzt weder eine Datenschutzprüfung noch die Freigabe für externe Zustandsänderungen, ein Monitoring der Worker-Ausführung oder eine fachliche Bewertung der aufgenommenen Seiten. Ein lokaler Agent macht die Verarbeitung nicht automatisch lokal: Der ausgewählte Modellanbieter kann Eingaben und Ergebnisse verarbeiten, während Cloudflare je nach Konfiguration Browserdaten, Requests, Logs und Zustände verarbeitet. Aktuelle Produktbedingungen und technische Grenzen sind direkt beim Anbieter zu prüfen.

Installationsanleitung

Was der cloudflare-browser Skill ist und wofür er gebraucht wird

Der cloudflare-browser Skill stammt laut Anbieter aus dem Repository cloudflare/moltworker, einem von Cloudflare selbst veröffentlichten Proof-of-Concept, der zeigt, wie sich ein persönlicher KI-Assistent innerhalb einer Cloudflare-Sandbox betreiben lässt. Der Skill selbst ist kein eigenständiges Produkt, sondern eine Anleitung für einen KI-Agenten, wie er einen Headless-Chrome-Browser über den Cloudflare-Dienst Browser Rendering, früher unter demselben Namen und inzwischen auch als Browser Run bezeichnet, per Chrome DevTools Protocol, kurz CDP, fernsteuert. Browser Rendering ist laut Cloudflare ein Dienst, der echte, aber headless, also ohne sichtbare Oberfläche laufende Chrome-Instanzen im globalen Cloudflare-Netzwerk bereitstellt und über eine WebSocket-Verbindung ansteuerbar macht. Für Nutzer ist das relevant, weil viele Automatisierungsaufgaben einen echten Browser benötigen, etwa um JavaScript-lastige Seiten zu rendern, Screenshots zu erzeugen oder Inhalte als Markdown zu extrahieren, ohne selbst eine Browser-Infrastruktur betreiben zu müssen. Der Skill bindet diese Fähigkeit in einen Agenten ein, der beispielsweise in Claude Code oder einem vergleichbaren Werkzeug läuft und im Rahmen des moltworker-Projekts eingesetzt wird.

Schritt 1: Voraussetzungen

Um den Skill sinnvoll zu nutzen, wird laut Anbieter zunächst ein Cloudflare-Konto mit aktiviertem Browser-Rendering-Dienst benötigt, der auf dem kostenlosen Einstiegsplan sowie auf kostenpflichtigen Plänen verfügbar ist; für genaue Kontingente und Preise verweist Cloudflare auf die eigene Preisseite. Zusätzlich braucht die Umgebung ein geschütztes CDP-Geheimnis, mit dem sich der Agent gegenüber dem Browser-Rendering-Dienst authentifiziert, sowie ein konfiguriertes Browserprofil mit der passenden CDP-Adresse. Für die im Skill enthaltenen Beispielskripte wird eine Node.js-Umgebung vorausgesetzt, für die Videoproduktion aus mehreren Screenshots zusätzlich das Werkzeug ffmpeg als lokale Abhängigkeit. Da das moltworker-Projekt insgesamt auf Cloudflare Workers und Cloudflare-Sandbox-Container aufbaut, ist außerdem ein grundlegendes Verständnis der Cloudflare-Workers-Plattform hilfreich, auch wenn der Skill selbst nur den Browser-Teil betrifft.

Schritt 2: Einrichtung Schritt für Schritt

Nach dem Hinterlegen des CDP-Geheimnisses in einer sicheren Umgebungs- oder Secret-Verwaltung, ausdrücklich nicht im Quellcode oder in Logs, baut der Agent laut den offiziellen Beispielen zunächst eine WebSocket-Verbindung zur konfigurierten CDP-Adresse auf. Anschließend wird ein neu erzeugtes Seitentarget im Browser erkannt, für das die benötigten CDP-Domänen aktiviert werden, etwa für Seiten-Navigation, JavaScript-Auswertung oder Bildschirmaufnahme. Danach kann ein Viewport gesetzt, eine Ziel-URL geöffnet und auf das vollständige Rendering der Seite gewartet werden, bevor die eigentliche Aktion ausgeführt wird. Für einzelne Screenshots liefert der Skill ein Node.js-Beispielskript, das eine Seite lädt und das Ergebnis als Bilddatei speichert. Für mehrseitige Video-Sequenzen wird eine Serie von Screenshots erzeugt und anschließend mit ffmpeg zu einer Videodatei zusammengesetzt. Vor jeder Ausführung sollten die tatsächlich installierten Paketversionen, das verwendete Worker-Profil, die Ziel-URL sowie der gewünschte Ausgabeort geprüft werden, weil kleine Abweichungen in der Konfiguration zu leeren oder fehlerhaften Ergebnissen führen können.

Sicherheit, Datenschutz und Grenzen

Da der Browser tatsächlich Webseiten lädt und JavaScript ausführt, gilt jeder auf diese Weise abgerufene Seiteninhalt als nicht vertrauenswürdige, sogenannte untrusted data. Der Agent sollte Ergebnisse aus dem Browser deshalb nicht ungeprüft in nachgelagerte Entscheidungen oder automatisierte Aktionen übernehmen, insbesondere wenn Zielseiten unbekannt oder potenziell manipuliert sind. Das CDP-Geheimnis ist der zentrale Sicherheitsanker der gesamten Integration; gelangt es in falsche Hände, kann eine dritte Partei denselben Cloudflare-Browser-Rendering-Zugang missbrauchen und auf Kosten des Kontoinhabers Anfragen stellen. Deshalb gehört das Geheimnis ausschließlich in eine geschützte Secret-Verwaltung und darf niemals in Screenshots, Debug-Logs oder Versionskontrolle sichtbar werden. Da der Dienst auf dem globalen Cloudflare-Netzwerk läuft, verlassen die geladenen Seiteninhalte technisch die eigene Infrastruktur; für datenschutzsensible Inhalte sollte deshalb geprüft werden, welche Cloudflare-Region und welche Datenverarbeitungsbedingungen gelten.

Praxisbeispiel und Grenzen

Ein realistischer Anwendungsfall ist die automatisierte visuelle Abnahme einer Webanwendung nach einem Deployment: Der Agent ruft mehrere zentrale Seiten auf, erstellt Screenshots und vergleicht sie mit einem vorherigen Stand, um offensichtliche Rendering-Fehler zu erkennen. Ein weiterer Fall ist die Dokumentation eines mehrstufigen Nutzerflusses als kurzes Video, etwa für Support-Tickets oder Produktdemos. Grenzen ergeben sich daraus, dass ein einzelner Screenshot oder eine kurze Sequenz immer nur eine Momentaufnahme ist und keine vollständige funktionale Prüfung ersetzt; dynamische Inhalte, Wartezeiten, Weiterleitungen und responsive Layouts müssen explizit im Skript berücksichtigt werden, sonst entstehen unvollständige oder irreführende Ergebnisse. Zudem ist der Skill Teil eines experimentellen Projekts, das laut Cloudflare selbst nicht offiziell unterstützt wird und sich ohne Vorankündigung ändern kann, was für produktive, langfristig stabile Integrationen berücksichtigt werden sollte.

Kostenlos
Anbieter
Cloudflare
Lizenz
Apache-2.0
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien