Browser Proxy

Il Browser Proxy è un servizio Docker separato che fornisce automazione di browser headless tramite Playwright. NON fa parte direttamente dell'API di Synapse — gli endpoint di Synapse non includono percorsi /browser/*.

Architettura

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

Metodi di accesso

Metodo 1: tramite il server MCP di Synapse (consigliato)

Il server MCP di Synapse espone i browser tool come strumenti MCP. Lo utilizzi per l'automazione del browser guidata da LLM:

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

Strumenti MCP per il browser disponibili:

• browser_new — apre una nuova scheda del browser
• browser_navigate — naviga a un URL
• browser_click — clicca su un elemento
• browser_type — digita testo in un campo
• browser_screenshot — cattura una schermata
• browser_close — chiude la scheda
• (e altri — vedi Integrazione MCP)

Metodo 2: accesso diretto al Browser Proxy

Per integrazioni non MCP, si connetta direttamente al servizio browser-proxy:

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

Casi d'uso comuni

Web scraping

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

Automazione di form

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

Cattura di schermate

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

Servizi correlati

Prossimi passi

• Integrazione MCP — come usare i browser tool tramite MCP
• API Computer Control — per automazione GUI su macchine registrate