Migrar desde Browserbase
Browserbase y los navegadores alojados de Clearcote funcionan igual: creas una sesión, obtienes una dirección CDP y conectas Playwright, Puppeteer o Stagehand. Migrar es cambiar la llamada de creación. Lo que pasa después de conectar se queda igual.
El cambio
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()Obtén la clave en la página “API keys”. Hay una cosa que funciona distinto: la connectUrl es de un solo uso y expira 45 segundos después de la llamada de creación, así que conéctate enseguida y crea una sesión nueva para cada conexión nueva. El navegador arranca cuando te conectas; por eso los ejemplos le dan a Playwright un timeout de dos minutos.
Ajustes de la sesión
| Browserbase | Cuerpo de creación de Clearcote |
|---|---|
proxies: true, una geolocalización del proxy | El pool residencial gestionado es el predeterminado; country, state, city eligen la salida |
tu propio proxy en proxies | proxy: { server, username, password } |
un ID de contexto con persist: true | profile: { name: "acct-1", persist: true } |
| ajustes de huella digital | fingerprint (un seed), timezone, locale, o identity para el mismo dispositivo e IP por cuenta. Los navegadores alojados se presentan como un dispositivo Windows |
keepAlive, timeout | keepAlive, timeoutSec, idleTimeoutSec |
| grabación de la sesión | record: true, y luego la grabación y su reproducción |
| la URL del depurador en vivo | la vista en vivo del dashboard, de la que puedes tomar el control y que puedes compartir |
Todas las opciones: Opciones e identidades. Vista en vivo y compartir: Vista en vivo y sesiones. Grabaciones: Grabaciones y eventos.
Stagehand y otros frameworks de agentes
Apunta el framework a la connectUrl en lugar de a una sesión de Browserbase:
// 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 y otros: Frameworks y Playground. Para prescindir del framework, envía la tarea en lenguaje natural como una ejecución de agente y recibe JSON.
El mismo código en tus propias máquinas
Omite cloud y define CLEARCOTE_CLOUD=1 en producción: el mismo launch() inicia un navegador local en tu laptop y uno alojado en producción. Consulta Local o nube. Los navegadores alojados se pagan por GB de tráfico desde un saldo prepago: Precios y tráfico.