cloud

Überblick über den cloud skill

Wofür der cloud skill gedacht ist

Der cloud skill ist ein dokumentationsgestützter Helfer für Browser Use Cloud, die gehostete Plattform und API für Browser-Automatisierung. Er eignet sich besonders für alle, die Websites über den Cloud-Service automatisieren, die REST API oder SDKs nutzen, externe Browser-Tools per CDP anbinden oder Workflows rund um Sessions, Profile, Proxys und Live-Monitoring entwerfen möchten.

Wer diesen cloud skill installieren sollte

Installiere diesen cloud skill, wenn deine eigentliche Aufgabe zu einem der folgenden Punkte passt:

• Browser Use Cloud schnell starten, ohne jede Referenzdatei komplett lesen zu müssen
• zwischen v2 REST API, v3 agent API, SDK-Nutzung oder direkter Browser-Anbindung wählen
• Browser-Aufgaben aus Python, TypeScript, cURL oder externen Tools automatisieren
• Browser-Automatisierung in gehosteter Infrastruktur für Browser Automation-Anwendungsfälle betreiben
• mit Sessions, persistenten Profilen, Residential Proxies, CAPTCHA-Handling oder Webhooks arbeiten

Installiere ihn nicht, wenn du eigentlich Hilfe bei der Konfiguration der Open-Source-Lokalbibliothek browser-use für Python brauchst. Der Skill trennt Cloud-Nutzung ausdrücklich vom Open-Source-Agent-Paket.

Was diesen cloud skill von einem generischen Prompt unterscheidet

Ein generischer Prompt kann Browser-Automatisierung grob beschreiben. Dieser cloud skill ist nützlicher, wenn du die konkreten Browser Use Cloud-Pfade brauchst: welche API-Version relevant ist, wie Authentifizierung funktioniert, woher liveUrl kommt, wie sich Cloud-Sessions von einmaligen Runs unterscheiden, wie CDP-Zugriff gestartet wird und welches Integrationsmuster zu deinem Stack passt.

Der größte Mehrwert liegt in Navigation und Fit-Einschätzung, nicht in versteckten Tools. Er führt dich schnell zur richtigen Referenzdatei:

• references/quickstart.md für den ersten Einstieg und Preise
• references/api-v2.md für stabile REST-Endpunkte
• references/api-v3.md für die neuere sessionbasierte agent API
• references/browser-api.md für Playwright, Puppeteer, Selenium und rohes CDP
• references/sessions.md für Session- und Profildesign
• references/features.md für Proxys, Webhooks, Workspaces, Skills, MCP und Live View
• references/patterns.md für parallele Runs, Streaming, Geo-Scraping und strukturierte Ausgaben

Beste Einsatzfälle für cloud bei Browser Automation

Dieser cloud skill ist besonders relevant, wenn du cloud für Browser Automation statt lokaler Browser-Steuerung einsetzen willst. Typische Anwendungsfälle sind:

• Scraping oder Extraktion, die von Stealth und Proxys profitieren
• authentifizierte Workflows, die persistente Browser-Profile brauchen
• Remote-Browser-Sessions, die du über liveUrl beobachten kannst
• direkte Automatisierung aus Playwright, Puppeteer oder Selenium per gehostetem CDP
• Integrationen mit Agent-Systemen, Chat-UIs, No-Code-Tools oder webhook-gesteuerten Backends

Wichtige Hürden vor der Einführung zuerst prüfen

Die meisten Installationsentscheidungen laufen auf einige praktische Fragen hinaus:

• Brauchst du gehostete Cloud-Automatisierung oder lokale Open-Source-Steuerung?
• Willst du stabile v2-REST-Endpunkte oder das neuere v3-Session-/Message-Modell?
• Brauchst du einfache run()-Tasks oder explizites Session-/Profil-Management?
• Arbeitest du mit SDKs, cURL oder externen Browser-Frameworks über CDP?
• Benötigst du geografisches Routing, persistente Authentifizierung oder Webhook-Callbacks?

Wenn diese Fragen noch offen sind, hilft dieser Skill, weil das Repo nach Entscheidungswegen aufgebaut ist und nicht als lineares Tutorial.

So verwendest du den cloud skill

Den cloud skill installieren

Nutze den Standard-Installer für Skills für das Repository und ziele auf den cloud skill:

npx skills add https://github.com/browser-use/browser-use --skill cloud

Nach der Installation solltest du ihn aufrufen, wenn sich deine Anfrage speziell auf Browser Use Cloud bezieht, nicht auf das lokale Open-Source-Paket.

Mit der richtigen Datei für dein Ziel starten

Lies nach Entscheidungspfad, nicht nach Dateireihenfolge:

