{"title":"Browser Proxy","slug":"browser","category":"api","summary":"Dịch vụ tự động hóa trình duyệt — Docker container riêng trên cổng 13000 để điều khiển trình duyệt headless.","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":298,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Browser Proxy\n\nBrowser Proxy là một **Docker service riêng biệt** cung cấp khả năng tự động\nhóa trình duyệt headless thông qua Playwright. Nó KHÔNG trực thuộc Synapse API —\ncác endpoint của Synapse không bao gồm đường dẫn `/browser/*`.\n\n## Kiến trúc\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## Phương thức truy cập\n\n### Phương thức 1: Thông qua Synapse MCP Server (khuyến nghị)\n\nSynapse MCP server cung cấp các công cụ trình duyệt dưới dạng công cụ MCP. Sử\ndụng phương thức này cho tự động hóa trình duyệt điều khiển bởi LLM:\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\nCác công cụ trình duyệt MCP khả dụng:\n\n- `browser_new` — mở một tab trình duyệt mới\n- `browser_navigate` — điều hướng đến một URL\n- `browser_click` — nhấp vào một phần tử\n- `browser_type` — nhập văn bản vào một trường\n- `browser_screenshot` — chụp ảnh màn hình\n- `browser_close` — đóng tab\n- (và nhiều hơn nữa — xem [Tích hợp MCP](/docs/mcp/what-is-mcp))\n\n### Phương thức 2: Truy cập trực tiếp Browser Proxy\n\nĐối với các tích hợp không dùng MCP, kết nối trực tiếp đến dịch vụ 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## Trường hợp sử dụng phổ biến\n\n### Web scraping\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### Tự động hóa biểu mẫu\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### Chụp ảnh màn hình\n\n```python\n# Via MCP\n\"Take a screenshot of https://example.com and save it.\"\n```\n\n## Các dịch vụ liên quan\n\n| Dịch vụ | Cổng | Mục đích |\n|---------|------|---------|\n| Synapse API | 12800 | Bộ nhớ, chat, tác vụ |\n| Synapse MCP | 13100 | MCP server (79 công cụ) |\n| Browser Proxy | 13000 | Tự động hóa trình duyệt headless |\n| SSH Proxy | 12900 | Truy cập SSH đến máy từ xa |\n\n## Bước tiếp theo\n\n- [Tích hợp MCP](/docs/mcp/what-is-mcp) — cách sử dụng các công cụ trình duyệt qua MCP\n- [Computer Control API](/docs/api/computers) — cho tự động hóa GUI trên các máy đã đăng ký\n","content_html":"

Browser Proxy

\n

Browser Proxy là một Docker service riêng biệt cung cấp khả năng tự động\nhóa trình duyệt headless thông qua Playwright. Nó KHÔNG trực thuộc Synapse API —\ncác endpoint của Synapse không bao gồm đường dẫn /browser/*.

\n

Kiến trúc

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

Phương thức truy cập

\n

Phương thức 1: Thông qua Synapse MCP Server (khuyến nghị)

\n

Synapse MCP server cung cấp các công cụ trình duyệt dưới dạng công cụ MCP. Sử\ndụng phương thức này cho tự động hóa trình duyệt điều khiển bởi LLM:

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

Các công cụ trình duyệt MCP khả dụng:

\n\n

Phương thức 2: Truy cập trực tiếp Browser Proxy

\n

Đối với các tích hợp không dùng MCP, kết nối trực tiếp đến dịch vụ 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"}'

Trường hợp sử dụng phổ biến

\n

Web scraping

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

Tự động hóa biểu mẫu

\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."

Chụp ảnh màn hình

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

Các dịch vụ liên quan

\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
Dịch vụCổngMục đích
Synapse API12800Bộ nhớ, chat, tác vụ
Synapse MCP13100MCP server (79 công cụ)
Browser Proxy13000Tự động hóa trình duyệt headless
SSH Proxy12900Truy cập SSH đến máy từ xa
\n

Bước tiếp theo

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