Aller au contenu

Migrer depuis Browserbase

Browserbase et les navigateurs hébergés de Clearcote fonctionnent de la même façon : créer une session, obtenir une adresse CDP, connecter Playwright, Puppeteer ou Stagehand. Migrer revient à modifier l’appel de création. Tout ce qui suit la connexion reste identique.

Le changement

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()
Cet onglet s’exécute sur votre machine.

Récupérez la clé sur la page « API keys ». Une chose fonctionne différemment : la connectUrl est à usage unique et expire 45 secondes après l’appel de création. Connectez-vous donc tout de suite et créez une nouvelle session pour chaque nouvelle connexion. Le navigateur démarre au moment de la connexion, c’est pourquoi les exemples donnent à Playwright un timeout de deux minutes.

Réglages de session

BrowserbaseCorps de création Clearcote
proxies: true, une géolocalisation de proxyLe pool résidentiel géré est la valeur par défaut ; country, state, city choisissent la sortie
votre propre proxy dans proxiesproxy: { server, username, password }
un ID de contexte avec persist: trueprofile: { name: "acct-1", persist: true }
réglages d’empreintefingerprint (un seed), timezone, locale, ou identity pour le même appareil et la même IP par compte. Les navigateurs hébergés se présentent comme un appareil Windows
keepAlive, timeoutkeepAlive, timeoutSec, idleTimeoutSec
enregistrement de sessionrecord: true, puis l’enregistrement et sa relecture
l’URL du débogueur en directla vue en direct du tableau de bord, dont vous pouvez prendre le contrôle et que vous pouvez partager

Toutes les options : Options et identités. Vue en direct et partage : Vue en direct et sessions. Enregistrements : Enregistrements et événements.

Stagehand et les autres frameworks d’agents

Pointez le framework vers la connectUrl au lieu d’une session Browserbase :

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 et les autres : Frameworks et Playground. Pour vous passer du framework, envoyez la tâche en langage naturel sous forme d’exécution d’agent et récupérez du JSON.

Le même code sur vos propres machines

Omettez cloud et définissez CLEARCOTE_CLOUD=1 en production : le même launch() démarre un navigateur local sur votre portable et un navigateur hébergé en production. Voir Local ou cloud. Les navigateurs hébergés se paient au GB de trafic depuis un solde prépayé : Tarifs et trafic.

Mis à jour le 16 oct. 2026 · SDK 0.70.5 · navigateur r63

Cette page vous a-t-elle été utile ?