Skip to main content

Browser Proxy

Layanan otomasi browser — container Docker terpisah pada port 13000 untuk kontrol browser headless.


Browser Proxy

Browser Proxy adalah layanan Docker terpisah yang menyediakan otomasi browser headless melalui Playwright. Layanan ini BUKAN bagian langsung dari API Synapse — endpoint Synapse tidak menyertakan path /browser/*.

Arsitektur

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

Metode Akses

Metode 1: Melalui Synapse MCP Server (disarankan)

Synapse MCP server mengekspos alat browser sebagai alat MCP. Gunakan ini untuk otomasi browser berbasis 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"
      }
    }
  }
}

Alat browser MCP yang tersedia:

  • browser_new — membuka tab browser baru
  • browser_navigate — menavigasi ke URL
  • browser_click — mengklik elemen
  • browser_type — mengetik teks ke dalam field
  • browser_screenshot — menangkap tangkapan layar
  • browser_close — menutup tab
  • (dan lainnya — lihat Integrasi MCP)

Metode 2: Akses Browser Proxy Langsung

Untuk integrasi non-MCP, hubungkan langsung ke layanan browser-proxy:

# Health check
curl http://browser-proxy.schaefer.zone:13000/health

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

Kasus Penggunaan Umum

Web scraping

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

Otomasi form

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

Tangkapan tangkapan layar

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

Layanan Terkait

Layanan Port Tujuan
Synapse API 12800 Memori, chat, tugas
Synapse MCP 13100 MCP server (79 alat)
Browser Proxy 13000 Otomasi browser headless
SSH Proxy 12900 Akses SSH ke mesin remote

Langkah Berikutnya