{"title":"وكيل المتصفح","slug":"browser","category":"api","summary":"خدمة أتمتة المتصفح — حاوية Docker منفصلة على المنفذ 13000 للتحكم في متصفح headless.","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":217,"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":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# وكيل المتصفح\n\nوكيل المتصفح هو **خدمة Docker منفصلة** تُوفّر أتمتة متصفح headless عبر\nPlaywright. وهو ليس جزءًا من Synapse API مباشرةً — لا تتضمن نقاط نهاية\nSynapse مسارات `/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\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، اتصل مباشرة بخدمة وكيل المتصفح:\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| وكيل المتصفح | 13000 | أتمتة متصفح headless |\n| وكيل SSH | 12900 | وصول SSH إلى الأجهزة البعيدة |\n\n## الخطوات التالية\n\n- [تكامل MCP](/docs/mcp/what-is-mcp) — كيفية استخدام أدوات المتصفح عبر MCP\n- [Computer Control API](/docs/api/computers) — لأتمتة الواجهة الرسومية على الأجهزة المسجّلة\n","content_html":"

وكيل المتصفح

\n

وكيل المتصفح هو خدمة Docker منفصلة تُوفّر أتمتة متصفح headless عبر\nPlaywright. وهو ليس جزءًا من Synapse API مباشرةً — لا تتضمن نقاط نهاية\nSynapse مسارات /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. استخدم هذا الخيار\nلأتمتة المتصفح المدفوعة بنماذج 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: الوصول المباشر لوكيل المتصفح

\n

للتكاملات التي لا تستخدم MCP، اتصل مباشرة بخدمة وكيل المتصفح:

\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 MCP13100خادم MCP (79 أداة)
وكيل المتصفح13000أتمتة متصفح headless
وكيل SSH12900وصول 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"]}