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()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
| Browserbase | Corpo da criação no Clearcote |
|---|---|
proxies: true, uma geolocalização de proxy | O pool residencial gerenciado é o padrão; country, state, city escolhem a saída |
seu próprio proxy em proxies | proxy: { server, username, password } |
um ID de contexto com persist: true | profile: { name: "acct-1", persist: true } |
| configurações de fingerprint | fingerprint (uma seed), timezone, locale ou identity para o mesmo dispositivo e IP por conta. Navegadores hospedados se apresentam como um dispositivo Windows |
keepAlive, timeout | keepAlive, timeoutSec, idleTimeoutSec |
| gravação da sessão | record: truee, depois, a gravação e o replay dela |
| a URL do debugger ao vivo | a 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:
// 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 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.