# 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 서버 경유 (권장)

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"}'
```

## 일반적인 사용 사례

### 웹 스크래핑

```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 자동화용