用途:指导用户用 stagehand CLI 创建、测试并部署浏览器自动化函数(Browserbase Functions),适用于自动化网站任务、抓取站点数据、按计划或 Webhook 运行自动化。
主要能力:通过本地浏览器会话交互探索站点结构,用 snapshot/screenshot/click/fill/eval 手动验证操作;初始化函数项目并用 Playwright 连接会话编写抓取、登录、多页面等逻辑;本地开发服务器与 curl 调用测试;发布到 Browserbase 并远程调用。函数最长执行 15 分钟,返回值需可 JSON 序列化,通过 context.session 和 context.params 获取会话与参数。
必要用法:先检查凭据 stagehand fn auth status,必要时 stagehand fn auth login(凭据来自 https://browserbase.com/settings)。探索用 stagehand session create --local、stagehand goto、stagehand snapshot、stagehand screenshot。初始化用 stagehand fn init my-automation。注意生成后的 package.json 不完整,会导致部署报 “No functions were built”,需补全 description、main、packageManager 并将 latest 改为固定版本,再 pnpm install。本地测试用 pnpm bb dev index.ts,服务在 http://127.0.0.1:14113。部署用 pnpm bb publish index.ts 或 stagehand fn publish index.ts,再 stagehand fn invoke <function-id> 或调用 API 测试。
限制:资料未说明收费与价格;函数执行上限 15 分钟;部署失败多因 package.json 缺字段或版本问题,本地正常不代表部署正常;页面抓取不到数据可用截图或 snapshot 排查选择器;调试可用 console.log。资料未提供更多平台或效果承诺。