Zum Inhalt springen

Cloud-Schnellstart

Starten Sie einen Clearcote-Browser auf unseren Servern und steuern Sie ihn aus Playwright. Sie brauchen einen API-Schlüssel, das SDK und ein zusätzliches Argument.

Gratis€5 Traffic gratis, wenn Sie GitHub verbinden. Ohne Kreditkarte.

Einmaliges Guthaben, eines pro GitHub-Konto. Das GitHub-Konto muss mindestens 30 Tage alt sein.

€5 sichern

1. API-Schlüssel holen

Erstellen Sie einen auf der Seite API keys. Er beginnt mit cc_live_. Halten Sie ihn geheim: Wer ihn besitzt, kann Ihr Guthaben ausgeben. Legen Sie ihn in der Umgebung ab:

export CLEARCOTE_API_KEY=cc_live_...

Sessions werden aus einem Prepaid-Guthaben bezahlt: €1.00 pro GB Traffic, Residential-Proxy inklusive. Aufladen können Sie im Tab Hosted browsers Ihres Dashboards. Siehe Preise und Traffic.

2. Das Paket clearcote hinzufügen

Der Cloud-Modus braucht SDK 0.34.0 oder neuer.

bash
npm i clearcote          # Node 20+
pip install clearcote    # Python 3.8+

3. In der Cloud starten

Übergeben Sie cloud=True (Python) oder cloud: true (Node). Sie erhalten ein ganz normales Playwright-Browser-Objekt zurück, verbunden mit einem Browser auf unseren Servern.

from clearcote import launch

browser = launch(cloud=True, fingerprint="acct-1", country="de")
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close()   # ends the cloud session
Dieser Tab läuft auf Ihrem Rechner.
  • fingerprint wählt das Gerät: Derselbe Seed ergibt jedes Mal dasselbe Gerät. country wählt das Ausgangsland der Residential-IP.
  • Öffnen Sie Seiten in browser.contexts[0]: Dieser Kontext trägt das Profil und die Cookies der Session.
  • browser.close() beendet die Session. Sie zahlen für den verbrauchten Traffic, nicht für die Zeit.
  • Wenn Sie CLEARCOTE_CLOUD=1 setzen, wirkt das wie cloud=True, ohne dass Sie den Code anfassen.

Ohne SDK

Jeder CDP-Client funktioniert: POST /api/v1/browsers liefert eine nur einmal gültige connectUrl, und connectOverCDP von Playwright oder connect von Puppeteer verbindet sich damit. Die vollständige Anleitung mit curl, Node und Python finden Sie unter Gehostete Browser.

Nächste Schritte

  • Lokal oder Cloud: was gleich bleibt und was sich von einem lokalen Start unterscheidet.
  • Optionen & Identitäten: eine Identität pro Konto, Profile, fest gepinnte Releases.
  • Exit-IPs: rotierende, feste (Sticky) und geografisch gewählte Residential-IPs.
  • Live-Ansicht & Sessions: eine Session beobachten, die Steuerung übernehmen, neu verbinden.
  • Agent-Runs: eine Aufgabe in normalen Worten schicken und JSON zurückbekommen.

Aktualisiert am 22. Nov. 2026 · SDK 0.70.4 · Browser r63

War diese Seite hilfreich?