Zum Inhalt springen

Von Browserbase migrieren

Browserbase und die gehosteten Browser von Clearcote sind gleich aufgebaut: Session erstellen, CDP-Adresse erhalten, Playwright, Puppeteer oder Stagehand verbinden. Der Umstieg ist eine Änderung am Create-Aufruf. Alles nach dem Verbinden bleibt, wie es ist.

Die Änderung

import os
from browserbase import Browserbase
from playwright.sync_api import sync_playwright
from clearcote import launch

session = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"]).sessions.create()
browser = sync_playwright().start().chromium.connect_over_cdp(session.connect_url)
page = browser.contexts[0].pages[0]
browser = launch(cloud=True, identity="acct-1", country="us")   # creates the session and connects
page = browser.contexts[0].new_page()
page.goto("https://example.com")
browser.close()
Dieser Tab läuft auf Ihrem Rechner.

Den Schlüssel erhalten Sie auf der Seite API keys. Eines funktioniert anders: Die connectUrl gilt nur einmal und läuft 45 Sekunden nach dem Create-Aufruf ab. Verbinden Sie sich also sofort und erstellen Sie für jede neue Verbindung eine neue Session. Der Browser startet beim Verbinden, deshalb geben die Beispiele Playwright ein Timeout von zwei Minuten.

Session-Einstellungen

BrowserbaseCreate-Body bei Clearcote
proxies: true, eine Proxy-GeolocationDer verwaltete Residential-Pool ist der Standard; country, state, city wählen den Exit
ein eigener Proxy in proxiesproxy: { server, username, password }
eine Context-ID mit persist: trueprofile: { name: "acct-1", persist: true }
Fingerprint-Einstellungenfingerprint (ein Seed), timezone, locale oder identity für dasselbe Gerät und dieselbe IP pro Konto. Gehostete Browser treten als Windows-Gerät auf
keepAlive, timeoutkeepAlive, timeoutSec, idleTimeoutSec
Session-Aufzeichnungrecord: true, danach die Aufzeichnung und ihre Wiedergabe
die Live-Debugger-URLdie Live-Ansicht im Dashboard, die Sie übernehmen und teilen können

Alle Optionen: Optionen & Identitäten. Live-Ansicht und Teilen: Live-Ansicht & Sessions. Aufzeichnungen: Aufzeichnungen & Ereignisse.

Stagehand und andere Agent-Frameworks

Richten Sie das Framework auf die connectUrl statt auf eine Browserbase-Session:

javascript
// Stagehand v4
import { localBrowser, Stagehand } from "@browserbasehq/stagehand";
const stagehand = await Stagehand.create({ browser: await localBrowser.connect({ cdpUrl: session.connectUrl }) });
python
# Browser Use
from browser_use import Agent, Browser
agent = Agent(task="Find the cheapest flight to Lisbon next Friday", llm=llm, browser=Browser(cdp_url=session["connectUrl"]))
await agent.run()

Crawl4AI und weitere: Frameworks & Playground. Ganz ohne Framework schicken Sie die Aufgabe in normaler Sprache als Agent-Run und erhalten JSON zurück.

Derselbe Code auf Ihren eigenen Rechnern

Lassen Sie cloud weg und setzen Sie in Produktion CLEARCOTE_CLOUD=1: Dasselbe launch() startet auf Ihrem Laptop einen lokalen Browser und in Produktion einen gehosteten. Siehe Lokal oder Cloud. Gehostete Browser werden pro GB Traffic aus einem Prepaid-Guthaben bezahlt: Preise & Traffic.

Aktualisiert am 16. Okt. 2026 · SDK 0.70.5 · Browser r63

War diese Seite hilfreich?