⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Browserbase：AI代理与自动化云端浏览器基础设施，支持Playwright/Puppeteer

browserbase by vm0-ai/vm0-skills

56 周安装量

51 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill browserbase

自动化云服务测试

🇨🇳中文介绍

Browserbase

面向 AI 代理和自动化的云端浏览器基础设施。创建浏览器会话、通过上下文持久化认证、实时调试会话，并获取会话录制。

官方文档：https://docs.browserbase.com/

使用时机

在以下情况下使用此技能：

为 Playwright/Puppeteer 自动化创建云端浏览器会话
使用上下文在会话间持久化登录状态和 Cookie
通过实时 URL 调试浏览器会话
获取会话录制和日志用于调试
以编程方式管理浏览器会话（列出、获取、更新）
运行支持代理和隐身模式的浏览器自动化

前提条件

在 https://www.browserbase.com/ 创建账户
从仪表板的设置页面获取您的 API 密钥
从仪表板的设置页面获取您的项目 ID

设置环境变量：

export BROWSERBASE_TOKEN="your-api-key-here"
export BROWSERBASE_PROJECT_ID="your-project-id-here"

注意： 免费计划有 1 个并发会话限制。如果超过此限制，您将收到 429 错误。请在 Browserbase 仪表板中查看您的计划详情。

使用方法

1. 创建会话

创建一个新的浏览器会话：

写入 /tmp/request.json：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

3. 获取会话详情

获取特定会话的详情。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

4. 更新会话（释放）

请求在超时前释放会话以避免额外费用。将 <your-session-id> 替换为实际的会话 ID：

写入 /tmp/request.json：

{
  "status": "REQUEST_RELEASE"
}



curl -s -X POST "https://api.browserbase.com/v1/sessions/<your-session-id>" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

会话状态将变为 COMPLETED，并设置 endedAt 时间戳。

5. 获取调试/实时 URL

获取运行中会话的实时调试 URL。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/debug" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

注意： 调试 URL 可能仅在浏览器客户端通过 WebSocket 连接到会话后才可用。

debuggerUrl - Chrome DevTools 调试器 URL
debuggerFullscreenUrl - 全屏调试器视图
wsUrl - WebSocket URL
pages - 包含其调试器 URL 的已打开页面数组

6. 获取会话日志

检索会话的日志。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/logs" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

7. 获取会话录制

获取会话的 rrweb 录制。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/recording" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

8. 获取会话下载

检索会话期间下载的文件（返回 ZIP 文件）。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/downloads" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" --output downloads.zip

9. 上传文件到会话

上传文件以供浏览器会话使用。将 <your-session-id> 替换为实际的会话 ID：

curl -s -X POST "https://api.browserbase.com/v1/sessions/<your-session-id>/uploads" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -F "file=@/path/to/file.pdf"

上下文允许您在多个浏览器会话间持久化 Cookie、缓存和会话存储。

写入 /tmp/request.json：

{
  "projectId": "<your-project-id>"
}



curl -s -X POST "https://api.browserbase.com/v1/contexts" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

保存返回的 id 以便在会话中使用。

获取上下文详情

检索特定上下文的详情。将 <your-context-id> 替换为实际的上下文 ID：

curl -s -X GET "https://api.browserbase.com/v1/contexts/<your-context-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

id - 上下文标识符
createdAt - 创建时间戳
updatedAt - 最后更新时间戳
projectId - 与上下文关联的项目 ID

使用上下文创建会话

使用现有上下文来恢复 Cookie 和登录状态。将 <your-context-id> 替换为实际的上下文 ID：

写入 /tmp/request.json：

