# Browser Proxy

Browser Proxy は Playwright 経由でヘッドレスブラウザ自動化を提供する**独立した Docker サービス**です。Synapse API の直接の一部ではなく、Synapse エンドポイントには `/browser/*` パスは含まれません。

## アーキテクチャ

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

## アクセス方法

### 方法 1：Synapse MCP Server 経由（推奨）

Synapse MCP サーバーはブラウザツールを MCP ツールとして公開しています。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"
      }
    }
  }
}
```

利用可能な MCP ブラウザツール：

- `browser_new` — 新しいブラウザタブを開く
- `browser_navigate` — URL に移動
- `browser_click` — 要素をクリック
- `browser_type` — フィールドにテキストを入力
- `browser_screenshot` — スクリーンショットを取得
- `browser_close` — タブを閉じる
- （その他多数 — [MCP 連携](/docs/mcp/what-is-mcp) を参照）

### 方法 2：Browser Proxy への直接アクセス

MCP を使用しない連携では、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"}'
```

## よくあるユースケース

### Web スクレイピング

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

### フォーム自動化

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

### スクリーンショット取得

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

## 関連サービス

| サービス | ポート | 目的 |
|---------|------|---------|
| Synapse API | 12800 | Memory、chat、tasks |
| Synapse MCP | 13100 | MCP サーバー（79 ツール） |
| Browser Proxy | 13000 | ヘッドレスブラウザ自動化 |
| SSH Proxy | 12900 | リモートマシンへの SSH アクセス |

## 次のステップ

- [MCP 連携](/docs/mcp/what-is-mcp) — MCP 経由でのブラウザツールの使い方
- [Computer Control API](/docs/api/computers) — 登録済みマシン上での GUI 自動化