{"title":"Proxy navigateur","slug":"browser","category":"api","summary":"Service d'automatisation de navigateur — conteneur Docker distinct sur le port 13000 pour le contrôle de navigateur headless.","audience":["human","llm"],"tags":["api","browser","automation","playwright"],"difficulty":"advanced","updated":"2026-06-27","word_count":242,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Proxy navigateur\n\nLe Proxy navigateur est un **service Docker distinct** qui fournit de l'automatisation\nde navigateur headless via Playwright. Il ne fait PAS partie intégrante de l'API Synapse —\nles endpoints Synapse n'incluent pas les chemins `/browser/*`.\n\n## Architecture\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## Méthodes d'accès\n\n### Méthode 1 : via le serveur MCP Synapse (recommandé)\n\nLe serveur MCP Synapse expose les outils navigateur en tant qu'outils MCP. Utilisez\ncette méthode pour l'automatisation de navigateur pilotée par LLM :\n\n```json\n// Configuration 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\nOutils MCP navigateur disponibles :\n\n- `browser_new` — ouvrir un nouvel onglet de navigateur\n- `browser_navigate` — naviguer vers une URL\n- `browser_click` — cliquer sur un élément\n- `browser_type` — saisir du texte dans un champ\n- `browser_screenshot` — capturer une capture d'écran\n- `browser_close` — fermer l'onglet\n- (et plus — voir [Intégration MCP](/docs/mcp/what-is-mcp))\n\n### Méthode 2 : accès direct au Proxy navigateur\n\nPour les intégrations hors MCP, connectez-vous directement au service browser-proxy :\n\n```bash\n# Vérification de santé\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Ouvrir une 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## Cas d'usage courants\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### Automatisation de formulaires\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### Capture d'écran\n\n```python\n# Via MCP\n\"Take a screenshot of https://example.com and save it.\"\n```\n\n## Services associés\n\n| Service | Port | Rôle |\n|---------|------|---------|\n| Synapse API | 12800 | Memory, chat, tasks |\n| Synapse MCP | 13100 | Serveur MCP (79 outils) |\n| Proxy navigateur | 13000 | Automatisation de navigateur headless |\n| Proxy SSH | 12900 | Accès SSH aux machines distantes |\n\n## Prochaines étapes\n\n- [Intégration MCP](/docs/mcp/what-is-mcp) — comment utiliser les outils navigateur via MCP\n- [API Computer Control](/docs/api/computers) — pour l'automatisation d'interface graphique sur machines enregistrées\n","content_html":"

Proxy navigateur

\n

Le Proxy navigateur est un service Docker distinct qui fournit de l'automatisation\nde navigateur headless via Playwright. Il ne fait PAS partie intégrante de l'API Synapse —\nles endpoints Synapse n'incluent pas les chemins /browser/*.

\n

Architecture

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

Méthodes d'accès

\n

Méthode 1 : via le serveur MCP Synapse (recommandé)

\n

Le serveur MCP Synapse expose les outils navigateur en tant qu'outils MCP. Utilisez\ncette méthode pour l'automatisation de navigateur pilotée par LLM :

\n
// Configuration 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}

Outils MCP navigateur disponibles :

\n\n

Méthode 2 : accès direct au Proxy navigateur

\n

Pour les intégrations hors MCP, connectez-vous directement au service browser-proxy :

\n
# Vérification de santé\ncurl http://browser-proxy.schaefer.zone:13000/health\n\n# Ouvrir une page\ncurl -X POST http://browser-proxy.schaefer.zone:13000/navigate \\\n  -H "Content-Type: application/json" \\\n  -d '{"url": "https://example.com"}'

Cas d'usage courants

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

Automatisation de formulaires

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

Capture d'écran

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

Services associés

\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
ServicePortRôle
Synapse API12800Memory, chat, tasks
Synapse MCP13100Serveur MCP (79 outils)
Proxy navigateur13000Automatisation de navigateur headless
Proxy SSH12900Accès SSH aux machines distantes
\n

Prochaines étapes

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