# Browser-Proxy

Der Browser-Proxy ist ein **separater Docker-Dienst**, der Headless-Browser-Automatisierung
via Playwright bereitstellt. Er ist NICHT direkt Teil der Synapse-API — Synapse-Endpunkte
enthalten keine `/browser/*`-Pfade.

## Architektur

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

## Zugriffsarten

### Methode 1: Über den Synapse-MCP-Server (empfohlen)

Der Synapse-MCP-Server stellt Browser-Werkzeuge als MCP-Tools bereit. Verwende
dies für LLM-gesteuerte Browser-Automatisierung:

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

Verfügbare MCP-Browser-Tools:

- `browser_new` — neuen Browser-Tab öffnen
- `browser_navigate` — zu einer URL navigieren
- `browser_click` — auf ein Element klicken
- `browser_type` — Text in ein Feld eingeben
- `browser_screenshot` — Screenshot aufnehmen
- `browser_close` — Tab schließen
- (und mehr — siehe [MCP-Integration](/docs/mcp/what-is-mcp))

### Methode 2: Direkter Browser-Proxy-Zugriff

Für Nicht-MCP-Integrationen verbinde dich direkt mit dem Browser-Proxy-Dienst:

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

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

## Häufige Anwendungsfälle

### Web-Scraping

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

### Formular-Automatisierung

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

### Screenshot-Aufnahme

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

## Verwandte Dienste

| Dienst | Port | Zweck |
|---------|------|-------|
| Synapse API | 12800 | Memory, Chat, Tasks |
| Synapse MCP | 13100 | MCP-Server (79 Tools) |
| Browser Proxy | 13000 | Headless-Browser-Automatisierung |
| SSH Proxy | 12900 | SSH-Zugriff auf Remote-Rechner |

## Nächste Schritte

- [MCP-Integration](/docs/mcp/what-is-mcp) — wie du Browser-Tools via MCP nutzt
- [Computer-Control-API](/docs/api/computers) — für GUI-Automatisierung auf registrierten Rechnern