# وكيل المتصفح

وكيل المتصفح هو **خدمة Docker منفصلة** تُوفّر أتمتة متصفح headless عبر
Playwright. وهو ليس جزءًا من Synapse API مباشرةً — لا تتضمن نقاط نهاية
Synapse مسارات `/browser/*`.

## البنية

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

## طرق الوصول

### الطريقة 1: عبر خادم Synapse MCP (موصى بها)

يُعرض وكيل المتصفح عبر خادم Synapse MCP كأدوات MCP. استخدم هذا الخيار
لأتمتة المتصفح المدفوعة بنماذج LLM:

```json
// إعدادات Claude Desktop
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}
```

أدوات متصفح MCP المتاحة:

- `browser_new` — فتح علامة تبويب متصفح جديدة
- `browser_navigate` — الانتقال إلى عنوان URL
- `browser_click` — النقر على عنصر
- `browser_type` — كتابة نص في حقل
- `browser_screenshot` — التقاط لقطة شاشة
- `browser_close` — إغلاق علامة التبويب
- (والمزيد — راجع [تكامل MCP](/docs/mcp/what-is-mcp))

### الطريقة 2: الوصول المباشر لوكيل المتصفح

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

```bash
# فحص الحالة
curl http://browser-proxy.schaefer.zone:13000/health

# فتح صفحة
curl -X POST http://browser-proxy.schaefer.zone:13000/navigate \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'
```

## حالات الاستخدام الشائعة

### استخراج بيانات الويب

```python
# عبر MCP (Claude Desktop)
"Use browser_navigate to open https://news.ycombinator.com, 
 then extract the top 10 story titles."
```

### أتمتة النماذج

```python
# عبر MCP
"Use browser_navigate to open the login page,
 browser_type to fill username and password,
 browser_click to submit the form."
```

### التقاط لقطات الشاشة

```python
# عبر MCP
"Take a screenshot of https://example.com and save it."
```

## الخدمات ذات الصلة

| الخدمة | المنفذ | الغرض |
|---------|------|---------|
| Synapse API | 12800 | الذاكرة، الدردشة، المهام |
| Synapse MCP | 13100 | خادم MCP (79 أداة) |
| وكيل المتصفح | 13000 | أتمتة متصفح headless |
| وكيل SSH | 12900 | وصول SSH إلى الأجهزة البعيدة |

## الخطوات التالية

- [تكامل MCP](/docs/mcp/what-is-mcp) — كيفية استخدام أدوات المتصفح عبر MCP
- [Computer Control API](/docs/api/computers) — لأتمتة الواجهة الرسومية على الأجهزة المسجّلة