Cloud

---
name: browser-use-zh-cloud
description: >
  使用 Browser Use Cloud 的文档参考 — 浏览器自动化的托管 API 和 SDK。
  当用户需要帮助使用 Cloud REST API（v2 或 v3）、browser-use-sdk（Python 或
  TypeScript）、X-Browser-Use-API-Key 认证、云会话、浏览器配置文件、配置文件
  同步、CDP WebSocket 连接、隐身浏览器、住宅代理、CAPTCHA 处理、Webhook、
  工作区、技能市场、liveUrl 流式传输、定价或集成模式（聊天界面、子代理、
  为现有代理添加浏览器工具）时使用此技能。也适用于 n8n/Make/Zapier 集成、
  云基础设施上的 Playwright/Puppeteer/Selenium、或 1Password 保管库集成
  相关的问题。请勿将此技能用于开源 Python 库（Agent、Browser、Tools
  配置） — 请使用 open-source 技能。
allowed-tools: Read
---

# Browser Use Cloud 参考

Cloud REST API、SDK 和集成模式的参考文档。
根据用户需求阅读相关文件。

## API 与平台

| 主题 | 阅读 |
|------|------|
| 设置、首个任务、定价、常见问题 | `references/quickstart.md` |
| v2 REST API：全部 30 个端点、cURL 示例、Schema | `references/api-v2.md` |
| v3 BU Agent API：会话、消息、文件、工作区 | `references/api-v3.md` |
| 会话、配置文件、认证策略、1Password | `references/sessions.md` |
| CDP 直接访问、Playwright/Puppeteer/Selenium | `references/browser-api.md` |
| 代理、Webhook、工作区、Skills、MCP、实时视图 | `references/features.md` |
| 并行执行、流式传输、地理位置爬取、教程 | `references/patterns.md` |

## 集成指南

| 主题 | 阅读 |
|------|------|
| 构建带有实时浏览器视图的聊天界面 | `references/guides/chat-ui.md` |
| 将 browser-use 作为子代理使用（任务输入 → 结果输出） | `references/guides/subagent.md` |
| 为现有代理添加 browser-use 工具 | `references/guides/tools-integration.md` |

## 重要提示

- Cloud API 基础 URL：`https://api.browser-use.com/api/v2/`（v2）或 `https://api.browser-use.com/api/v3`（v3）
- 认证头：`X-Browser-Use-API-Key: <key>`
- 获取 API Key：https://cloud.browser-use.com/new-api-key
- 设置环境变量：`BROWSER_USE_API_KEY=<key>`
- Cloud SDK：`uv pip install browser-use-sdk`（Python）或 `npm install browser-use-sdk`（TypeScript）
- Python v2：`from browser_use_sdk import AsyncBrowserUse`
- Python v3：`from browser_use_sdk.v3 import AsyncBrowserUse`
- TypeScript v2：`import { BrowserUse } from "browser-use-sdk"`
- TypeScript v3：`import { BrowserUse } from "browser-use-sdk/v3"`
- CDP WebSocket：`wss://connect.browser-use.com?apiKey=KEY&proxyCountryCode=us`