{"title":"Browser Proxy","slug":"browser","category":"api","summary":"브라우저 자동화 서비스 — 헤드리스 브라우저 제어를 위한 별도의 Docker 컨테이너 (포트 13000).","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":196,"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":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Browser Proxy\n\nBrowser Proxy는 Playwright를 통해 헤드리스 브라우저 자동화를 제공하는\n**별도의 Docker 서비스**입니다. 이것은 Synapse API의 직접적인 부분이\n아닙니다 — 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 서버 경유 (권장)\n\nSynapse MCP 서버는 브라우저 도구를 MCP 도구로 노출합니다. LLM 기반\n브라우저 자동화에 사용하십시오:\n\n```json\n// Claude Desktop config\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: Browser Proxy 직접 접근\n\nMCP가 아닌 통합의 경우, browser-proxy 서비스에 직접 연결하십시오:\n\n```bash\n# Health check\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Open a page\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# Via 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# Via 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# Via MCP\n\"Take a screenshot of https://example.com and save it.\"\n```\n\n## 관련 서비스\n\n| 서비스 | 포트 | 용도 |\n|---------|------|---------|\n| Synapse API | 12800 | Memory, chat, tasks |\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- [Computer Control API](/docs/api/computers) — 등록된 머신에서의 GUI 자동화용\n","content_html":"

Browser Proxy

\n

Browser Proxy는 Playwright를 통해 헤드리스 브라우저 자동화를 제공하는\n별도의 Docker 서비스입니다. 이것은 Synapse API의 직접적인 부분이\n아닙니다 — Synapse 엔드포인트에는 /browser/* 경로가 포함되지 않습니다.

\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

방법 1: Synapse MCP 서버 경유 (권장)

\n

Synapse MCP 서버는 브라우저 도구를 MCP 도구로 노출합니다. LLM 기반\n브라우저 자동화에 사용하십시오:

\n
// Claude Desktop config\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}

사용 가능한 MCP 브라우저 도구:

\n\n

방법 2: Browser Proxy 직접 접근

\n

MCP가 아닌 통합의 경우, browser-proxy 서비스에 직접 연결하십시오:

\n
# Health check\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Open a page\ncurl -X POST http://browser-proxy.schaefer.zone:13000/navigate \\\n  -H "Content-Type: application/json" \\\n  -d '{"url": "https://example.com"}'

일반적인 사용 사례

\n

웹 스크래핑

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

폼 자동화

\n
# Via 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
# Via MCP\n"Take a screenshot of https://example.com and save it."

관련 서비스

\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
서비스포트용도
Synapse API12800Memory, chat, tasks
Synapse MCP13100MCP 서버 (79개 도구)
Browser Proxy13000헤드리스 브라우저 자동화
SSH Proxy12900원격 머신 SSH 접근
\n

다음 단계

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