functions

该 Skill 为 Browserbase Functions 的官方使用指南，旨在帮助开发者通过 bb CLI 快速部署无服务器浏览器自动化任务。作为纯文档型技能，它提供了从项目初始化到生产部署的完整工作流指导。

核心用法涵盖四个关键阶段：首先通过 pnpm dlx @browserbasehq/sdk-functions init 初始化 TypeScript 项目并配置 API 密钥；接着使用 defineFn 定义函数，利用 Playwright 连接 Browserbase 提供的 CDP 端点实现浏览器控制；然后通过 pnpm bb dev 启动本地开发服务器进行调试；最后使用 pnpm bb publish 部署至云端，并通过 HTTP API 或 SDK 调用函数。整个过程支持参数化输入和 JSON 序列化输出，适用于定时任务、Webhook 端点等场景。

显著优点在于其无服务器架构带来的运维简便性——开发者无需管理浏览器基础设施，15 分钟内完成部署即可获得弹性扩缩容能力。官方 SDK 提供了类型安全的 TypeScript 支持，内置的热重载开发服务器极大提升了调试效率。此外，Playwright 的标准化接口降低了学习成本，而 Browserbase 托管的浏览器环境解决了本地运行时的环境依赖和性能瓶颈问题。

潜在局限包括执行时长限制（单次最多 15 分钟），不适合长时间运行的复杂任务。作为 T3 级个人开发者维护的技能，其长期更新和支持稳定性存在不确定性。此外，该方案深度绑定 Browserbase 云平台，存在供应商锁定风险，迁移至其他无服务器平台需重构代码。

适合的目标群体主要为需要云端浏览器自动化的开发者，特别是构建数据抓取、自动化测试、表单填写等场景的 DevOps 工程师和后端开发者。对于需要定时执行网页监控、生成 PDF 报告或提供自动化 Webhook 服务的中小团队尤为适用。

使用风险方面，需特别注意 API 密钥的安全管理，避免将 BROWSERBASE_API_KEY 硬编码在代码中。由于涉及外部 API 调用，网络延迟可能影响函数响应时间。此外，浏览器自动化本身存在被目标网站识别和封禁的风险，建议配合代理和反检测策略使用。性能方面，频繁的浏览器启动和关闭可能产生较高云资源费用，需合理设置执行策略。

核心用法

Browserbase Functions Skill 是一份纯文档型技术指南，用于指导开发者通过官方 bb CLI 工具部署无服务器浏览器自动化。其核心工作流包括：

1. 环境准备：从 Browserbase 控制台获取 API Key 与 Project ID，配置环境变量
2. 项目初始化：使用 pnpm dlx @browserbasehq/sdk-functions init 创建项目模板
3. 函数开发：基于 defineFn 定义 Playwright CDP 连接逻辑，支持参数化爬取、认证流程、错误处理等模式
4. 本地调试：pnpm bb dev 启动热重载开发服务器，通过 curl 或代码调用测试
5. 云端部署：pnpm bb publish 一键部署，获取 Function ID 后通过 REST API 异步调用

技术架构亮点：采用 Serverless + CDP (Chrome DevTools Protocol) 架构，浏览器实例由 Browserbase 托管，用户代码仅处理自动化逻辑，最大执行时长 15 分钟。

显著优点

• 零基础设施负担：无需管理浏览器集群或虚拟机，按需自动扩缩容
• 官方生态深度整合：直接对接 Browserbase Session 管理能力，支持指纹模拟、代理轮换等高级功能
• 开发体验友好：热重载开发服务器、TypeScript 类型完备、调试输出直接可见
• 灵活的触发方式：支持 HTTP 调用、定时调度、Webhook 集成，适合数据管道搭建

潜在局限

• 执行时长上限：15 分钟单次限制，不适合超长流程（如大规模全站爬取）
• 平台锁定风险：深度绑定 Browserbase 基础设施，迁移成本较高
• 冷启动延迟：Serverless 架构固有的初始化开销，高频低延迟场景需评估
• 调试透明度：云端执行时无法直接查看浏览器界面，依赖日志与截图回传

适合人群

• 需要稳定云端浏览器环境的自动化开发者
• 构建数据爬虫管道、价格监控、自动化测试的团队
• 希望避免自建 Selenium/Playwright 集群运维成本的中型项目
• 已有 Browserbase 账户、熟悉 TypeScript/Playwright 的技术用户

常规风险

该 Skill 为纯文档型，无实际可执行代码，本身无注入或权限提升风险。用户实际使用时需注意：

• API 密钥管理：避免将 BROWSERBASE_API_KEY 硬编码或提交至版本控制
• 输入参数校验：部署后的函数暴露于公网，需对 params 中的 URL、选择器等做合法性过滤，防止 SSRF 或恶意脚本注入
• 成本监控：云端浏览器按会话时长计费，无限循环或高频调用可能导致意外费用
• 依赖供应链：建议锁定 @browserbasehq/sdk-functions 版本，防范上游包篡改