跳到正文

从 Browserbase 迁移

Browserbase 和 Clearcote 的托管浏览器原理相同:创建会话,拿到 CDP 地址,连接 Playwright、Puppeteer 或 Stagehand。迁移只需修改创建调用,连接之后的代码保持不变。

改动

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()
此标签页在你的机器上运行。

在“API keys”页面获取密钥。有一点不同:connectUrl 只能使用一次,并在创建调用 45 秒后过期,所以请立即连接,并为每个新连接创建新会话。浏览器在你连接时才启动,因此示例给 Playwright 设置了两分钟的超时。

会话设置

BrowserbaseClearcote 创建请求体
proxies: true,代理地理位置默认使用托管住宅代理池;用 country、state、city 选择出口
在 proxies 中配置的自有代理proxy: { server, username, password }
带 persist: true 的 context IDprofile: { name: "acct-1", persist: true }
指纹设置fingerprint(种子),timezone、locale,或用 identity 让每个账号使用相同的设备和 IP。托管浏览器呈现为 Windows 设备
keepAlive, timeoutkeepAlive, timeoutSec, idleTimeoutSec
会话录像record: true,之后可查看录像及其回放
实时调试器 URL控制台中的实时画面,你可以接管控制并分享

全部选项:选项与身份。实时画面与分享:实时画面与会话。录像:录像与事件。

Stagehand 及其他智能体框架

把框架指向 connectUrl,而不是 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 等框架见框架与 Playground。如果不想用框架,可以用自然语言描述任务,作为智能体任务发送,直接拿回 JSON。

在你自己的机器上运行同一份代码

不传 cloud,并在生产环境中设置 CLEARCOTE_CLOUD=1:同一个 launch() 在你的笔记本上启动本地浏览器,在生产环境中启动托管浏览器。参见本地或云端。托管浏览器按 GB 流量从预付余额中扣费:价格与流量。

更新于 2026年10月16日 · SDK 0.70.5 · 浏览器 r63

这个页面有帮助吗?