• Neu auf der Plattform: references/quickstart.md
• Du brauchst stabile API-Abdeckung und cURL-Beispiele: references/api-v2.md
• Du brauchst das neuere Agent-/Session-Modell: references/api-v3.md
• Du brauchst gehosteten Browser-Zugriff aus bestehenden Browser-Frameworks: references/browser-api.md
• Du brauchst persistenten Zustand, Auth oder eine Profilstrategie: references/sessions.md
• Du brauchst fortgeschrittene Features wie Proxys oder Webhooks: references/features.md
• Du brauchst Implementierungsmuster: references/patterns.md

Das ist wichtig, weil der Skill die Produktkomplexität nicht versteckt; er hilft dir, den kürzesten sinnvollen Leseweg zu wählen.

Die vier wichtigsten cloud-Nutzungspfade verstehen

Bevor du einen Prompt formulierst, entscheide dich für einen dieser Wege:

1. run()-Task-Ausführung über SDK
2. v2 REST API mit Task-/Session-/Browser-Endpunkten
3. v3 agent API mit Sessions, Messages und Workspaces
4. direkte CDP-Browser-Verbindung für Playwright, Puppeteer oder Selenium

Viele schwache Prompts scheitern daran, dass sie nach „Browser Use Cloud usage“ fragen, ohne den beabsichtigten Pfad zu benennen.

Authentifizierung korrekt einrichten

Browser Use Cloud verwendet den Header X-Browser-Use-API-Key, und SDKs lesen häufig BROWSER_USE_API_KEY aus der Umgebung.

export BROWSER_USE_API_KEY=your-key

Nützliche Details aus den Referenzen:

• API-Basis für v2: https://api.browser-use.com/api/v2
• API-Basis für v3: https://api.browser-use.com/api/v3
• API-Key erstellen: https://cloud.browser-use.com/new-api-key

Wenn dein Prompt nicht erwähnt, wie Auth gehandhabt werden soll, bleibt die Antwort oft zu abstrakt.

Vor Beispielcode zwischen SDK, REST oder CDP wählen

Nutze SDK-Beispiele, wenn du die einfachste Developer Experience willst.
Nutze REST, wenn du Kontrolle auf Endpunkt-Ebene brauchst.
Nutze CDP, wenn du bereits Browser-Automatisierungscode hast und nur ein gehostetes Browser-Ziel brauchst.

Diese Unterscheidung verändert die Antwort spürbar:

• SDK-Antworten konzentrieren sich auf run(), Sessions, Profile und strukturierte Ausgaben
• REST-Antworten konzentrieren sich auf Endpunkte, Polling, Schemas und Header
• CDP-Antworten konzentrieren sich auf WebSocket-URLs und die Integration mit Browser-Tools

Ein grobes Ziel in einen guten cloud-Nutzungs-Prompt verwandeln

Schwacher Prompt:

Help me use Browser Use Cloud.

Besserer Prompt:

I want cloud usage guidance for Python. I need a hosted browser workflow that logs into a site, persists cookies across runs, uses a US proxy, and lets me monitor progress live. Show whether I should use run() with auto-created sessions or manual sessions with a profile, and point me to the exact repo files to read first.

Warum das besser ist:

• nennt die Sprache
• nennt den Workflow-Typ
• erwähnt Session-Persistenz
• enthält Proxy-Anforderungen
• fragt nach Live-Monitoring
• verlangt Dateirouting statt nur Code

Eingabedetails, die die Qualität der Ausgabe verbessern

Für bessere Ausgaben mit dem cloud skill solltest du Folgendes angeben:

• Sprache: Python, TypeScript, cURL
• API-Modus: v2, v3 oder unklar
• Ausführungsstil: One-shot-Task, mehrstufige Session oder direkte Browser-Steuerung
• Zustandsbedarf: zustandslos vs. persistentes Profil
• Infrastruktur-Anforderungen: Proxy-Land, eigener Proxy, Timeout, Bildschirmgröße
• Monitoring-Bedarf: liveUrl, Streaming, Webhooks
• Ausgabeformat: Freitext vs. strukturiertes Schema
• Integrationsziel: Playwright, Puppeteer, Selenium, Chat-UI, Subagent, No-Code-Tool

Ohne diese Angaben ist die Antwort meist korrekt, aber zu allgemein, um sie schnell umzusetzen.

Den cloud skill für Session- und Profildesign nutzen

Ein zentraler praktischer Nutzen des cloud skill ist, dir dabei zu helfen, schlechtes Session-Design zu vermeiden.

Aus den Referenzen:

• run() erstellt meist automatisch eine Session
• manuelle Sessions sind besser für mehrstufige Workflows
• Profile speichern Cookies und Local Storage über Sessions hinweg
• parallele Sessions mit demselben Profil starten von einem Snapshot und sehen die Zustandsänderungen der jeweils anderen nicht