{
  "projectId": "<your-project-id>",
  "browserSettings": {
    "context": {
      "id": "<your-context-id>",
      "persist": true
    }
  }
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

设置 persist: true 可在会话结束后将更新保存回上下文。

当不再需要时删除上下文。将 <your-context-id> 替换为实际的上下文 ID：

curl -s -X DELETE "https://api.browserbase.com/v1/contexts/<your-context-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -w "\nHTTP Status: %{http_code}"

成功删除返回 HTTP 204（无内容）。

获取项目使用情况

检索项目范围的使用统计信息（浏览器分钟数和代理字节数）。将 <your-project-id> 替换为您的实际项目 ID：

curl -s -X GET "https://api.browserbase.com/v1/projects/<your-project-id>/usage" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

端点	方法	描述
`/v1/sessions`	POST	创建新的浏览器会话
`/v1/sessions`	GET	列出所有会话
`/v1/sessions/{id}`	GET	获取会话详情（返回数组）
`/v1/sessions/{id}`	POST	更新会话（释放）
`/v1/sessions/{id}/debug`	GET	获取实时调试 URL
`/v1/sessions/{id}/logs`	GET	获取会话日志
`/v1/sessions/{id}/recording`	GET	获取会话录制（rrweb）
`/v1/sessions/{id}/downloads`	GET	获取下载的文件（ZIP）
`/v1/sessions/{id}/uploads`	POST	上传文件到会话
`/v1/contexts`	POST	创建新的上下文
`/v1/contexts/{id}`	GET	获取上下文详情
`/v1/contexts/{id}`	DELETE	删除上下文
`/v1/projects/{id}/usage`	GET	获取项目使用统计

状态	描述
`RUNNING`	会话当前处于活动状态
`COMPLETED`	会话成功结束
`ERROR`	会话因错误结束
`TIMED_OUT`	会话超时
`REQUEST_RELEASE`	请求结束会话

会话生命周期：会话在超时后自动终止（默认 5 分钟）。对于更长的会话，请使用 keepAlive: true。
上下文：使用上下文来持久化登录状态，避免重复认证。
代理：启用代理以访问地理限制内容或避免速率限制。
区域：选择靠近您目标网站的区域以获得更好的性能。
调试 URL：使用调试 URL 进行实时的人机交互调试。
录制：会话回放使用 rrweb DOM 重建，而非视频文件。
速率限制：请在 Browserbase 仪表板中查看您的计划限制。

🇺🇸English

Browserbase

Cloud browser infrastructure for AI agents and automation. Create browser sessions, persist authentication with contexts, debug live sessions, and retrieve session recordings.

Official docs: https://docs.browserbase.com/

When to Use

Use this skill when you need to:

Create cloud browser sessions for Playwright/Puppeteer automation
Persist login state and cookies across sessions using Contexts
Debug browser sessions in real-time with live URLs
Retrieve session recordings and logs for debugging
Manage browser sessions programmatically (list, get, update)
Run browser automation with proxy and stealth support

Prerequisites

Create an account at https://www.browserbase.com/
Get your API Key from the dashboard Settings page
Get your Project ID from the dashboard Settings page

Set environment variables:

export BROWSERBASE_TOKEN="your-api-key-here"
export BROWSERBASE_PROJECT_ID="your-project-id-here"

Note: Free plans have a concurrent session limit of 1. You'll receive a 429 error if you exceed this limit. Check your plan details in the Browserbase dashboard.

How to Use

1. Create a Session

Create a new browser session:

Write /tmp/request.json:

{
  "projectId": "<your-project-id>"
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

With timeout and keepAlive:

Write /tmp/request.json:

{
  "projectId": "<your-project-id>",
  "timeout": 300,
  "keepAlive": true
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

With proxy enabled (requires paid plan):

Write /tmp/request.json:

{
  "projectId": "<your-project-id>",
  "proxies": true
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

Note: Proxies are not available on the free plan. You'll receive a 402 error if you try to use this feature without upgrading.

With specific region (us-west-2, us-east-1, eu-central-1, ap-southeast-1):

Write /tmp/request.json:

{
  "projectId": "<your-project-id>",
  "region": "us-west-2"
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

Response includes:

id - Session ID to use for connections
connectUrl - WebSocket URL for Playwright/Puppeteer
seleniumRemoteUrl - URL for Selenium connections
signingKey - Key for HTTP connections

2. List Sessions

List all sessions with optional filters:

curl -s -X GET "https://api.browserbase.com/v1/sessions" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

Filter by status (RUNNING, ERROR, TIMED_OUT, COMPLETED):

curl -s -X GET "https://api.browserbase.com/v1/sessions?status=RUNNING" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

Query by user metadata:

Note: The query syntax for user metadata filtering uses single quotes: user_metadata['key']:'value'. To avoid complex shell escaping, write the query to a file and use --data-urlencode "q@filename".

Write /tmp/query.txt with content:

user_metadata['test']:'true'

Then query sessions:

curl -s -X GET -G "https://api.browserbase.com/v1/sessions" --data-urlencode "q@/tmp/query.txt" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

More examples:

Query by stagehand metadata - write /tmp/query.txt:

user_metadata['stagehand']:'true'

Query by environment - write /tmp/query.txt:

user_metadata['env']:'production'

Then run:

curl -s -X GET -G "https://api.browserbase.com/v1/sessions" --data-urlencode "q@/tmp/query.txt" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

3. Get Session Details

Get details of a specific session. Replace <your-session-id> with the actual session ID:

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

4. Update Session (Release)

Request to release a session before its timeout to avoid additional charges. Replace <your-session-id> with the actual session ID:

Write /tmp/request.json:

{
  "status": "REQUEST_RELEASE"
}



curl -s -X POST "https://api.browserbase.com/v1/sessions/<your-session-id>" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

The session status will change to COMPLETED and endedAt timestamp will be set.

5. Get Debug/Live URLs

Get live debugging URLs for a running session. Replace <your-session-id> with the actual session ID:

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/debug" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

Note: Debug URLs may only be available after a browser client has connected to the session via WebSocket.

Response includes:

debuggerUrl - Chrome DevTools debugger URL
debuggerFullscreenUrl - Fullscreen debugger view
wsUrl - WebSocket URL
pages - Array of open pages with their debugger URLs

6. Get Session Logs

Retrieve logs from a session. Replace <your-session-id> with the actual session ID:

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/logs" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

7. Get Session Recording

Get the rrweb recording of a session. Replace <your-session-id> with the actual session ID:

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/recording" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

8. Get Session Downloads

Retrieve files downloaded during a session (returns ZIP file). Replace <your-session-id> with the actual session ID:

curl -s -X GET "https://api.browserbase.com/v1/sessions/<your-session-id>/downloads" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" --output downloads.zip

9. Upload Files to Session

Upload files to use in a browser session. Replace <your-session-id> with the actual session ID:

curl -s -X POST "https://api.browserbase.com/v1/sessions/<your-session-id>/uploads" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -F "file=@/path/to/file.pdf"

Contexts API

Contexts allow you to persist cookies, cache, and session storage across multiple browser sessions.

Create a Context

Write /tmp/request.json:

{
  "projectId": "<your-project-id>"
}



curl -s -X POST "https://api.browserbase.com/v1/contexts" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

Save the returned id to use in sessions.

Get Context Details

Retrieve details of a specific context. Replace <your-context-id> with the actual context ID:

curl -s -X GET "https://api.browserbase.com/v1/contexts/<your-context-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

Response includes:

id - Context identifier
createdAt - Creation timestamp
updatedAt - Last update timestamp
projectId - The Project ID linked to the context

Create Session with Context

Use an existing context to restore cookies and login state. Replace <your-context-id> with the actual context ID:

Write /tmp/request.json:

{
  "projectId": "<your-project-id>",
  "browserSettings": {
    "context": {
      "id": "<your-context-id>",
      "persist": true
    }
  }
}



curl -s -X POST "https://api.browserbase.com/v1/sessions" --header "Content-Type: application/json" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -d @/tmp/request.json

Set persist: true to save updates back to the context after the session ends.

Delete Context

Delete a context when it's no longer needed. Replace <your-context-id> with the actual context ID:

curl -s -X DELETE "https://api.browserbase.com/v1/contexts/<your-context-id>" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)" -w "\nHTTP Status: %{http_code}"

Successful deletion returns HTTP 204 (No Content).

Projects API

Get Project Usage

Retrieve project-wide usage statistics (browser minutes and proxy bytes). Replace <your-project-id> with your actual project ID:

curl -s -X GET "https://api.browserbase.com/v1/projects/<your-project-id>/usage" --header "X-BB-API-Key: $(printenv BROWSERBASE_TOKEN)"

API Endpoints Reference

Endpoint	Method	Description
`/v1/sessions`	POST	Create a new browser session
`/v1/sessions`	GET	List all sessions
`/v1/sessions/{id}`	GET	Get session details (returns array)
`/v1/sessions/{id}`	POST	Update session (release)
`/v1/sessions/{id}/debug`	GET

Session Status Values

Status	Description
`RUNNING`	Session is currently active
`COMPLETED`	Session ended successfully
`ERROR`	Session ended with an error
`TIMED_OUT`	Session exceeded timeout
`REQUEST_RELEASE`	Request to end session

Guidelines

Session Lifecycle : Sessions auto-terminate after timeout (default 5 minutes). Use keepAlive: true for longer sessions.
Contexts : Use contexts to persist login state and avoid repeated authentication.
Proxies : Enable proxies for geo-restricted content or to avoid rate limiting.
Regions : Choose a region close to your target websites for better performance.
Debug URLs : Use debug URLs for real-time human-in-the-loop debugging.
Recordings : Session replays use rrweb DOM reconstruction, not video files.
Rate Limits : Check your plan limits in the Browserbase dashboard.

Weekly Installs

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode47

gemini-cli47

codex45

cursor44

github-copilot43

amp42

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

118,400 周安装

Browserbase：AI代理与自动化云端浏览器基础设施，支持Playwright/Puppeteer

🇨🇳中文介绍

Browserbase

使用时机

前提条件

使用方法

1. 创建会话

相关 Skills

2. 列出会话

3. 获取会话详情

4. 更新会话（释放）

5. 获取调试/实时 URL

6. 获取会话日志

7. 获取会话录制

8. 获取会话下载

9. 上传文件到会话

上下文 API

创建上下文

获取上下文详情

使用上下文创建会话

删除上下文

项目 API

获取项目使用情况

API 端点参考

会话状态值

指南

🇺🇸English

Browserbase

When to Use

Prerequisites

How to Use

1. Create a Session

2. List Sessions

3. Get Session Details

4. Update Session (Release)

5. Get Debug/Live URLs

6. Get Session Logs

7. Get Session Recording

8. Get Session Downloads

9. Upload Files to Session

Contexts API

Create a Context

Get Context Details

Create Session with Context

Delete Context

Projects API

Get Project Usage

API Endpoints Reference

Session Status Values

Guidelines

最新 Skills