browserbase/skills · 上手攻略

• 仓库：browserbase/skills
• 链接：https://github.com/browserbase/skills
• 分类：ai-agent-tools
• 作者：Tom
• 更新：2026-08-09

这是什么

browserbase/skills 是 Browserbase 官方出品的 AI Agent 浏览器自动化技能集，专为 Claude Code 等 AI 编码 Agent 提供网页访问与浏览器自动化能力。该仓库包含 16 个独立 Skill，覆盖从基础的网页浏览到高级的 API 生成、UI 测试、竞争情报分析等完整工作流。本质上是 Browserbase 云端浏览能力（Browserbase Cloud） + 本地 browse CLI + 一系列场景化 Skill 的组合包。

核心依赖是 Browserbase 的 browse CLI（npm install -g browse），所有 Skill 都围绕这个 CLI 与 Browserbase 云服务的交互来设计。

解决什么问题

• AI Agent 无法访问网页：传统 Agent 只能处理文本，无法与真实网页交互；该 Skill 赋予 Agent 完整的浏览器控制能力。
• 爬虫被反爬拦截：Browserbase 提供真实浏览器指纹、住宅代理、验证码解决，显著降低被检测概率。
• 自动化工作流碎片化：每个场景（抓取、测试、API 生成）都需要独立实现，该仓库提供打包好的完整 Skill 开箱即用。
• 认证网站访问：通过 cookie-sync Skill 将本地 Chrome 登录状态同步到云端 session，访问需要登录的网站。

快速安装

方式一：Claude Code 插件市场（推荐）

# 添加 Browserbase 插件市场
claude plugin marketplace add browserbase/skills

# 安装核心 browse 插件
claude plugin install browse@browserbase --scope local

# 安装 fetch 插件（轻量页面抓取，无需浏览器）
claude plugin install fetch@browserbase --scope local

# 安装 functions 插件（云端无服务器自动化）
claude plugin install functions@browserbase --scope local

# 重启 Claude Code 使配置生效

方式二：Vercel Skills CLI（跨 Agent 通用）

# 安装 skills CLI
npx skills add browserbase/skills --skill browser

# 或指定具体 Skill
npx skills add browserbase/skills --skill fetch
npx skills add browserbase/skills --skill functions

方式三：OpenClaw / ClawHub

clawhub install browse
openclaw browserbase setup   # 配置 Browserbase API Key
npm install -g browse

安装 browse CLI（所有方式均需）

npm install -g browse

前置要求

• Chrome 浏览器：本地已安装 Chrome（macOS/Windows）或 google-chrome-stable（Linux）
• Node.js 18+：browse CLI 依赖
• Browserbase 账号与 API Key：用于云端 Session、代理、验证码解决等功能（官网注册）

核心 Skill 详解

1. browser — 浏览器自动化核心

最核心的 Skill，通过 browse CLI 命令控制浏览器：

# 在 Claude Code 对话中直接使用自然语言
# "Go to Hacker News, get the top post comments, and summarize them"
# "QA test http://localhost:3000 and fix any bugs you encounter"
# "Order me a pizza, you're already signed in on Doordash"

# browse CLI 常用命令
browse open <url>              # 打开网页
browse click <selector>        # 点击元素
browse type <selector> <text>  # 输入文本
browse screenshot              # 截图
browse snapshot                # 获取页面快照（DOM 结构）
browse close                  # 关闭浏览器

# 本地/localhost 模式
browse open http://localhost:3000 --local

# 复用本地 Chrome 登录状态
browse open <url> --auto-connect

# 使用 Browserbase 云端 Session（含代理、验证码解决）
# 需要 BROWSERBASE_API_KEY 环境变量

关键特性： - 支持 Browserbase Identity（真实浏览器指纹） - Verified Browsers（已通过验证的浏览器环境） - 住宅代理（Residential Proxies） - CAPTCHA 自动解决

2. functions — 云端无服务器浏览器 Agent

将浏览器自动化部署为 Browserbase Cloud Functions，支持定时任务和 Webhook 触发：

# 初始化一个新的 Function
browse functions init

# 部署 Function
browse functions deploy

# 查看已部署的 Functions
browse functions list

3. fetch — 轻量页面抓取（无需浏览器）

# 抓取静态页面 HTML
browse fetch <url>

# 获取 JSON 数据
browse fetch <url> --json

# 检查响应头和状态码
browse fetch <url> --inspect

适用于不需要执行 JavaScript 的静态页面，速度比完整浏览器快得多。

4. search — 结构化网页搜索

# 搜索网页并返回结构化结果（标题、URL、元数据）
browse search "AI agents 2025 news"

5. browser-trace — 全链路 DevTools 追踪

捕获完整 CDP（Chrome DevTools Protocol）流量： - 截图 - DOM dump - 网络请求完整记录

然后将流分割为每页可搜索的桶，方便调试和复现。

6. browser-to-api — 从流量生成 OpenAPI 规范