Der letzte Punkt lässt sich beim schnellen Überfliegen leicht übersehen und ist für parallele authentifizierte Workflows wichtig.

Den cloud skill für Browser-Automatisierungs-Frameworks nutzen

Wenn du bereits mit Playwright, Puppeteer oder Selenium arbeitest, ist direkter Cloud-Browser-Zugriff oft der bessere Weg als Agent-Tasks.

Das Repo zeigt einen CDP-Einstiegspunkt wie:

wss://connect.browser-use.com?apiKey=YOUR_KEY&proxyCountryCode=us&timeout=30

Das ist wichtig, weil der Browser beim Verbinden automatisch starten und beim Trennen automatisch stoppen kann. Das ist ein anderes Betriebsmodell als Tasks manuell zu erstellen und wieder aufzuräumen.

Den cloud skill für fortgeschrittene Cloud-Features nutzen

Dieser Skill ist auch dann nützlich, wenn deine Entscheidung eher von Plattform-Features als von Syntax abhängt:

• Stealth-Standards
• Residential Proxies in vielen Ländern
• eigene Proxys
• CAPTCHA-Handling
• Webhooks mit Signaturprüfung
• Live-Ansicht und Share-Links
• Workspaces
• Skills und Marketplace-Unterstützung
• plattformbezogene MCP-Referenzen

Das sind genau die Details, die darüber entscheiden, ob Browser Use Cloud für produktive Anforderungen passt.

Empfohlener erster Workflow nach der Installation

Eine praktische Reihenfolge für neue Nutzer:

1. references/quickstart.md lesen
2. einen trivialen ersten Task per SDK oder cURL ausführen
3. entscheiden, ob dein echter Workflow manuelle Sessions braucht
4. Profile nur hinzufügen, wenn du persistenten Login oder Zustand brauchst
5. Proxy- und Geografie-Einstellungen nur ergänzen, wenn sie wirklich nötig sind
6. strukturierte Ausgaben oder Webhooks erst ergänzen, wenn der Basisweg funktioniert
7. für Nebenläufigkeit oder Streaming zu references/patterns.md wechseln

Diese Reihenfolge reduziert Verwirrung und verhindert, dass du zu früh zu viel Architektur entwirfst, bevor der erste erfolgreiche Run steht.

FAQ zum cloud skill

Ist dieser cloud skill nur Dokumentation, oder verändert er auch Verhalten?

Er ist in erster Linie ein Skill zur Referenz-Navigation. Sein Wert besteht darin, einem Agenten oder Nutzer zu helfen, den richtigen Dokumentationspfad für Browser Use Cloud auszuwählen und mit weniger falschen Annahmen zu antworten. Er ersetzt weder das SDK noch die API der Plattform.

Ist der cloud skill gut für Einsteiger?

Ja, wenn du speziell bei Browser Use Cloud neu bist. Der beste Einstieg ist references/quickstart.md. Du solltest aber trotzdem wissen, ob du einfache Task-Ausführung, Session-Management oder Browser-Steuerung auf Framework-Ebene willst.

Wann sollte ich diesen cloud skill nicht verwenden?

Nutze diesen cloud skill nicht für Fragen zu den Interna der lokalen Open-Source-Bibliothek browser-use, zur Agent-Konfiguration oder zum Setup des Nicht-Cloud-Pakets. Der Skill sagt ausdrücklich, dass dafür der Open-Source-Skill gedacht ist.

Sollte ich v2 oder v3 verwenden?

Nutze v2, wenn du die stabile REST API mit breiter Endpunkt-Abdeckung willst.
Nutze v3, wenn du das neuere BU Agent API-Modell mit Sessions, Messages, Files und Workspaces willst und akzeptierst, dass es in den Referenzen als experimentell markiert ist.

Kann dieser cloud skill bei normalen Browser-Frameworks helfen?

Ja. Das Repo enthält mit references/browser-api.md ausdrücklich eine Referenz für Playwright, Puppeteer, Selenium und direkte CDP-Verbindungen zu gehosteten Browsern.

Ist cloud für Browser Automation besser als ein normaler Prompt?

Für Browser Use Cloud-Aufgaben in der Regel ja. Ein normaler Prompt übersieht leicht plattformspezifische Fakten wie Auth-Header, Endpunkt-Versionen, liveUrl, Profilverhalten, Webhook-Signaturen oder das CDP-Verbindungsmodell mit automatischem Start.

Deckt der cloud skill Preise und operative Einschränkungen ab?

Ja, die Quickstart-Referenz enthält Preis- und FAQ-Material, und andere Referenzen decken Timeout, Session-Handling, Hinweise zu Nebenläufigkeit und Feature-spezifische Einschränkungen ab.

