mcpField
B
browserbase-cli

browserbase-cli

github.com/browserbase云与 DevOps3.7k2.5k 次安装8 周前更新
代码仓库

关于 browserbase-cli

browserbase-cli 是一项 Agent 技能，介绍如何用官方 `browse` 命令行管理 Browserbase 资源、运行 Functions，以及调用 Fetch 和 Search API。内容还涵盖模板与浏览器驱动命令，并提供命令选择和故障排查指引。

主要功能

  1. 01管理 Browserbase 会话、项目、上下文和扩展
  2. 02开发、发布和调用 Functions
  3. 03抓取网页并搜索网络
  4. 04浏览和搭建入门模板
  5. 05通过命令行驱动本地或远程浏览器

适用场景

  1. 01检查或管理 Browserbase 平台资源
  2. 02构建并运行 Browserbase Function
  3. 03无需启动浏览器会话即可抓取网页或搜索
  4. 04从命令行模板启动项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/browserbase/skills --skill browserbase-cli

安装后在 Claude Code 中输入/browserbase-cli确认已加载。

附带文件LICENSE.txtREFERENCE.md

详细介绍

Browserbase CLI

使用官方 browse CLI 执行 Browserbase 平台操作、Functions 工作流和 Fetch API 调用。

设置检查

使用 CLI 前，请确认已安装：

which browse || npm install -g browse
browse --help

对于需要身份验证的命令，请设置 API 密钥：

export BROWSERBASE_API_KEY="your_api_key"

何时使用此技能

当用户希望执行以下操作时，请使用此技能：

  • 通过 browse 运行 Browserbase 命令
  • 搭建、开发、发布或调用 Browserbase Functions
  • 检查或管理 Browserbase 会话、项目、上下文或扩展
  • 通过 Browserbase 获取页面内容，而无需打开浏览器会话
  • 通过 Browserbase 搜索网页，而无需打开浏览器会话
  • 使用 browse templates 浏览或搭建入门模板

何时不使用此技能

  • 对于交互式浏览、页面检查、截图、点击、输入或登录流程，请优先使用 browser 技能。
  • 对于用户不在意是否专门使用 CLI 的简单 HTTP 内容获取，专用的 fetch 技能通常更合适。
  • 仅当用户明确希望使用 CLI，或已在以 browse 为中心的工作流中操作时，才使用顶层驱动命令（browse open、browse get、browse click 等）。

命令选择

  • 使用 browse functions 进行本地开发、打包、发布和调用
  • 使用 browse cloud sessions、browse cloud projects、browse cloud contexts、browse cloud extensions 管理 Browserbase 平台资源
  • 使用 browse cloud fetch <url> 发起 Fetch API 请求
  • 使用 browse cloud search "<query>" 发起 Search API 请求
  • 使用 browse templates 浏览和搭建入门模板
  • 使用 browse open、browse get、browse click 等命令直接驱动本地或远程浏览器
  • 使用 browse skills install 为 Claude Code 安装 Browserbase Agent 技能

对于本地浏览器操作，browse open <url> --local 会启动一个干净且隔离的浏览器。只有在需要连接到现有的可调试 Chrome 会话时，才使用 browse open <url> --auto-connect。

常见工作流

Functions
browse functions init my-function
cd my-function
browse functions dev index.ts
browse functions publish index.ts
browse functions invoke <function_id> --params '{"url":"https://example.com"}'

使用 browse functions invoke --check-status <invocation_id> 轮询现有调用，而不是新建调用。

平台 API
browse cloud projects list
browse cloud sessions create --proxies --verified --region us-east-1
browse cloud sessions create --solve-captchas --context-id ctx_abc --persist
browse cloud sessions get <session_id>
browse cloud sessions downloads get <session_id> --output session-artifacts.zip
browse cloud contexts create --body '{"region":"us-west-2"}'
browse cloud extensions upload ./my-extension.zip
Fetch API
browse cloud fetch https://example.com
browse cloud fetch https://example.com --allow-redirects --output page.html
Search API
browse cloud search "browser automation"
browse cloud search "web scraping" --num-results 5
browse cloud search "AI agents" --output results.json
模板
browse templates list
browse templates list --tag Python --source Browserbase
browse templates clone form-filling --language typescript
browse templates clone amazon-product-scraping --language python ./my-scraper

最佳实践

  1. 在猜测标志之前，优先查看 browse --help 和子命令组的 --help。
  2. 严格按照 CLI 帮助中所示使用短横线分隔的标志。
  3. 使用 browse cloud fetch 和 browse cloud search 时，通过 --output <file> 将结果保存到文件。
  4. 除非用户明确希望进行一次性覆盖，否则请使用环境变量进行身份验证。
  5. 使用 --body 或 --params 传入 JSON 字符串形式的结构化请求体。
  6. 请记住，browse functions ... 和 browse cloud ... 都使用 --base-url 覆盖 API 基础 URL。

故障排查

  • 缺少 API 密钥：设置 BROWSERBASE_API_KEY 或传入 --api-key
  • 未知标志：使用 --help 重新运行相关命令，并采用准确的短横线形式
  • 找不到命令：重新运行 npm install -g browse，并使用 which browse 确认

有关逐条命令的参考和更多示例，请参阅 REFERENCE.md。

评论

支持 Markdown