browserbase-sessions

🌐 云端持久浏览器,自动保持登录态

云端浏览器自动化工具,支持持久化会话、自动验证码解决和跨交互登录状态保持,适合自动化爬取、认证页面抓取和多站点工作流。

收藏
6k
安装
1.9k
版本
1.2.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Browserbase Sessions 是一个基于云端浏览器的自动化技能,通过 Browserbase 平台提供持久化浏览器会话管理能力。核心功能包括:

  • 持久化会话管理:通过 Workspaces 和 Contexts 实现跨聊天轮次的浏览器状态保持,支持 cookies、localStorage 等认证信息的持久化存储
  • 自动化浏览器操作:创建/管理云端浏览器实例,执行导航、截图、JavaScript 执行、文本提取等操作
  • 验证码自动处理:默认启用 CAPTCHA 自动解决,无需人工干预即可通过登录流程
  • 会话录制与回放:自动录制会话为视频(Dashboard 查看)和 rrweb 事件(API 获取)

典型使用模式

1. Workspace 工作流(推荐):创建命名工作空间 → 启动保持连接 → 获取实时调试 URL → 执行自动化任务 → 停止并持久化状态
2. 任务型多站点工作流:单 Context 同时保持多个站点登录状态,适合跨站数据处理

3. 一次性会话:创建临时会话 → 完成特定任务(截图、抓取)→ 立即终止

配置要求

  • 必须配置 BROWSERBASE_API_KEYBROWSERBASE_PROJECT_ID
  • 依赖 Python 3 + Playwright + browserbase SDK
  • 支持通过环境变量或 OpenClaw 配置文件注入凭证

显著优点

1. 认证状态持久化:Contexts 机制允许跨会话保持登录状态,避免重复 MFA/SSO 流程
2. 云端架构:无需本地浏览器环境,适合服务器/无头环境部署

3. 高可靠性:自动重连、keep-alive 机制、多区域部署支持

4. 调试友好:实时调试 URL 允许人工介入,同时保持自动化能力

5. 安全合规:API 密钥管理、会话超时控制(最大6小时)、自动终止机制

6. 灵活的工作流:支持隔离型(每站点独立 Context)和任务型(多站点共享 Context)两种组织模式

潜在缺点与局限性

1. 成本敏感:按浏览器小时计费,keep-alive 会话持续消耗配额;未设置合理 timeout 可能导致意外高额账单
2. 功能边界

3. 连接约束:创建后 5 分钟内必须连接,否则自动终止
4. API 依赖:完全依赖 Browserbase 第三方服务的可用性和定价策略

  • 无法绕过 MFA/SSO(需用户参与)
  • 不支持下载 Dashboard 视频(仅 rrweb 事件)
  • 无法恢复完整浏览器历史(仅保存打开的标签页 URL)
  • 同一 Context 不支持并发会话

适合人群

  • 自动化测试工程师:需要云端浏览器执行 E2E 测试
  • 数据爬取开发者:处理需要登录状态的认证页面抓取
  • RPA 场景:跨多站点的业务流程自动化(如发票处理、线索收集)
  • AI Agent 开发者:为 LLM 提供可交互的浏览器环境

常规风险

1. 凭证泄露风险:API Key 需妥善保管,建议通过专用环境变量或密钥管理服务注入
2. 会话劫持风险:live debug URL 具备会话操作能力,需防止 URL 泄露

3. 成本失控风险:长时间运行的 keep-alive 会话或未设置 timeout 可能导致超额计费

4. 数据残留风险:Contexts 持久化存储可能包含敏感站点凭证,需通过 delete-context 主动清理

5. 服务可用性风险:Browserbase 服务中断将完全阻断功能,需设计降级方案

6. 合规风险:自动化抓取需遵守目标站点的 robots.txt 和服务条款,验证码绕过功能可能触发某些平台的风控策略

browserbase-sessions 内容

references文件夹
scripts文件夹
手动下载zip · 24.0 kB
api-quick-ref.mdtext/markdown
请选择文件