So verbesserst du den cloud skill

Bitte um eine Entscheidung, nicht nur um eine Erklärung

Der schnellste Weg zu besseren Ausgaben mit dem cloud skill ist, ihn zwischen Optionen entscheiden zu lassen:

• „Should I use v2, v3, or CDP?”
• „Should this be auto-session or manual session?”
• „Should I use a profile or keep it stateless?”

So entsteht umsetzbare Anleitung statt einer breiten Zusammenfassung.

Gib eine konkrete Aufgabe und Umgebung an

Besser:

I need cloud install and usage help for a TypeScript backend. The workflow logs into a dashboard weekly, downloads a file, and posts completion to my server. I need persistent auth, webhook notifications, and a recommendation between SDK and REST.

Das verbessert die Ergebnisse, weil Sprache, Taktung, Zustandsanforderungen und die Rückmeldung nach Abschluss klar werden.

Sag dem Skill, was zwischen Runs erhalten bleiben muss

Ein häufiger Fehler ist zu ungenau beschriebener Zustand. Wenn Login, Cookies, Local Storage oder gespeicherte Credentials wichtig sind, sag das ausdrücklich und bitte um profilbasierte Hinweise aus references/sessions.md.

Wenn Zustand keine Rolle spielt, sag auch das. Dann kann der Skill einfachere One-shot-Runs empfehlen.

Gib an, ob du Beobachtung oder Callbacks brauchst

Viele Nutzer brauchen eines der folgenden Dinge, vergessen aber danach zu fragen:

• Ausführung live über liveUrl beobachten
• Step-Updates streamen
• Webhook-Callbacks erhalten, wenn Tasks abgeschlossen sind

Das führt zu unterschiedlichen Implementierungsmustern und zu unterschiedlichen Dateien, die du lesen solltest.

Frage zuerst nach dem kleinsten gangbaren Weg

Ein gutes Verbesserungsmuster ist:

1. nach dem kleinsten funktionierenden Beispiel fragen
2. es ausführen
3. danach fragen, wie man Profile, Proxys oder Webhooks ergänzt

Dieser Skill ist am stärksten, wenn er bei der Einführung in der richtigen Reihenfolge hilft, nicht wenn er in einem einzigen Durchlauf die komplette Produktionsarchitektur entwerfen soll.

Auf Verwechslungen bei API-Versionen achten

Eine der einfachsten Ursachen für schwache Ausgaben ist das Vermischen von v2- und v3-Konzepten in derselben Anfrage. Wenn du Vergleiche willst, frage nach einem Vergleich. Wenn du Implementierung willst, nenne genau eine Version.

Guter Prompt:

Compare Browser Use Cloud v2 vs v3 for a multi-step agent workflow, then recommend one and give only that version's starter example.

Nach Datei-Ebene und Lesewegen fragen

Das Repo enthält genug Referenzmaterial, dass gezielte Lesewege viel Zeit sparen. Stelle Fragen wie:

• „Which file should I read first for webhook verification?”
• „Which reference covers CDP and Playwright setup?”
• „Which document explains concurrent sessions with the same profile?”

So wird der cloud guide handlungsnäher als eine generische Zusammenfassung.

Ausgaben mit klaren Erfolgskriterien verbessern

Statt:

Show me cloud usage.

Besser:

Show me a cloud usage path that gets from API key to first successful task in under 10 minutes, then list the next file to read if I need structured output.

Erfolgskriterien zwingen die Antwort in Richtung eines praktikablen Einführungswegs.

Nach der ersten Antwort mit Lücken weiterarbeiten, nicht neu anfangen

Nach der ersten Antwort verbesserst du sie am besten, indem du konkret benennst, was noch fehlt:

• fehlendes Auth-Handling
• fehlendes Polling-Beispiel
• fehlendes Session-Cleanup
• fehlende Proxy-Konfiguration
• fehlendes Schema für strukturierte Ausgabe
• fehlende Webhook-Verifikation
• fehlende Playwright-Verbindungsdetails

So entstehen bessere zweite Antworten, als wenn du von vorne neu fragst.

Der beste Weg zu wertvoller cloud-Anleitung

Der cloud skill liefert die besten Ergebnisse, wenn dein Prompt Folgendes enthält:

• deinen Stack
• dein Ziel bei der Browser-Automatisierung
• ob Zustand erhalten bleiben muss
• ob gehostete Browser-Steuerung oder Agent-Ausführung bevorzugt ist
• ob du Monitoring, Streaming oder Webhooks brauchst
• ob Geo-Routing oder Stealth-Einschränkungen wichtig sind

Diese Kombination gibt dem Skill genug Kontext, um dich zum passenden Browser Use Cloud-Material zu führen und sofort umsetzbare Anleitung zu liefern.