{"title":"Браузерний проксі","slug":"browser","category":"api","summary":"Служба автоматизації браузера — окремий Docker-контейнер на порту 13000 для керування браузером без графічного інтерфейсу.","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":212,"read_minutes":1,"llm_context":"Browser Proxy is a SEPARATE Docker service (port 13000), NOT a Synapse endpoint.\nSynapse endpoints do NOT include /browser/* paths.\nFor browser automation, use the MCP browser_new tool OR connect to the browser-proxy service directly.\nSynapse MCP exposes browser tools (browser_new, browser_navigate, browser_click, etc.)\n","lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Браузерний проксі\n\nБраузерний проксі — це **окрема Docker-служба**, яка забезпечує автоматизацію\nбраузера без графічного інтерфейсу через Playwright. Вона НЕ є частиною API\nSynapse безпосередньо — кінцеві точки Synapse не включають шляхи `/browser/*`.\n\n## Архітектура\n\n```\n┌──────────────┐                ┌──────────────────┐\n│  Synapse API │                │  Browser Proxy   │\n│  port 12800  │                │  port 13000      │\n│              │                │  (Playwright)    │\n└──────────────┘                └──────────────────┘\n       ▲                                ▲\n       │                                │\n       └──────────┌─────────────┐──────┘\n                  │  MCP Server │\n                  │  port 13100 │\n                  └─────────────┘\n```\n\n## Методи доступу\n\n### Метод 1: Через Synapse MCP Server (рекомендовано)\n\nСервер Synapse MCP надає браузерні інструменти як MCP-інструменти. Використовуйте\nцей метод для автоматизації браузера під керуванням LLM:\n\n```json\n// Конфігурація Claude Desktop\n{\n  \"mcpServers\": {\n    \"synapse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n      \"env\": {\n        \"SYNAPSE_MIND_KEY\": \"mk_...\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\nДоступні MCP-інструменти браузера:\n\n- `browser_new` — відкрити нову вкладку браузера\n- `browser_navigate` — перейти до URL\n- `browser_click` — клацнути на елемент\n- `browser_type` — ввести текст у поле\n- `browser_screenshot` — зробити знімок екрана\n- `browser_close` — закрити вкладку\n- (та інші — дивіться [інтеграцію MCP](/docs/mcp/what-is-mcp))\n\n### Метод 2: Прямий доступ до браузерного проксі\n\nДля не-MCP інтеграцій підключайтеся безпосередньо до служби browser-proxy:\n\n```bash\n# Перевірка стану\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Відкрити сторінку\ncurl -X POST http://browser-proxy.schaefer.zone:13000/navigate \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"url\": \"https://example.com\"}'\n```\n\n## Типові варіанти використання\n\n### Веб-скрапінг\n\n```python\n# Через MCP (Claude Desktop)\n\"Use browser_navigate to open https://news.ycombinator.com, \n then extract the top 10 story titles.\"\n```\n\n### Автоматизація форм\n\n```python\n# Через MCP\n\"Use browser_navigate to open the login page,\n browser_type to fill username and password,\n browser_click to submit the form.\"\n```\n\n### Захоплення знімків екрана\n\n```python\n# Через MCP\n\"Take a screenshot of https://example.com and save it.\"\n```\n\n## Пов'язані служби\n\n| Служба | Порт | Призначення |\n|---------|------|---------|\n| Synapse API | 12800 | Пам'ять, чат, завдання |\n| Synapse MCP | 13100 | MCP-сервер (79 інструментів) |\n| Browser Proxy | 13000 | Автоматизація браузера без графічного інтерфейсу |\n| SSH Proxy | 12900 | SSH-доступ до віддалених машин |\n\n## Наступні кроки\n\n- [Інтеграція MCP](/docs/mcp/what-is-mcp) — як використовувати браузерні інструменти через MCP\n- [API керування комп'ютерами](/docs/api/computers) — для автоматизації GUI на зареєстрованих машинах\n","content_html":"<h1>Браузерний проксі</h1>\n<p>Браузерний проксі — це <strong>окрема Docker-служба</strong>, яка забезпечує автоматизацію\nбраузера без графічного інтерфейсу через Playwright. Вона НЕ є частиною API\nSynapse безпосередньо — кінцеві точки Synapse не включають шляхи <code>/browser/*</code>.</p>\n<h2>Архітектура</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐                ┌──────────────────┐\n│  Synapse API │                │  Browser Proxy   │\n│  port 12800  │                │  port 13000      │\n│              │                │  (Playwright)    │\n└──────────────┘                └──────────────────┘\n       ▲                                ▲\n       │                                │\n       └──────────┌─────────────┐──────┘\n                  │  MCP Server │\n                  │  port 13100 │\n                  └─────────────┘</code></pre><h2>Методи доступу</h2>\n<h3>Метод 1: Через Synapse MCP Server (рекомендовано)</h3>\n<p>Сервер Synapse MCP надає браузерні інструменти як MCP-інструменти. Використовуйте\nцей метод для автоматизації браузера під керуванням LLM:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-comment\">// Конфігурація Claude Desktop</span>\n<span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><p>Доступні MCP-інструменти браузера:</p>\n<ul>\n<li><code>browser_new</code> — відкрити нову вкладку браузера</li>\n<li><code>browser_navigate</code> — перейти до URL</li>\n<li><code>browser_click</code> — клацнути на елемент</li>\n<li><code>browser_type</code> — ввести текст у поле</li>\n<li><code>browser_screenshot</code> — зробити знімок екрана</li>\n<li><code>browser_close</code> — закрити вкладку</li>\n<li>(та інші — дивіться <a href=\"/docs/mcp/what-is-mcp\">інтеграцію MCP</a>)</li>\n</ul>\n<h3>Метод 2: Прямий доступ до браузерного проксі</h3>\n<p>Для не-MCP інтеграцій підключайтеся безпосередньо до служби browser-proxy:</p>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Перевірка стану</span>\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n<span class=\"hljs-comment\"># Відкрити сторінку</span>\ncurl -X POST http://browser-proxy.schaefer.zone:13000/navigate \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{&quot;url&quot;: &quot;https://example.com&quot;}&#x27;</span></code></pre><h2>Типові варіанти використання</h2>\n<h3>Веб-скрапінг</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-comment\"># Через MCP (Claude Desktop)</span>\n<span class=\"hljs-string\">&quot;Use browser_navigate to open https://news.ycombinator.com, \n then extract the top 10 story titles.&quot;</span></code></pre><h3>Автоматизація форм</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-comment\"># Через MCP</span>\n<span class=\"hljs-string\">&quot;Use browser_navigate to open the login page,\n browser_type to fill username and password,\n browser_click to submit the form.&quot;</span></code></pre><h3>Захоплення знімків екрана</h3>\n<pre><code class=\"hljs language-python\"><span class=\"hljs-comment\"># Через MCP</span>\n<span class=\"hljs-string\">&quot;Take a screenshot of https://example.com and save it.&quot;</span></code></pre><h2>Пов&#39;язані служби</h2>\n<table>\n<thead>\n<tr>\n<th>Служба</th>\n<th>Порт</th>\n<th>Призначення</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Synapse API</td>\n<td>12800</td>\n<td>Пам&#39;ять, чат, завдання</td>\n</tr>\n<tr>\n<td>Synapse MCP</td>\n<td>13100</td>\n<td>MCP-сервер (79 інструментів)</td>\n</tr>\n<tr>\n<td>Browser Proxy</td>\n<td>13000</td>\n<td>Автоматизація браузера без графічного інтерфейсу</td>\n</tr>\n<tr>\n<td>SSH Proxy</td>\n<td>12900</td>\n<td>SSH-доступ до віддалених машин</td>\n</tr>\n</tbody></table>\n<h2>Наступні кроки</h2>\n<ul>\n<li><a href=\"/docs/mcp/what-is-mcp\">Інтеграція MCP</a> — як використовувати браузерні інструменти через MCP</li>\n<li><a href=\"/docs/api/computers\">API керування комп&#39;ютерами</a> — для автоматизації GUI на зареєстрованих машинах</li>\n</ul>\n","urls":{"html":"/docs/api/browser","text":"/docs/api/browser?format=text","json":"/docs/api/browser?format=json","llm":"/docs/api/browser?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}