SuperAPI AI 工具集

browserbase-sdk

智能体与模型

查看项目

更新于 10-16 02:30

技能介绍

用途:Browserbase 在隔离虚拟机中运行生产级无头 Chromium,每个会话暴露一个 CDP WebSocket。@browserbasehq/sdk 是管理会话、上下文、扩展和项目的轻量 REST 客户端,本身不驱动浏览器;浏览器控制通过 connectUrl(Playwright/Puppeteer/CDP)或 seleniumRemoteUrl(Selenium)完成,Stagehand 则在内部封装 SDK 与 Playwright。

主要能力:会话创建/查询/更新/调试、生命周期与区域、keep-alive、userMetadata 过滤;上下文持久化登录态;代理(托管/外部/无);隐身与验证浏览器、验证码处理、广告拦截;下载上传;实时视图、录制、日志;自定义扩展。

使用方式:设置环境变量 BROWSERBASE_API_KEY 与 BROWSERBASE_PROJECT_ID(Stagehand 必需,原始 SDK 可从 key 推断)。REST 端点:POST https://api.browserbase.com/v1/sessions,请求头 x-bb-api-key: $BROWSERBASE_API_KEY。Playwright 用 chromium.connectOverCDP(session.connectUrl),Puppeteer 用 puppeteer.connect({ browserWSEndpoint: session.connectUrl })。

限制与注意:必须使用预创建的 browser.contexts()[0],而非 browser.newContext(),否则 browserSettings.context、代理与指纹不生效;connectUrl 每次 CDP 连接一次性使用,断开后重连需 keepAlive: true;下载路径须为字面量 "downloads";solveCaptchas、recordSession、logSession 默认 true;userMetadata 上限 512 字符且仅字符串值;免费层并发 3 个会话;verified 与 advancedStealth 仅 Scale 计划;Selenium 使用 seleniumRemoteUrl。会话在脚本退出后仍持续,需通过 sessions.update 发送 REQUEST_RELEASE 或等待超时。