# Browser Proxy

Browser Proxy là một **Docker service riêng biệt** cung cấp khả năng tự động
hóa trình duyệt headless thông qua Playwright. Nó KHÔNG trực thuộc Synapse API —
các endpoint của Synapse không bao gồm đường dẫn `/browser/*`.

## Kiến trúc

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

## Phương thức truy cập

### Phương thức 1: Thông qua Synapse MCP Server (khuyến nghị)

Synapse MCP server cung cấp các công cụ trình duyệt dưới dạng công cụ MCP. Sử
dụng phương thức này cho tự động hóa trình duyệt điều khiển bởi LLM:

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

Các công cụ trình duyệt MCP khả dụng:

- `browser_new` — mở một tab trình duyệt mới
- `browser_navigate` — điều hướng đến một URL
- `browser_click` — nhấp vào một phần tử
- `browser_type` — nhập văn bản vào một trường
- `browser_screenshot` — chụp ảnh màn hình
- `browser_close` — đóng tab
- (và nhiều hơn nữa — xem [Tích hợp MCP](/docs/mcp/what-is-mcp))

### Phương thức 2: Truy cập trực tiếp Browser Proxy

Đối với các tích hợp không dùng MCP, kết nối trực tiếp đến dịch vụ browser-proxy:

```bash
# Health check
curl http://browser-proxy.schaefer.zone:13000/health

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

## Trường hợp sử dụng phổ biến

### Web scraping

```python
# Via MCP (Claude Desktop)
"Use browser_navigate to open https://news.ycombinator.com, 
 then extract the top 10 story titles."
```

### Tự động hóa biểu mẫu

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

### Chụp ảnh màn hình

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

## Các dịch vụ liên quan

| Dịch vụ | Cổng | Mục đích |
|---------|------|---------|
| Synapse API | 12800 | Bộ nhớ, chat, tác vụ |
| Synapse MCP | 13100 | MCP server (79 công cụ) |
| Browser Proxy | 13000 | Tự động hóa trình duyệt headless |
| SSH Proxy | 12900 | Truy cập SSH đến máy từ xa |

## Bước tiếp theo

- [Tích hợp MCP](/docs/mcp/what-is-mcp) — cách sử dụng các công cụ trình duyệt qua MCP
- [Computer Control API](/docs/api/computers) — cho tự động hóa GUI trên các máy đã đăng ký