Pular para o conteúdo

Migrando do Browserbase

O Browserbase e os navegadores hospedados do Clearcote funcionam do mesmo jeito: criar uma sessão, obter um endereço CDP, conectar o Playwright, o Puppeteer ou o Stagehand. Migrar é mudar a chamada de criação. O que acontece depois da conexão continua igual.

A mudança

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 aba roda na sua máquina.

Pegue a chave na página API keys. Uma coisa funciona diferente: a connectUrl é de uso único e expira 45 segundos após a chamada de criação, então conecte imediatamente e crie uma nova sessão para cada nova conexão. O navegador inicia quando você se conecta, e é por isso que os exemplos dão ao Playwright um timeout de dois minutos.

Configurações da sessão

BrowserbaseCorpo da criação no Clearcote
proxies: true, uma geolocalização de proxyO pool residencial gerenciado é o padrão; country, state, city escolhem a saída
seu próprio proxy em proxiesproxy: { server, username, password }
um ID de contexto com persist: trueprofile: { name: "acct-1", persist: true }
configurações de fingerprintfingerprint (uma seed), timezone, locale ou identity para o mesmo dispositivo e IP por conta. Navegadores hospedados se apresentam como um dispositivo Windows
keepAlive, timeoutkeepAlive, timeoutSec, idleTimeoutSec
gravação da sessãorecord: truee, depois, a gravação e o replay dela
a URL do debugger ao vivoa visualização ao vivo no dashboard, que você pode assumir e compartilhar

Todas as opções: Opções e identidades. Visualização ao vivo e compartilhamento: Ao vivo e sessões. Gravações: Gravações e eventos.

Stagehand e outros frameworks de agentes

Aponte o framework para a connectUrl em vez de uma sessão do 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 e outros: Frameworks e Playground. Para dispensar o framework, envie a tarefa em linguagem natural como uma execução de agente e receba JSON de volta.

O mesmo código nas suas próprias máquinas

Deixe cloud de fora e defina CLEARCOTE_CLOUD=1 em produção: o mesmo launch() inicia um navegador local no seu laptop e um hospedado em produção. Veja Local ou nuvem. Navegadores hospedados são pagos por GB de tráfego a partir de um saldo pré-pago: Preços e tráfego.

Atualizado em 16 de out. de 2026 · SDK 0.70.5 · navegador r63

Esta página foi útil?