浏览器使用

基于云端AI的浏览器自动化。用简单的英语描述任务，获取结构化结果。

快速开始

# Submit task
curl -s -X POST https://api.browser-use.com/api/v2/tasks \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Go to example.com and extract the main heading"}'

# Poll for result (replace TASK_ID)
curl -s "https://api.browser-use.com/api/v2/tasks/TASK_ID" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"

辅助脚本

使用scripts/browser-use.sh以简化执行：

# Run task and wait for result
./scripts/browser-use.sh "Go to hacker news and get the top 3 stories"

# Just submit (don't wait)
./scripts/browser-use.sh --no-wait "Search Google for AI news"

API参考

创建任务

POST https://api.browser-use.com/api/v2/tasks

请求体：

{
  "task": "Plain English description of what to do",
  "llm": "gemini-3-flash-preview"  // optional, default is fast model
}

响应：

{
  "id": "task-uuid",
  "sessionId": "session-uuid"
}

获取任务状态

GET https://api.browser-use.com/api/v2/tasks/{taskId}

响应字段：

• 状态：待处理|已开始|已完成|已失败
• 输出：完成时的结果文本
• 步骤所采取的操作数组（含截图）
• 成本：以美元计的成本（例如：“0.02”）
• isSuccess：布尔结果

停止任务

POST https://api.browser-use.com/api/v2/tasks/{taskId}/stop

定价

根据任务复杂度，每项任务约0.01-0.05美元。查看余额：

curl -s https://api.browser-use.com/api/v2/credits \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"

何时使用

• 复杂的多步骤网页工作流
• 阻止简单抓取的网站
• 表单填写与提交
• 需要步骤截图时
• 本地浏览器控制不可用时

何时不应使用

• 简单页面获取（请改用web_fetch）
• 拥有本地浏览器访问权限时（请使用browser工具）
• 快速/大批量抓取（请使用代码执行或本地抓取）