browse

核心用法

本Skill提供完整的Browserbase浏览器自动化开发指南，基于stagehand CLI工具链实现从本地探索到云端部署的全流程。用户首先通过stagehand session create --local启动本地浏览器会话，使用goto、、snapshot、、click等命令交互式理解目标网站结构；随后执行stagehand fn init初始化TypeScript项目，编写基于Playwright的自动化脚本，通过pnpm bb dev本地调试后，最终以pnpm bb publish部署为Browserbase Function，支持定时任务或Webhook触发。

显著优点

1. 云端托管优势：Browserbase提供托管浏览器环境，无需本地维护Chromium实例，支持15分钟长时任务
2. 开发体验完整：从交互式探索（session create）到生产部署（fn publish）形成闭环，内置热重载开发服务器
3. TypeScript原生支持：基于Playwright-Core的强类型SDK，配合现代pnpm包管理
4. 弹性触发机制：支持API调用、定时调度、Webhook等多种触发方式
5. 详细故障排查：文档包含大量真实错误案例（如"No functions were built"的package.json修复方案）

潜在缺点与局限性

1. 初始化工具缺陷：stagehand fn init生成的package.json存在关键字段缺失，必须手动修复才能部署成功
2. T3来源可信度：Skill来源于个人开发者（pkiv），非Browserbase官方维护
3. 云服务依赖：核心功能依赖Browserbase商业服务，存在供应商锁定和持续成本
4. 执行时长限制：单函数15分钟超时，复杂多页流程需拆分设计
5. 调试成本：本地与生产环境的行为差异可能导致"本地正常、部署失败"问题

适合的目标群体

• 数据工程师：需要稳定、可扩展的网站数据抓取基础设施
• 自动化测试开发者：构建基于真实浏览器的端到端测试流程
• SaaS集成开发者：将浏览器自动化封装为可复用的API服务
• 技术型产品经理：快速验证竞品监控、价格追踪等自动化场景

使用风险

1. 依赖项风险：需持续关注@browserbasehq/sdk-functions和playwright-core的版本兼容性
2. 凭证泄露风险：BROWSERBASE_API_KEY若配置不当可能随代码提交暴露
3. 服务可用性：Browserbase云服务的中断将直接影响生产自动化流程
4. 成本失控：高频调用或长时会话可能产生意外账单，需设置预算告警

核心功能

browse skill 是由 Browserbase 官方维护的浏览器自动化部署指南，专注于帮助开发者通过 stagehand CLI 快速创建、调试和部署基于 Playwright 的云端浏览器函数（Browserbase Functions）。该 skill 完整覆盖了从本地探索、项目初始化、代码编写到生产部署的全流程，特别适合需要大规模网页数据抓取、自动化测试或定时任务执行的场景。

显著优点

1. 官方权威性：由 Browserbase 核心团队（pkiv）直接维护，API 文档与平台特性保持实时同步，包含大量未在公开文档中详细说明的实战经验。

2. 实战导向：不仅提供基础用法，还针对最常见的部署失败问题（"No functions were built"）给出了明确的修复方案，包含完整的 package.json 模板和版本锁定建议。

3. 开发体验优化：内置本地开发服务器（pnpm bb dev）支持热重载，配合 stagehand session create --local 的交互式探索模式，大幅降低了调试成本。

4. 生产级模式：涵盖参数化调用、认证流程、多页面工作流等高级场景，提供 Hacker News 完整可运行的示例代码。

潜在局限

1. 生态依赖单一：深度绑定 Browserbase 云服务与 pnpm 包管理器，迁移至其他浏览器自动化平台（如 Puppeteer + AWS Lambda）需重写大量配置。

2. 版本锁定风险：强制要求 pinned 版本号（如 "^0.0.5"），虽稳定性高但可能延迟安全补丁的自动获取。

3. 执行时长限制：15 分钟最大执行时间对深度抓取任务（如遍历大型分页站点）可能不足。

4. Node 版本敏感：依赖较新的 TypeScript 5.9+ 和 Node 25+ 类型定义，旧环境可能出现类型冲突。

适合人群

• 数据工程师：需要稳定、可扩展的云端爬虫基础设施
• 全栈开发者：希望将浏览器自动化快速集成为 HTTP API
• 运维工程师：需要定时任务或 Webhook 触发的自动化工作流
• 技术团队：已通过 Browserbase 评估，寻求标准化部署规范

常规风险

1. 凭证泄露风险：BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID 如误提交至版本控制，可能导致云资源滥用。
2. 目标网站封禁：高频自动化抓取可能触发反爬机制，导致 IP 被封或账号受限。
3. 依赖供应链：@browserbasehq/sdk-functions 和 playwright-core 的更新可能引入破坏性变更。
4. 超时资源残留：未正确处理的浏览器会话可能在云端持续计费。