Browserbase

本技能提供完整的 Browserbase Functions 开发、测试与部署流程，基于 Stagehand CLI 实现浏览器自动化。核心工作流包括：使用本地会话交互式探索目标网站、初始化函数项目、关键修复 package.json 模板缺陷、编写 TypeScript 自动化代码、本地开发服务器测试，最终部署至 Browserbase 云端并获取可调用函数 ID。

显著优点：云端托管消除本地浏览器依赖，支持定时任务与 Webhook 触发，15 分钟执行时长适合复杂多页流程；基于 Playwright 的 CDP 连接提供完整浏览器控制能力；TypeScript 模板与热重载开发体验良好。

关键局限与风险：stagehand fn init 生成的 package.json 存在严重缺陷（缺 description/main/packageManager、版本号为 "latest"、无 devDependencies），直接导致部署失败，必须按文档手动修复；CLI 工具处于早期版本，API 可能变动；依赖 Browserbase 云服务可用性，存在供应商锁定；网络波动或目标网站反爬机制可能导致任务失败。

适合人群：需自动化数据采集、定期监控网页内容、或构建无服务器浏览器工作流的开发者，要求具备 TypeScript/Node.js 基础与 Playwright 使用经验。

常规风险：目标网站的 ToS 合规性、反爬机制触发封禁、敏感数据在云端会话中的传输与存储安全、API 密钥泄露风险。

核心用法

本技能提供完整的 Browserbase Functions 开发工作流，基于 stagehand CLI 实现从本地探索到云端部署的端到端自动化：

1. 交互式探索

• stagehand session create --local 启动本地浏览器会话
• stagehand goto/snapshot/screenshot 获取 DOM 结构与视觉反馈
• 手动测试点击、填充、求值等操作，验证选择器有效性

2. 项目初始化与关键修复

• stagehand fn init <name> 创建项目骨架（package.json、index.ts、tsconfig.json）
• ⚠️ 必须立即修复 package.json：添加 description/main/packageManager 字段，将 "latest" 改为固定版本（如 "^0.0.5"），补充 devDependencies 含 TypeScript 与类型定义。此 bug 是部署失败的首要原因。

3. 函数开发

• 基于 defineFn() 定义异步函数，通过 context.session.connectUrl 连接 Browserbase 托管浏览器
• 使用 Playwright (chromium.connectOverCDP) 操作页面，支持参数化输入 (context.params)
• 返回 JSON 可序列化数据，15 分钟执行上限

4. 本地测试与部署

• pnpm bb dev index.ts 启动热重载开发服务器（默认 127.0.0.1:14113）
• curl 或 stagehand fn invoke 验证
• pnpm bb publish index.ts 构建并部署至 Browserbase 云函数平台

5. 生产调用

• 获取 Function ID 后，通过 CLI 或 REST API (api.browserbase.com/v1/functions/) 触发，支持 Webhook 与定时调度。

显著优点

• 云原生托管：无需维护浏览器基础设施，自动处理 Session、代理、CAPTCHA
• Playwright 生态：完整支持 CDP、页面交互、复杂 JS 求值
• 开发体验：本地热重载 + 云端一致性，调试闭环高效
• 弹性执行：15 分钟超时适合长流程，支持多页工作流与认证场景

局限性与风险

• 初始化 bug：stagehand fn init 生成的 package.json 不完整，新手极易踩坑导致 "No functions were built" 错误
• 依赖锁定：必须使用 pnpm@10.14.0，版本漂移可能破坏构建
• 网络成本：Browserbase 为商业服务，高频调用产生费用；API Key 泄露可能导致账户盗刷
• 执行隔离：函数无状态，复杂场景需外接存储；CDP 连接异常需手动重试

适合人群

• 开发者/工程师：具备 TypeScript/Node.js 基础，需要生产级爬虫、自动化测试、数据监控
• 数据团队：需定时抓取动态渲染页面（SPA、反爬站点）
• 不适合：无代码用户、仅需简单静态页面抓取（成本不划算）

常规风险

• 凭证管理：BROWSERBASE_API_KEY 需妥善保管，避免提交至版本控制
• 合规风险：自动化操作需遵守目标网站 ToS，高频爬取可能触发封禁
• 调试成本：远程浏览器调试较本地复杂，建议充分本地验证后再部署