Браузерний проксі

Браузерний проксі — це окрема Docker-служба, яка забезпечує автоматизацію браузера без графічного інтерфейсу через Playwright. Вона НЕ є частиною API Synapse безпосередньо — кінцеві точки Synapse не включають шляхи /browser/*.

Архітектура

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

Методи доступу

Метод 1: Через Synapse MCP Server (рекомендовано)

Сервер Synapse MCP надає браузерні інструменти як MCP-інструменти. Використовуйте цей метод для автоматизації браузера під керуванням LLM:

// Конфігурація Claude Desktop
{
  "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)

Метод 2: Прямий доступ до браузерного проксі

Для не-MCP інтеграцій підключайтеся безпосередньо до служби browser-proxy:

# Перевірка стану
curl http://browser-proxy.schaefer.zone:13000/health

# Відкрити сторінку
curl -X POST http://browser-proxy.schaefer.zone:13000/navigate \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Типові варіанти використання

Веб-скрапінг

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

Автоматизація форм

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

Захоплення знімків екрана

# Через MCP
"Take a screenshot of https://example.com and save it."

Пов'язані служби

Наступні кроки

• Інтеграція MCP — як використовувати браузерні інструменти через MCP
• API керування комп'ютерами — для автоматизації GUI на зареєстрованих машинах