.env.example

# API
# HTTP API port.
PORT=8191

# Model Context Protocol (MCP) scraping tool. Keep disabled on public networks.
MCP_ENABLED=false
# Comma-separated browser origins allowed to call /mcp. Requests without Origin
# (normal server-to-server clients) are accepted.
MCP_ALLOWED_ORIGINS=

# Browser pool
# Number of warm browser instances.
BROWSER_POOL_SIZE=1
# Time to wait for a free browser before rejecting a request.
BROWSER_ACQUIRE_TIMEOUT_MS=15000
# Recycle a browser after this many temporary challenge contexts. Set 0 to disable.
BROWSER_RECYCLE_AFTER_CONTEXTS=8
# Maximum Firefox content processes per browser.
BROWSER_MAX_CONTENT_PROCESSES=2
# Browsers in the headful sub-pool, used only for DataDome escalations. Warmed on first use
# and additional to BROWSER_POOL_SIZE (~380 MB each). Set 1 to scrape DataDome targets.
BROWSER_HEADFUL_POOL_SIZE=0
# Grace period after a request timeout before a checked-out browser is reclaimed.
BROWSER_STALL_TIMEOUT_MS=180000
# Maximum time to wait while closing a wedged browser or context.
BROWSER_CLOSE_TIMEOUT_MS=10000
# Maximum time to wait for a browser launch.
BROWSER_LAUNCH_TIMEOUT_MS=90000
# Optional viewport screenshots (browser tiers only)
SCREENSHOT_SETTLE_MS=3000
SCREENSHOT_TIMEOUT_MS=10000
SCREENSHOT_JPEG_QUALITY=60
SCREENSHOT_MAX_BYTES=4000000

# Optional console and network diagnostics (browser tiers only)
DIAGNOSTICS_MAX_CONSOLE_ENTRIES=500
DIAGNOSTICS_MAX_NETWORK_ENTRIES=1000
DIAGNOSTICS_MAX_STRING_CHARS=2000
DIAGNOSTICS_MAX_TOTAL_CHARS=1000000
DIAGNOSTICS_SIZE_TIMEOUT_MS=2000

# Optional main-document redirect chain (browser tiers only)
REDIRECT_MAX_ENTRIES=50
REDIRECT_MAX_URL_CHARS=2000
REDIRECT_MAX_TOTAL_CHARS=1000000

# Optional matched response-body capture (browser tiers only)
CAPTURE_MAX_PATTERNS=10
CAPTURE_MAX_RESPONSES=5
CAPTURE_MAX_BODY_BYTES=5242880
CAPTURE_MAX_TOTAL_BYTES=10485760
CAPTURE_MAX_READ_BYTES=10485760
CAPTURE_MAX_METADATA_CHARS=2000
CAPTURE_BODY_TIMEOUT_MS=5000
CAPTURE_SETTLE_MS=15000
CAPTURE_MAX_SETTLE_MS=60000
CAPTURE_IDLE_FLOOR_MS=5000

# Sessions
# Redis stores solved cookies and browser sessions. Leave empty to disable the cache.
REDIS_URL=redis://localhost:6379
# Lifetime of Redis-cached sessions in seconds.
REDIS_SESSION_TTL_SECONDS=3600
# Maximum time for each Redis connection attempt.
REDIS_CONNECT_TIMEOUT_MS=5000
# Delay between background reconnect attempts. Set 0 to disable retry.
REDIS_RETRY_DELAY_MS=5000

# Upstream proxies
# Tier 3 datacenter proxy: HTTP, authenticated HTTP, or SOCKS5.
# Examples:
# PROXY_URL=http://proxy.example.com:8080
# PROXY_URL=http://user:pass@proxy.example.com:8080
# PROXY_URL=socks5://proxy.example.com:1080
# Separate multiple endpoints with commas to create a pool.
PROXY_URL=
# Optional file with one proxy URL per line.
PROXY_LIST_FILE=
# Tier 4 residential proxy. Uses the same URL and pool formats.
# Examples:
# RESIDENTIAL_PROXY_URL=http://user:pass@residential.example.com:8080
# RESIDENTIAL_PROXY_URL=socks5://residential.example.com:1080
RESIDENTIAL_PROXY_URL=
# Optional file with one residential proxy URL per line.
RESIDENTIAL_PROXY_LIST_FILE=

# HTTP/HTTPS challenge-bypassing proxy
# Enables the general proxy listener.
MITM_ENABLED=false
# Proxy address and port. Use 127.0.0.1 for local-only access.
MITM_HOST=0.0.0.0
MITM_PORT=8192
# Persistent directory for the generated CA certificate and key.
MITM_CA_DIR=/data/proxy-ca
# Highest allowed escalation tier. Leave empty to allow Tier 4.
MITM_MAX_TIER=
# Skip the direct Tier 0 probe and route requests through the scraper. Disables Tier 0 streaming.
MITM_ALWAYS_SCRAPE=false
# Logs proxied requests. Errors are always logged.
MITM_DEBUG=false

# CAPTCHA audio
# Optional Whisper-compatible speech-to-text endpoint.
STT_URL=
# Optional API key sent to the speech-to-text endpoint.
STT_API_KEY=
# Optional ffmpeg executable override used for audio conversion.
FFMPEG_PATH=