Browser Use API

# Browser Use

基于云的 AI 浏览器自动化。发送纯文本任务，获取结构化结果。

## 快速开始

```bash # 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` 以便更简单地执行：

```bash # 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 ```

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

Response: ```json { "id": "task-uuid", "sessionId": "session-uuid" } ```

### 获取任务状态 ``` GET https://api.browser-use.com/api/v2/tasks/{taskId} ```

响应字段： - `status`: `pending` | `started` | `finished` | `failed` - `output`: 完成后的结果文本 - `steps`: 已执行的操作数组（包含截图） - `cost`: 成本（美元，例如 "0.02"） - `isSuccess`: 布尔结果

### 停止任务 ``` POST https://api.browser-use.com/api/v2/tasks/{taskId}/stop ```

## 定价

每个任务约 $0.01-0.05，具体取决于复杂度。检查余额： ```bash curl -s https://api.browser-use.com/api/v2/credits \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" ```

## 适用场景

- 复杂的多步骤 Web 工作流 - 会拦截简单抓取的网站 - 填写并提交表单 - 需要步骤截图时 - 本地浏览器控制不可用时

## 不适用场景

- 简单的页面获取（请改用 `web_fetch`） - 当你有本地浏览器访问权限时（请使用 `browser` 工具） - 快速/高吞吐量的抓取（请使用 Code Use 或本地抓取）