camoufox

name	camoufox
description	Anti-detect stealth browser for scraping, automation and bypassing bot detection. Use when normal browser fails or gets blocked.
metadata	{"openclaw":{"emoji":"🦊","os":["linux"],"requires":{"bins":["python3"]}}}

Camoufox — Anti-Detect Stealth Browser

Camoufox is a Firefox-based anti-detect browser that spoofs fingerprints (OS, User-Agent, canvas, WebGL, fonts) to bypass bot detection systems like Cloudflare, DataDome, and reCAPTCHA. It uses Playwright under the hood.

When to use

• When the built-in Chromium browser gets blocked or detected by anti-bot systems
• When you need to scrape protected websites (Cloudflare-protected, login-required sites)
• When human-like browsing behavior is needed (mouse movements, realistic timing)
• When you need a spoofed fingerprint (e.g., appear as macOS Firefox user)

Quick Usage (Python)

Basic page fetch

python3 -c "
from camoufox.sync_api import Camoufox
with Camoufox(headless='virtual', humanize=True) as browser:
    page = browser.new_page()
    page.goto('https://example.com', timeout=30000)
    page.wait_for_load_state('networkidle')
    print(page.content())
"

Get page text content

python3 -c "
from camoufox.sync_api import Camoufox
with Camoufox(headless='virtual', humanize=True) as browser:
    page = browser.new_page()
    page.goto('https://example.com', timeout=30000)
    page.wait_for_load_state('networkidle')
    print(page.inner_text('body'))
"

Screenshot a page

python3 -c "
from camoufox.sync_api import Camoufox
with Camoufox(headless='virtual', humanize=True) as browser:
    page = browser.new_page()
    page.goto('https://example.com', timeout=30000)
    page.wait_for_load_state('networkidle')
    page.screenshot(path='/tmp/screenshot.png', full_page=True)
    print('Screenshot saved to /tmp/screenshot.png')
"

Fill form and click

python3 -c "
from camoufox.sync_api import Camoufox
with Camoufox(headless='virtual', humanize=True) as browser:
    page = browser.new_page()
    page.goto('https://example.com/login', timeout=30000)
    page.fill('input[name=username]', 'myuser')
    page.fill('input[name=password]', 'mypass')
    page.click('button[type=submit]')
    page.wait_for_load_state('networkidle')
    print(page.inner_text('body'))
"

Extract JSON from API endpoint

python3 -c "
import json
from camoufox.sync_api import Camoufox
with Camoufox(headless='virtual', humanize=True) as browser:
    page = browser.new_page()
    page.goto('https://api.example.com/data', timeout=30000)
    data = json.loads(page.inner_text('body'))
    print(json.dumps(data, indent=2, ensure_ascii=False))
"

Key Parameters

Parameter	Values	Description
headless	True, "virtual"	True=basic headless, "virtual"=Xvfb (more stealth, recommended)
humanize	True, False	Human-like mouse/keyboard behavior
geoip	True	Auto-detect and spoof geolocation based on IP
locale	"vi-VN"	Set browser locale
os	"windows", "macos", "linux"	Spoof operating system fingerprint (random if not set)

Advanced: Custom config

from camoufox.sync_api import Camoufox
with Camoufox(
    headless="virtual",
    humanize=True,
    geoip=True,
    os="windows",
    locale="vi-VN"
) as browser:
    page = browser.new_page()
    # ... your code

Important Notes

• Always use headless="virtual" for best anti-detect results on this server
• Always use humanize=True for realistic behavior
• Camoufox is slower than built-in Chromium — only use when stealth is needed
• Each session creates a fresh fingerprint (no persistent sessions)
• Max timeout recommended: 30000ms for page loads