browser-use

Browser Use

Browser Use 通过 API 提供云浏览器和自主浏览器自动化功能。

文档：

• 开源库：https://docs.browser-use.com
• 云 API：https://docs.cloud.browser-use.com

设置

API Key 从 clawdbot 配置中的 skills.entries.browser-use.apiKey 读取。

如果未配置，请告知用户：

要使用 Browser Use，你需要 API Key。请前往 https://cloud.browser-use.com 获取（新注册用户可获得 $10 免费额度）。然后进行配置：

clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here"

基础 URL：https://api.browser-use.com/api/v2

所有请求都需要包含请求头：X-Browser-Use-API-Key: <apiKey>

---

1. 浏览器会话（主要功能）

启动云浏览器，供 Clawdbot 直接控制。使用配置文件持久保存登录状态和 Cookie。

创建浏览器会话

# With profile (recommended - keeps you logged in)
curl -X POST "https://api.browser-use.com/api/v2/browsers" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profileId": "<profile-uuid>", "timeout": 60}'

# Without profile (fresh browser)
curl -X POST "https://api.browser-use.com/api/v2/browsers" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout": 60}'

响应：

{
  "id": "session-uuid",
  "cdpUrl": "https://<id>.cdp2.browser-use.com",
  "liveUrl": "https://...",
  "status": "active"
}

将 Clawdbot 连接到浏览器

gateway config.patch '{"browser":{"profiles":{"browseruse":{"cdpUrl":"<cdpUrl-from-response>"}}}}'

现在使用 browser 工具，并设置 profile=browseruse 来控制浏览器。

列出/停止浏览器会话

# List active sessions
curl "https://api.browser-use.com/api/v2/browsers" -H "X-Browser-Use-API-Key: $API_KEY"

# Get session status
curl "https://api.browser-use.com/api/v2/browsers/<session-id>" -H "X-Browser-Use-API-Key: $API_KEY"

# Stop session (unused time is refunded)
curl -X PATCH "https://api.browser-use.com/api/v2/browsers/<session-id>" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "stopped"}'

**定价：**按需付费为每小时 $0.06，商业版为每小时 $0.03。每个会话最长 4 小时。按分钟计费，未使用的时间会退还。

---

2. 配置文件

配置文件可在不同浏览器会话间持久保存 Cookie 和登录状态。创建配置文件，在浏览器中登录你的账户，然后重复使用该配置文件。

# List profiles
curl "https://api.browser-use.com/api/v2/profiles" -H "X-Browser-Use-API-Key: $API_KEY"

# Create profile
curl -X POST "https://api.browser-use.com/api/v2/profiles" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Profile"}'

# Delete profile
curl -X DELETE "https://api.browser-use.com/api/v2/profiles/<profile-id>" \
  -H "X-Browser-Use-API-Key: $API_KEY"

**提示：**你也可以使用 Browser Use Chrome 扩展，从本地 Chrome 同步 Cookie。

---

3. 任务（子 Agent）

运行自主浏览器任务，例如由子 Agent 为你处理浏览器交互。提供提示词，它便会完成任务。

始终使用 browser-use-llm——此模型针对浏览器任务进行了优化，速度比其他模型快 3–5 倍。

curl -X POST "https://api.browser-use.com/api/v2/tasks" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Go to amazon.com and find the price of the MacBook Air M3",
    "llm": "browser-use-llm"
  }'

轮询任务完成状态

curl "https://api.browser-use.com/api/v2/tasks/<task-id>" -H "X-Browser-Use-API-Key: $API_KEY"

响应：

{
  "status": "finished",
  "output": "The MacBook Air M3 is priced at $1,099",
  "isSuccess": true,
  "cost": "0.02"
}

状态值：pending、running、finished、failed、stopped

任务选项

选项	描述
task	你的提示词（必填）
llm	始终使用 browser-use-llm
startUrl	起始页面
maxSteps	最大操作数（默认值为 100）
sessionId	重用现有会话
profileId	使用配置文件进行身份验证
flashMode	执行速度更快
vision	视觉理解

---

完整 API 参考

请参阅 references/api.md，了解所有端点，包括 Sessions、Files、Skills 和 Skills Marketplace。