{"title":"Browser 代理","slug":"browser","category":"api","summary":"浏览器自动化服务 — 独立 Docker 容器，端口 13000，用于无头浏览器控制。","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":142,"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":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Browser 代理\n\nBrowser 代理是一个**独立的 Docker 服务**，通过 Playwright 提供无头浏览器自动化。它**不**直接属于 Synapse API 的一部分 — 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\nSynapse MCP Server 将浏览器工具作为 MCP 工具暴露。请在需要 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：直接访问 Browser 代理\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 Server（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 代理

\n

Browser 代理是一个独立的 Docker 服务，通过 Playwright 提供无头浏览器自动化。它不直接属于 Synapse API 的一部分 — 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 Server（推荐）

\n

Synapse MCP Server 将浏览器工具作为 MCP 工具暴露。请在需要 LLM 驱动的浏览器自动化时使用：

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

可用的 MCP 浏览器工具：

\n\n

方式 2：直接访问 Browser 代理

\n

对于非 MCP 集成，可直接连接 browser-proxy 服务：

\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
# 通过 MCP（Claude Desktop）\n"Use browser_navigate to open https://news.ycombinator.com, \n then extract the top 10 story titles."

表单自动化

\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
# 通过 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 API12800记忆、聊天、任务
Synapse MCP13100MCP Server（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"]}