Skill

CamoFox MCP Skill

CamoFox MCP gives OpenClaw agents a production-ready anti-detection browser automation toolkit over MCP HTTP transport. It connects OpenClaw to CamoFox Browser so agents can browse, click, type, extract content, manage cookies/sessions, run stealth search workflows, and download resources without the high block rates common with standard automation stacks.

Why this skill exists

Most browser automation flows eventually hit CAPTCHAs, fingerprint checks, or bot detection. CamoFox is purpose-built for that reality:

• Anti-detection fingerprinting per tab/session
• Better resilience on sites that aggressively detect automation
• Token-efficient accessibility snapshots for agent reasoning
• Session persistence via cookie/profile tools
• Built-in search macros across 14 engines

Setup

1) Start CamoFox Browser

CamoFox Browser must be running first (default http://localhost:9377). Use camofox-browser 2.4.7 or newer. Browser 2.4.7 adds supported Windows x64 headless portable use and session-scoped navigation recovery; browser 2.4.6 pins the Camoufox-compatible Playwright protocol dependency, 2.4.5 introduced explicit browser auth modes, and 2.4.4 fixed first-tab reuse for persistent contexts.

2) Start CamoFox MCP in HTTP mode

CAMOFOX_TRANSPORT=http npx camofox-mcp@1.15.0

Optional examples:

CAMOFOX_TRANSPORT=http CAMOFOX_API_KEY=browser-server-key npx camofox-mcp@1.15.0
CAMOFOX_TRANSPORT=http CAMOFOX_HTTP_HOST=0.0.0.0 CAMOFOX_HTTP_API_KEY=replace-with-32-plus-random-chars npx camofox-mcp@1.15.0
CAMOFOX_TRANSPORT=http CAMOFOX_HTTP_PORT=8080 npx camofox-mcp@1.15.0
CAMOFOX_VIEWPORT=1366x768 npx camofox-mcp@1.15.0

For browser CAMOFOX_AUTH_MODE=disabled on a trusted private agent network, leave CAMOFOX_API_KEY unset in CamoFox MCP so it sends no browser auth headers. Keep that browser endpoint private.

CAMOFOX_VIEWPORT and --viewport set the default viewport for new tabs when create_tab does not provide an explicit viewport. Use WIDTHxHEIGHT format; width must be 320..3840 and height must be 240..2160.

3) Configure OpenClaw

Add this MCP server:

{
  "mcpServers": {
    "camofox": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Alternative skill-generation flow:

npx @filiksyos/mcptoskill http://localhost:3000/mcp

Trigger phrases

Use this skill when the user asks for tasks like:

• “Browse this site and extract the data”
• “Automate this login/search/form flow”
• “Use a stealth or anti-detection browser”
• “Take a snapshot and click/type through this workflow”
• “Collect all links/images/PDFs from this page section”
• “Persist session cookies and restore later”
• “Run web search in browser and summarize results”
• “Download files and return metadata/content”

Tool catalog (47 tools)

Health (1)

• server_status — Check CamoFox server health and browser connection. Call first to verify server is running. Returns version, browser status, and active tab count.

Tabs (3)

• create_tab — Create a new browser tab with anti-detection fingerprinting. Supports URL, user/session isolation, viewport/display size, geo overrides, proxyProfile/raw proxy, and geoMode. To share the camofox CLI default browser profile/context, pass userId: "cli-default" and sessionKey: "default"; this creates a tracked MCP tab in that context but does not attach to a CLI tab that is already open.
• close_tab — Close a browser tab and release resources. Always close tabs when done to free memory.
• list_tabs — List all open browser tabs with URLs and titles. Use to discover available tabs or verify tab state.

Navigation (4)

• navigate — Navigate a tab to a URL. Waits for page load. Use create_tab first, then navigate. Returns final URL (may differ due to redirects).
• go_back — Navigate backward in browser history (Back button). Returns new page URL.
• go_forward — Navigate forward in browser history (Forward button). Returns new page URL.
• refresh — Reload the current page. Useful when page state is stale or after changes.

Interaction (8)

• click — Click an element. Provide either ref (from snapshot) or CSS selector. Use snapshot first to discover element refs.
• type_text — Type text into an input field. Provide either a ref (from snapshot) or a CSS selector. Use ref when available; otherwise use selector when snapshot doesn't assign refs (common with combobox/autocomplete inputs). Call snapshot first to find target element.
• scroll — Scroll page up or down by pixel amount. Use to reveal content below the fold or navigate long pages.
• camofox_scroll_element — Scroll a specific container element (modal dialog, scrollable div, sidebar). Use when page-level scroll doesn't reach content inside modals or overflow containers. Returns scroll position metadata to track progress.
• camofox_evaluate_js — Execute JavaScript in the browser page context. Runs in isolated scope (invisible to page scripts — safe for anti-detection). Use for: extracting data not visible in accessibility snapshot, checking element properties, reading computed styles, manipulating DOM elements. Requires CAMOFOX_API_KEY only when browser-server authentication is enabled.
• camofox_hover — Hover over an element to trigger tooltips, dropdown menus, or hover states. Use ref from snapshot or CSS selector.
• camofox_wait_for — Wait for page to be fully ready (DOM loaded, network idle, framework hydration complete). Use after navigation or actions that trigger page changes.
• camofox_press_key — Press a keyboard key. Use after type_text to submit forms (Enter), navigate between elements (Tab), move through suggestions (ArrowDown/ArrowUp), or dismiss dialogs (Escape). Common keys: Enter, Tab, Escape, ArrowDown, ArrowUp, Backspace, Space.

Observation (8)

• snapshot — Get accessibility tree snapshot — the PRIMARY way to read page content. Returns element refs, roles, names and values. Token-efficient. Always prefer over screenshot. Element refs are used with click and type_text.
• screenshot — Take a viewport or full-page visual screenshot in base64 PNG. Set fullPage: true for the entire scrollable page. Use ONLY for visual verification (CSS, layout, proof). Prefer snapshot for most tasks — much more token-efficient.
• get_links — Get all hyperlinks on page with URLs and text. Useful for navigation discovery and site mapping.
• camofox_get_page_html — Get rendered HTML from the live DOM. Use when accessibility snapshots miss dynamic or custom component content.
• camofox_query_selector — Query a CSS selector in the live DOM and return element text, HTML, attributes, and visibility metadata.
• camofox_wait_for_text — Wait for specific text to appear on the page. Useful for waiting for search results, form submissions, or dynamic content loading.
• camofox_wait_for_selector — Wait for a CSS selector to appear in the live DOM. Useful for SPA and async-content workflows.
• youtube_transcript — Fetch a YouTube transcript without opening a browser tab.