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()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
| Browserbase | Create-Body bei Clearcote |
|---|---|
proxies: true, eine Proxy-Geolocation | Der verwaltete Residential-Pool ist der Standard; country, state, city wählen den Exit |
ein eigener Proxy in proxies | proxy: { server, username, password } |
eine Context-ID mit persist: true | profile: { name: "acct-1", persist: true } |
| Fingerprint-Einstellungen | fingerprint (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, timeout | keepAlive, timeoutSec, idleTimeoutSec |
| Session-Aufzeichnung | record: true, danach die Aufzeichnung und ihre Wiedergabe |
| die Live-Debugger-URL | die 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:
// Stagehand v4
import { localBrowser, Stagehand } from "@browserbasehq/stagehand";
const stagehand = await Stagehand.create({ browser: await localBrowser.connect({ cdpUrl: session.connectUrl }) });# 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.