自动分析 browser-trace 捕获的 HTTP 流量，生成网站的最佳匹配 OpenAPI 3.1 规范。适用于为没有官方 API 的网站构建程序化访问接口。

7. autobrowse — 自进化浏览器自动化

迭代式自动化工作流： 1. 运行浏览任务 2. 读取 trace 结果 3. 改进导航策略 4. 重复直到任务可靠完成

适用于动态页面、复杂 SPA（单页应用）的可靠自动化。

8. safe-browser — 安全浏览器 Agent

构建本地 Claude Agent SDK 浏览器 Agent，但仅暴露 safe_browser 工具——通过 CDP 门控 + 域名白名单强制执行访问边界，防止 Agent 不慎访问恶意网站或执行非预期操作。

# 示例：构建只允许访问 Hacker News 主站的爬虫
# safe-browser 会拒绝访问白名单以外的任何域名

9. cookie-sync — Cookie 同步

将本地 Chrome 的登录状态同步到 Browserbase 持久上下文：

# 刷新 Cookie
rm -rf .chrome-profile
browse cookie-sync

这样 Agent 就能以你的身份访问需要登录的网站。

10. ui-test — AI 对抗性 UI 测试

• 分析 git diff 来测试变更
• 或探索完整 App 发现 bug

用自然语言描述测试目标，AI 自动执行并报告结果。

11. browser-use-to-stagehand — 迁移工具

将 browser-use（Python）的自动化脚本迁移到 Stagehand v3（TypeScript）+ Browserbase。映射功能特性，选择每步的正确确定性级别。

12. company-research — 公司情报研究

使用 Browserbase Search API 发现匹配 ICP（Ideal Customer Profile）的目标公司，并深入研究生成研究报告 + CSV。

13. event-prospecting — 会议演讲者挖掘

从会议页面提取演讲者，筛选其公司是否符合你的 ICP，并深入研究生成以人为单位的前景报告。

14. competitor-analysis — 竞争分析

• 通过 Browserbase Search API 自动发现竞争对手
• 深入研究每个竞争者（营销、信号、基准、战略差异）
• 生成可浏览的 HTML 报告，含概览、竞争者深度分析、功能/定价矩阵

15. webmcp-gen — WebMCP 脚本生成

使用 Stagehand WebMCP 运行时，编写、编译和验证特定网站的 WebMCP 初始化脚本。

16. agent-experience — Agent 体验审计

审计产品/SDK/文档站点的 Agent 友好程度：放置 Claude 子 Agent 并以微小提示测试，捕获 trace 并评分（设置摩擦、速度、错误恢复、文档质量）。

典型使用场景

1. AI Agent 网页研究：给 Agent 装上 browser skill，让它自己搜索、整理、总结网页信息。
2. 自动化数据采集：需要登录才能访问的页面（电商、社交媒体）通过 cookie-sync 同步认证状态。
3. QA 测试：Claude Agent 对 localhost 网页进行端到端测试并自动修复 bug。
4. 竞争情报：自动发现竞品并生成对比报告。
5. API 逆向：对没有官方 API 的网站通过 browser-trace + browser-to-api 生成 OpenAPI 规范。
6. 安全爬虫：用 safe-browser 构建有域名白名单限制的安全爬虫，避免误入恶意站点。

坑与注意

与同类对比

一句话推荐结论

让 AI Agent 长出「浏览网页」的能力，Browserbase 官方 Skill 集以 browse CLI 为核心，通过 16 个场景化 Skill 覆盖从简单页面抓取到复杂竞争情报分析的全部需求——需要 Agent 访问网页时，这是最完整的开箱即用方案。

最小可跑命令

# 环境：Node.js 18+，Chrome 已安装，Browserbase API Key（有账号即可免费申请）
# 硬件：无特殊要求，基于云端 Browserbase 执行实际浏览器任务

# 1. 安装 browse CLI
npm install -g browse

# 2. 配置 Browserbase API Key（可选，仅云端功能需要）
export BROWSERBASE_API_KEY="bb-usr-..."   # 替换为你的 Key

# 3. Claude Code 中安装 Skill
claude plugin marketplace add browserbase/skills
claude plugin install browse@browserbase --scope local

# 4. 基础使用（本地浏览器，无需 API Key）
browse open https://news.ycombinator.com --local
browse snapshot
browse screenshot

# 5. 进阶使用（云端 Session，需要 API Key）
browse open https://github.com --browserbase   # 使用 Browserbase 云端浏览器

# 6. fetch（轻量抓取，无需浏览器）
browse fetch https://api.github.com --inspect

⚠️ 版本说明：以上基于 Browserbase Skills 仓库（2025 年维护），具体 Skill 版本通过 npx skills add browserbase/skills 安装时确定；部分高级 Skill（functions、company-research）需要 Browserbase 付费计划。

原始仓库：https://github.com/browserbase/skills 官方文档：https://docs.browserbase.com/integrations/skills/introduction 相关项目：Stagehand（https://github.com/browserbase/stagehand）