Proxy przeglądarki

Proxy przeglądarki to osobna usługa Docker, która udostępnia automatyzację przeglądarki headless przez Playwright. Nie jest częścią API Synapse — endpointy Synapse nie zawierają ścieżek /browser/*.

Architektura

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

Metody dostępu

Metoda 1: przez serwer MCP Synapse (zalecane)

Serwer MCP Synapse udostępnia narzędzia przeglądarki jako narzędzia MCP. Należy tego używać do automatyzacji przeglądarki sterowanej przez LLM:

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

Dostępne narzędzia MCP przeglądarki:

• browser_new — otwiera nową kartę przeglądarki
• browser_navigate — przechodzi pod podany URL
• browser_click — klika element
• browser_type — wpisuje tekst w pole
• browser_screenshot — wykonuje zrzut ekranu
• browser_close — zamyka kartę
• (i więcej — patrz Integracja MCP)

Metoda 2: bezpośredni dostęp do Browser Proxy

W integracjach niewymagających MCP należy połączyć się bezpośrednio z usługą browser-proxy:

# Sprawdzenie stanu
curl http://browser-proxy.schaefer.zone:13000/health

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

Typowe przypadki użycia

Web scraping

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

Automatyzacja formularzy

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

Przechwytywanie zrzutów ekranu

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

Powiązane usługi

Następne kroki

• Integracja MCP — jak używać narzędzi przeglądarki przez MCP
• Computer Control API — automatyzacja GUI na zarejestrowanych maszynach