CamoFox MCP
redf0x1/camofox-mcp
Automação web anti-detecção para agentes IA via MCP
Ver no GitHubServidor MCP para automação de navegador anti-detecção, permitindo que agentes IA naveguem, interajam e automatizem a web sem ser bloqueados. Oferece 53 ferramentas para navegação, interação, extração de dados, downloads e gerenciamento de sessões com suporte a múltiplas abas e persistência de cookies.
Instalação
npx convez-ai redf0x1/camofox-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Web scraping e extração de dados sem detecção
- Automação de tarefas web com navegadores em anti-detecção
- Teste de agentes IA em fluxos web complexos
- Integração de navegador headless em pipelines de automação
Veredito

CamoFox MCP é uma solução técnica robusta para automação web anti-detecção em ambientes MCP, com 53 ferramentas bem documentadas e suporte a Docker. Exige conhecimento prévio de MCP e setup dual (browser server + MCP server), sendo ideal para cenários de scraping e automação sensíveis a bloqueios.
README
A tradução para o português deste README ainda está na fila.
CamoFox MCP
AI-powered anti-detection browser automation for MCP-compatible AI agents.
CamoFox MCP connects MCP clients such as Claude Desktop, VS Code, Cursor, and OpenClaw to the CamoFox browser server. It gives agents a practical browser toolset for navigation, interaction, search, extraction, downloads, and session reuse while relying on Camoufox-based anti-detection behavior underneath.
Key Features
- 53 browser automation tools across navigation, interaction, observation, search, downloads, sessions, network capture, and batch workflows.
- Anti-detection browser automation built on top of the CamoFox browser server and Camoufox.
- Multi-tab workflows with tracked state, history, and cleanup.
- Session persistence with cookie import, saved profiles, and optional auto-save.
- Token-efficient accessibility snapshots with CSS-selector fallbacks for difficult SPA flows.
- OpenClaw-compatible HTTP transport, plus standard stdio support for desktop MCP clients.
Quick Install
You need both components running:
camofox-browserhandles the anti-detection browser.camofox-mcpexposes that browser to your MCP client.
Option A: npx + stdio
Start the browser server:
npx camofox-browser@latest
Add CamoFox MCP to your MCP client:
{
"servers": {
"camofox": {
"type": "stdio",
"command": "npx",
"args": ["-y", "camofox-mcp@latest"],
"env": {
"CAMOFOX_URL": "http://localhost:9377"
}
}
}
}
Option B: Docker
Start the browser server:
docker run -d -p 9377:9377 --name camofox-browser ghcr.io/redf0x1/camofox-browser:latest
Run CamoFox MCP in HTTP mode for remote MCP clients such as OpenClaw:
docker run -p 3000:8080 --rm \
-e CAMOFOX_TRANSPORT=http \
-e CAMOFOX_HTTP_HOST=0.0.0.0 \
-e CAMOFOX_HTTP_API_KEY=replace-with-32-plus-random-chars \
-e CAMOFOX_URL=http://host.docker.internal:9377 \
ghcr.io/redf0x1/camofox-mcp:latest node dist/http.js
Configure your HTTP MCP client to connect to http://localhost:3000/mcp with
Authorization: Bearer replace-with-32-plus-random-chars.
Full client configuration examples live in docs/getting-started.md.
Quick Verify
Use camofox-browser 2.4.7 or newer. Browser 2.4.7 adds the supported Windows x64 headless portable distribution and hardens session-scoped navigation recovery without changing the MCP-facing REST request shapes used here. Browser 2.4.6 pins the Camoufox-compatible Playwright protocol dependency for fresh installs, 2.4.5 adds explicit browser auth modes including CAMOFOX_AUTH_MODE=disabled for trusted private agent networks, and 2.4.4 fixes the persistent-context cold-start about:blank page reuse path.
Verify the browser server is reachable:
curl -fsS http://localhost:9377/health
Expected response includes "ok":true and "running":true.
On a cold server with no active tabs yet, browserConnected can be false; create a tab to start a browser session.
Tool Categories
| Category | Tool count | Docs |
|---|---|---|
| Health | 1 | Health |
| Tabs | 3 | Tabs |
| Navigation | 4 | Navigation |
| Interaction | 8 | Interaction |
| Observation | 8 | Observation |
| Search | 1 | Search |
| Session | 4 | Session |
| Profiles | 4 | Profiles |
| Downloads | 3 | Downloads |
| Extraction | 4 | Extraction |
| Batch workflows | 6 | Batch |
| Presets | 1 | Presets |
| Network capture | 6 | Network capture |
Network capture
Network capture requires camofox-browser 2.5.0 or newer. Older compatible browser versions remain usable for ordinary tools without networkCapture.
Use create_tab with networkCapture: {} to record metadata from the initial navigation. For a session-wide capture, set networkCapture.scope to session, then reuse the returned session key and pass the capture key as networkCapture.joinKey when creating additional tabs. To start recording later, create the tab with networkCapture.start set to false and call network_capture_start.
Use network_list_requests with nextCursor as the next after value, and network_get_response for one request's metadata. Call network_capture_stop before network_export_har for a stable export. Keep an enrolled tab open until the export finishes.
If the browser enables body capture, set networkCapture.captureBodies to true at creation and use includeBody: true with network_get_response.
Use network_intercept to replace exact-match fetch/XHR abort or static mock rules on an active tab capture. The browser operator must configure CAMOFOX_API_KEY and enable CAMOFOX_NETWORK_INTERCEPTION=true.
See the network tool reference for all six tools, opt-in settings, and interception limits.
The browser server must advertise network capture support. The networkKey returned by create_tab grants access to that capture and may appear in tool transcripts. Keep it private, and avoid forwarding capture results to untrusted recipients. Exports may contain application-specific URL paths.
Top Limitations
- CamoFox MCP is not a standalone browser. You must run a compatible
camofox-browserserver separately. - MCP can share the camofox CLI default browser profile/context when
create_tabusesuserId: "cli-default"andsessionKey: "default", but it cannot reliably attach to a tab the CLI already opened. Importing/adopting existing CLI tabs is a future feature. - Headed browser window size follows browser viewport/display-size behavior. Pass
viewport, for example{ "width": 1366, "height": 768 }, or setCAMOFOX_VIEWPORT=1366x768/--viewport 1366x768for a default new-tab size. Supported defaults use width320..3840and height240..2160. - On Windows x64,
camofox-browser2.4.7 supports the portable distribution inheadless=truemode. Headed and virtual-display modes remain unsupported on Windows;toggle_displaywill reject those modes there. - Accessibility-tree refs are the primary interaction model, but SPA and custom-component sites can require CSS selectors or rendered HTML tools.
- If the browser server enforces authentication, API-key-gated operations need the same
CAMOFOX_API_KEYon both sides. - For trusted private-network browser deployments using
CAMOFOX_AUTH_MODE=disabled, leaveCAMOFOX_API_KEYunset in CamoFox MCP. MCP then sends no outbound browser auth headers. Keep both browser and MCP access on a trusted private network. - If HTTP transport is exposed beyond loopback, set
CAMOFOX_HTTP_API_KEYand require clients to send it as a Bearer token. - HTTP transport is mainly for remote MCP clients. Desktop MCP clients usually work best with stdio configuration.
Security
Treat this as a browser control surface. In shared or networked environments, isolate the browser server, avoid exposing MCP endpoints broadly, and use CAMOFOX_HTTP_API_KEY for inbound HTTP MCP clients plus CAMOFOX_API_KEY when the browser server requires authentication. If the browser server runs CAMOFOX_AUTH_MODE=disabled, leave CAMOFOX_API_KEY unset and keep that browser endpoint on a trusted private network. Session profiles can contain sensitive cookies and should be stored accordingly.
Documentation
Start at docs/README.md for the documentation hub, then use docs/getting-started.md for setup, verification, and first workflow examples.
Contributing + License
See CONTRIBUTING.md for contribution guidelines, SECURITY.md for private vulnerability reporting, and LICENSE for the MIT license.
Custom search engines
Set CAMOFOX_SEARCH_URL_TEMPLATE in the MCP server environment, for example
https://search.example/search?q={query}&language=en, then call
web_search({ tabId: "tab_123", query: "café & tea", engine: "custom" }).
For SearXNG, use your instance's /search?q={query} URL. Restart MCP after changing
its environment. Google remains the default; the 14 browser macros are unchanged.
The template must be an absolute HTTP(S) URL with exactly one literal {query}
in its path or query, never its host, credentials, or fragment. Credentials in URLs
are rejected. The query is percent-encoded once, including Unicode and &.
Invalid configuration fails startup without reflecting the URL or its tokens;
custom without configuration returns an actionable error (no fallback).
Custom search uses ordinary browser navigate, then snapshot, not a new macro
or a direct MCP HTTP fetch to the search engine. Browser URL validation and existing
private-network/SSRF policy remain authoritative, including redirects. Self-hosted
or private SearXNG requires the browser's existing network policy to allow it;
this setting does not grant access or weaken that policy. Do not store secrets
in search URLs: navigated URLs can appear in tool output, browser history and logs.