mcpField
C
cloud

cloud

github.com/browser-use开发119.4k3.2k 次安装2 天前更新
代码仓库

关于 cloud

cloud 是使用 Browser Use Cloud API、SDK 和集成方式的参考技能，面向开发者。它帮助选择托管任务执行或为现有 Agent 提供浏览器访问，并涵盖 API 版本、会话和浏览器生命周期。

主要功能

  1. 01提供 Cloud REST API 和 SDK 指引
  2. 02涵盖 v2、v3 和 v4 参考资料
  3. 03说明浏览器与托管 Agent 集成路径
  4. 04提供会话、配置文件和身份验证指引
  5. 05提示浏览器生命周期与计费事项

适用场景

  1. 01向托管 Agent 提交任务
  2. 02让现有 Agent 连接云端浏览器
  3. 03维护使用旧版 API 的集成

MCP 相关

参考索引链接到 MCP 指引，但给定内容未说明 MCP 操作。

安装

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

$npx skills add https://github.com/browser-use/browser-use --skill cloud

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api-v2.md
api-v3.md
api-v4.md
browser-api.md
features.md
patterns.md
quickstart.md
sessions.md
references/guides/
chat-ui.md
subagent.md
tools-integration.md

详细介绍

Browser Use Cloud 参考

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

选择入门方式

  • 提交托管任务并获取结果：使用 references/api-v4.md 中的 V4 SDK runs 资源。
  • 现有 Agent 需要浏览器：使用 V4 SDK browsers 资源或 REST/CDP，然后明确停止浏览器。
  • 本地框架开发：使用开源的 browser-use skill，而不是调用 Cloud SDK。

符合条件的新 Google、GitHub 或 Microsoft 注册用户可获得一次性 $1 Cloud 额度。无需绑定银行卡；使用邮箱/密码注册的用户不符合条件。价格与资格。免费入门请使用 gpt-5.6-luna；仅付费模型需要充值。

复用 BROWSER_USE_API_KEY，或指导用户注册 Cloud 并创建密钥。密钥应保留在服务端，切勿放入提示词或客户端代码包中。

API 与平台

主题阅读
当前的 v4 设置、首次运行、会话、工作区、浏览器references/api-v4.md
旧版 v2 设置、价格、常见问题references/quickstart.md
v2 REST API：全部 30 个端点、cURL 示例、架构references/api-v2.md
v3 BU Agent API：会话、消息、文件、工作区references/api-v3.md
会话、配置文件、身份验证策略、1Passwordreferences/sessions.md
CDP 直接访问、Playwright/Puppeteer/Seleniumreferences/browser-api.md
代理、webhook、工作区、技能、MCP、实时视图references/features.md
并行、流式传输、地理位置抓取、教程references/patterns.md

集成指南

主题阅读
构建带实时浏览器视图的聊天界面references/guides/chat-ui.md
将 browser-use 用作子 Agent（提交任务 → 获取结果）references/guides/subagent.md
将 browser-use 工具添加到现有 Agentreferences/guides/tools-integration.md

重要说明

  • 新的托管 Agent 集成请使用 v4。仅在维护现有集成或使用 v4 SDK 尚未封装的资源时，才保留 v2 或 v3。
  • Cloud API 基础 URL：https://api.browser-use.com/api/v2/（v2）、https://api.browser-use.com/api/v3（v3）或 https://api.browser-use.com/api/v4（v4）
  • 身份验证标头：X-Browser-Use-API-Key: <key>
  • 获取 API 密钥：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
  • Python v4：from browser_use_sdk.v4 import BrowserUse 或 AsyncBrowserUse
  • TypeScript v2：import { BrowserUse } from "browser-use-sdk"
  • TypeScript v3：import { BrowserUse } from "browser-use-sdk/v3"
  • TypeScript v4：import { BrowserUse } from "browser-use-sdk/v4"
  • SDK 3.11.3 或更高版本会在 v4 命名空间中提供 browsers.create 和 browsers.stop，并提供 v4 REST /browsers 资源。务必明确停止浏览器；关闭 CDP 不会停止计费。
  • CDP WebSocket：wss://connect.browser-use.com?apiKey=KEY&proxyCountryCode=us

评论

支持 Markdown