从 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 设置了两分钟的超时。
会话设置
| Browserbase | Clearcote 创建请求体 |
|---|---|
proxies: true,代理地理位置 | 默认使用托管住宅代理池;用 country、state、city 选择出口 |
在 proxies 中配置的自有代理 | proxy: { server, username, password } |
带 persist: true 的 context ID | profile: { name: "acct-1", persist: true } |
| 指纹设置 | fingerprint(种子),timezone、locale,或用 identity 让每个账号使用相同的设备和 IP。托管浏览器呈现为 Windows 设备 |
keepAlive, timeout | keepAlive, 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 流量从预付余额中扣费:价格与流量。