{"title":"Proxy przeglądarki","slug":"browser","category":"api","summary":"Usługa automatyzacji przeglądarki — osobny kontener Docker na porcie 13000 do sterowania przeglądarką headless.","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":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Proxy przeglądarki\n\nProxy przeglądarki to **osobna usługa Docker**, która udostępnia automatyzację\nprzeglądarki headless przez Playwright. Nie jest częścią API Synapse — endpointy\nSynapse nie zawierają ścieżek `/browser/*`.\n\n## Architektura\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## Metody dostępu\n\n### Metoda 1: przez serwer MCP Synapse (zalecane)\n\nSerwer MCP Synapse udostępnia narzędzia przeglądarki jako narzędzia MCP. Należy\ntego używać do automatyzacji przeglądarki sterowanej przez LLM:\n\n```json\n// Konfiguracja 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\nDostępne narzędzia MCP przeglądarki:\n\n- `browser_new` — otwiera nową kartę przeglądarki\n- `browser_navigate` — przechodzi pod podany URL\n- `browser_click` — klika element\n- `browser_type` — wpisuje tekst w pole\n- `browser_screenshot` — wykonuje zrzut ekranu\n- `browser_close` — zamyka kartę\n- (i więcej — patrz [Integracja MCP](/docs/mcp/what-is-mcp))\n\n### Metoda 2: bezpośredni dostęp do Browser Proxy\n\nW integracjach niewymagających MCP należy połączyć się bezpośrednio z usługą\nbrowser-proxy:\n\n```bash\n# Sprawdzenie stanu\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Otwarcie strony\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## Typowe przypadki użycia\n\n### Web scraping\n\n```python\n# Przez MCP (Claude Desktop)\n\"Use browser_navigate to open https://news.ycombinator.com, \n then extract the top 10 story titles.\"\n```\n\n### Automatyzacja formularzy\n\n```python\n# Przez 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### Przechwytywanie zrzutów ekranu\n\n```python\n# Przez MCP\n\"Take a screenshot of https://example.com and save it.\"\n```\n\n## Powiązane usługi\n\n| Usługa | Port | Przeznaczenie |\n|---------|------|----------------|\n| Synapse API | 12800 | Memory, chat, tasks |\n| Synapse MCP | 13100 | Serwer MCP (79 narzędzi) |\n| Browser Proxy | 13000 | Automatyzacja przeglądarki headless |\n| SSH Proxy | 12900 | Dostęp SSH do zdalnych maszyn |\n\n## Następne kroki\n\n- [Integracja MCP](/docs/mcp/what-is-mcp) — jak używać narzędzi przeglądarki przez MCP\n- [Computer Control API](/docs/api/computers) — automatyzacja GUI na zarejestrowanych maszynach\n","content_html":"

Proxy przeglądarki

\n

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

\n

Architektura

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

Metody dostępu

\n

Metoda 1: przez serwer MCP Synapse (zalecane)

\n

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

\n
// Konfiguracja 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}

Dostępne narzędzia MCP przeglądarki:

\n\n

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

\n

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

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

Typowe przypadki użycia

\n

Web scraping

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

Automatyzacja formularzy

\n
# Przez 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."

Przechwytywanie zrzutów ekranu

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

Powiązane usługi

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
UsługaPortPrzeznaczenie
Synapse API12800Memory, chat, tasks
Synapse MCP13100Serwer MCP (79 narzędzi)
Browser Proxy13000Automatyzacja przeglądarki headless
SSH Proxy12900Dostęp SSH do zdalnych maszyn
\n

Następne kroki

\n\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"]}