Saltar al contenido

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()
Esta pestaña se ejecuta en tu máquina.

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

BrowserbaseCuerpo de creación de Clearcote
proxies: true, una geolocalización del proxyEl pool residencial gestionado es el predeterminado; country, state, city eligen la salida
tu propio proxy en proxiesproxy: { server, username, password }
un ID de contexto con persist: trueprofile: { name: "acct-1", persist: true }
ajustes de huella digitalfingerprint (un seed), timezone, locale, o identity para el mismo dispositivo e IP por cuenta. Los navegadores alojados se presentan como un dispositivo Windows
keepAlive, timeoutkeepAlive, timeoutSec, idleTimeoutSec
grabación de la sesiónrecord: true, y luego la grabación y su reproducción
la URL del depurador en vivola 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:

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 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.

Actualizado el 16 oct 2026 · SDK 0.70.5 · navegador r63

¿Te resultó útil esta página?