# Browser 代理

Browser 代理是一个**独立的 Docker 服务**，通过 Playwright 提供无头浏览器自动化。它**不**直接属于 Synapse API 的一部分 — Synapse 端点不包含 `/browser/*` 路径。

## 架构

```
┌──────────────┐                ┌──────────────────┐
│  Synapse API │                │  Browser Proxy   │
│  port 12800  │                │  port 13000      │
│              │                │  (Playwright)    │
└──────────────┘                └──────────────────┘
       ▲                                ▲
       │                                │
       └──────────┌─────────────┐──────┘
                  │  MCP Server │
                  │  port 13100 │
                  └─────────────┘
```

## 访问方式

### 方式 1：通过 Synapse MCP Server（推荐）

Synapse MCP Server 将浏览器工具作为 MCP 工具暴露。请在需要 LLM 驱动的浏览器自动化时使用：

```json
// Claude Desktop 配置
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}
```

可用的 MCP 浏览器工具：

- `browser_new` — 打开新的浏览器标签页
- `browser_navigate` — 导航到指定 URL
- `browser_click` — 点击元素
- `browser_type` — 在输入框中输入文本
- `browser_screenshot` — 截屏
- `browser_close` — 关闭标签页
- （更多请见 [MCP 集成](/docs/mcp/what-is-mcp)）

### 方式 2：直接访问 Browser 代理

对于非 MCP 集成，可直接连接 browser-proxy 服务：

```bash
# 健康检查
curl http://browser-proxy.schaefer.zone:13000/health

# 打开页面
curl -X POST http://browser-proxy.schaefer.zone:13000/navigate \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'
```

## 常见用例

### 网页抓取

```python
# 通过 MCP（Claude Desktop）
"Use browser_navigate to open https://news.ycombinator.com, 
 then extract the top 10 story titles."
```

### 表单自动化

```python
# 通过 MCP
"Use browser_navigate to open the login page,
 browser_type to fill username and password,
 browser_click to submit the form."
```

### 截屏

```python
# 通过 MCP
"Take a screenshot of https://example.com and save it."
```

## 相关服务

| 服务 | 端口 | 用途 |
|---------|------|---------|
| Synapse API | 12800 | 记忆、聊天、任务 |
| Synapse MCP | 13100 | MCP Server（79 个工具） |
| Browser Proxy | 13000 | 无头浏览器自动化 |
| SSH Proxy | 12900 | 远程机器的 SSH 访问 |

## 下一步

- [MCP 集成](/docs/mcp/what-is-mcp) — 如何通过 MCP 使用浏览器工具
- [Computer Control API](/docs/api/computers) — 用于在已注册机器上进行 GUI 自动化