Skip to content
Back to search

camoufox-cli

MarketplaceWorks with Claude CodeGitHub

Anti-detect browser automation CLI & Skills for AI agents — Camoufox-powered fingerprint spoofing, no bot-detectable Playwright leaks

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bin-huang--camoufox-cli/badge.svg)](/listings/bin-huang--camoufox-cli)

HTML

<a href="/listings/bin-huang--camoufox-cli"><img src="/api/listings/bin-huang--camoufox-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Tell your AI agent (e.g. OpenClaw):

> Install this CLI and skills from https://github.com/Bin-Huang/camoufox-cli

Or install manually:

npm install -g camoufox-cli      # Requires Node.js 20.10+
camoufox-cli install              # Download browser

Or with pip:

pipx install camoufox-cli
camoufox-cli install              # Download browser

On Linux, install system dependencies with:

camoufox-cli install --with-deps

The browser is downloaded from GitHub releases. If the anonymous GitHub API rate limit is exhausted (common on shared server/CI IPs), the installer automatically falls back to scraping github.com release pages.

Agent Skill

# Add skills for AI agents (Claude Code, Cursor, Codex, etc.)
npx skills add Bin-Huang/camoufox-cli

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "camoufox-cli",
  3. "owner": {
  4. "name": "Benn Huang"
  5. },
  6. "metadata": {
  7. "description": "Anti-detect browser automation CLI & Skills for AI agents, powered by Camoufox",
  8. "version": "0.1.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "camoufox-cli",
  13. "description": "Anti-detect browser automation skill with fingerprint spoofing for AI agents",
  14. "source": "./",
  15. "skills": [
  16. "./skills/camoufox-cli"
  17. ]
  18. }
  19. ]
  20. }
README.md · README · 302 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # camoufox-cli
  2. [![npm](https://img.shields.io/npm/v/camoufox-cli)](https://www.npmjs.com/package/camoufox-cli)
  3. [![PyPI](https://img.shields.io/pypi/v/camoufox-cli)](https://pypi.org/project/camoufox-cli/)
  4. [![npm downloads](https://img.shields.io/npm/dm/camoufox-cli)](https://www.npmjs.com/package/camoufox-cli)
  5. [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  6. Anti-detect browser CLI & Skills for AI agents, powered by [Camoufox](https://github.com/daijro/camoufox).
  7. Playwright and Puppeteer leak that they're automated — headless flags, canvas and
  8. WebGL fingerprints, missing fonts, mismatched screen metrics. Camoufox patches those
  9. at the C++ level, so the browser itself looks like a normal Firefox install.
  10. That's the fingerprint layer only. Detection that keys on IP reputation, request rate,
  11. or behavior still applies — pair it with `--proxy` and sane pacing.
  12. ```bash
  13. camoufox-cli open https://example.com # Launch browser & navigate
  14. camoufox-cli snapshot -i # Interactive elements only
  15. # - link "More information..." [ref=e1]
  16. camoufox-cli click @e1 # Click by ref
  17. camoufox-cli close # Done
  18. ```
  19. ### Highlights
  20. - C++-level fingerprint spoofing via Camoufox (canvas, WebGL, audio, screen metrics, fonts)
  21. - Persistent identities: stable fingerprint, OS, and locale across launches with `--persistent`
  22. - Accessibility-tree snapshots with `@ref` element targeting
  23. - Session isolation with cookie import/export
  24. - Shell commands, no code generation
  25. ### Works with
  26. OpenClaw, Claude Code, Cursor, Codex, and any agent that can run shell commands.
  27. ## Install
  28. Tell your AI agent (e.g. OpenClaw):
  29. > Install this CLI and skills from https://github.com/Bin-Huang/camoufox-cli
  30. Or install manually:
  31. ```bash
  32. npm install -g camoufox-cli # Requires Node.js 20.10+
  33. camoufox-cli install # Download browser
  34. ```
  35. Or with pip:
  36. ```bash
  37. pipx install camoufox-cli
  38. camoufox-cli install # Download browser
  39. ```
  40. On Linux, install system dependencies with:
  41. ```bash
  42. camoufox-cli install --with-deps
  43. ```
  44. The browser is downloaded from GitHub releases. If the anonymous GitHub API
  45. rate limit is exhausted (common on shared server/CI IPs), the installer
  46. automatically falls back to scraping github.com release pages.
  47. ### Agent Skill
  48. ```bash
  49. # Add skills for AI agents (Claude Code, Cursor, Codex, etc.)
  50. npx skills add Bin-Huang/camoufox-cli
  51. ```
  52. The skill is a short entry file. It tells the agent to run `camoufox-cli skill`,
  53. which prints the usage guide that ships with the installed CLI. The agent always
  54. reads the guide for the CLI version on the machine, so you do not need to
  55. reinstall the skill after you upgrade camoufox-cli. If you installed the skill
  56. before `camoufox-cli skill` existed, update it once (`npx skills update`, or run
  57. `npx skills add` again) to get the short entry file.
  58. ```bash
  59. camoufox-cli skill # Usage guide for this version
  60. camoufox-cli skill commands # Full command reference
  61. camoufox-cli skill snapshot-refs # How snapshots and refs work
  62. ```
  63. ## Commands
  64. ### Navigation
  65. ```bash
  66. camoufox-cli open <url> # Navigate to URL (starts daemon if needed)
  67. camoufox-cli back # Go back
  68. camoufox-cli forward # Go forward
  69. camoufox-cli reload # Reload page
  70. camoufox-cli url # Print current URL
  71. camoufox-cli title # Print page title
  72. camoufox-cli close # Close your tab (browser exits when the last tab closes)
  73. ```
  74. ### Snapshot
  75. ```bash
  76. camoufox-cli snapshot # Full accessibility tree
  77. camoufox-cli snapshot -i # Interactive elements only
  78. camoufox-cli snapshot -s "css-selector" # Scoped to CSS selector
  79. ```
  80. Output format:
  81. ```
  82. - heading "Example Domain" [level=1] [ref=e1]
  83. - paragraph [ref=e2]
  84. - link "More information..." [ref=e3]
  85. ```
  86. ### Interaction
  87. ```bash
  88. camoufox-cli click @e1 # Click element
  89. camoufox-cli fill @e3 "search query" # Clear + type into input
  90. camoufox-cli type @e3 "append text" # Type without clearing
  91. camoufox-cli select @e5 "option text" # Select dropdown option
  92. camoufox-cli check @e6 # Toggle checkbox
  93. camoufox-cli hover @e2 # Hover over element
  94. camoufox-cli mouse click 660 380 # Click at viewport coordinates
  95. camoufox-cli press Enter # Press keyboard key
  96. camoufox-cli press "Control+a" # Key combination
  97. ```
  98. `mouse click` reaches elements that have no ref, such as a checkbox inside a
  99. cross-origin iframe (for example a Cloudflare Turnstile widget). Coordinates are
  100. viewport CSS pixels. At the default `devicePixelRatio` of 1, they equal the pixels
  101. of a non-`--full` screenshot.
  102. ### Data Extraction
  103. ```bash
  104. camoufox-cli text @e1 # Get text content of element
  105. camoufox-cli text body # Get all page text
  106. camoufox-cli eval "document.title" # Execute JavaScript
  107. camoufox-cli screenshot # Screenshot (JSON with base64)
  108. camoufox-cli screenshot page.png # Screenshot to file
  109. camoufox-cli screenshot --full page.png # Full page screenshot
  110. ```
  111. ### Scroll & Wait
  112. ```bash
  113. camoufox-cli scroll down # Scroll down 500px
  114. camoufox-cli scroll up 1000 # Scroll up 1000px
  115. camoufox-cli wait 2000 # Wait milliseconds
  116. camoufox-cli wait @e1 # Wait for element to appear
  117. camoufox-cli wait --url "*/dashboard" # Wait for URL pattern
  118. ```
  119. ### Tabs
  120. ```bash
  121. camoufox-cli tabs # List open tabs (with owner names)
  122. camoufox-cli switch 2 # Switch to tab by index
  123. ```
  124. Named tabs let concurrent agents share one browser — same fingerprint, same cookies/login state — while each keeps its own page, element refs, and history. Tabs share one browser process (commands from different tabs may queue behind a slow one); separate sessions run as independent processes in parallel:
  125. ```bash
  126. camoufox-cli --tab inbox-scan-x4q open https://app.example.com/a
  127. camoufox-cli --tab report-pull-9kf open https://app.example.com/b
  128. camoufox-cli --tab inbox-scan-x4q snapshot -i # refs are per tab
  129. camoufox-cli --tab inbox-scan-x4q close # frees only this tab; browser exits when the last tab closes
  130. ```
  131. Tab names must be unique per agent (nothing enforces this): use a task slug plus a short shell-generated random suffix (e.g. `price-scan-$(openssl rand -hex 2)`), chosen once and reused.
  132. ### Sessions
  133. Each named session is a separate browser process with its own randomly-generated fingerprint and its own cookies. Use sessions for isolated identities, named tabs (above) for cheap parallelism under one identity. For real multi-account isolation, combine sessions with a per-session proxy (config file) and `--persistent` — see Persistent Identity below:
  134. ```bash
  135. camoufox-cli sessions # List active sessions
  136. camoufox-cli --session work open <url> # Use named session
  137. camoufox-cli close --all # Force-close all sessions
  138. ```
  139. ### Cookies
  140. ```bash
  141. camoufox-cli cookies # Dump cookies as JSON
  142. camoufox-cli cookies import file.json # Import cookies
  143. camoufox-cli cookies export file.json # Export cookies
  144. ```
  145. ## Flags
  146. ```
  147. --session <name> Named session (default: "default")
  148. --tab <name> Named tab within the session's shared browser: same fingerprint and
  149. cookies/login, independent page/refs/history (default: "default")
  150. --headed Show browser window (default: headless)
  151. --timeout <seconds> Daemon idle timeout (default: 1800)
  152. --json Output as JSON
  153. --persistent [path] Persistent identity (see below); default path: ~/.camoufox-cli/profiles/<session>
  154. --proxy <url> Proxy server (http:// or https://; auth: http://user:pass@host:port)
  155. --no-geoip Disable automatic GeoIP spoofing (auto-enabled with --proxy)
  156. --locale <tag> Force browser locale (e.g. "en-US" or "en-US,zh-CN")
  157. --version Print version and exit
  158. ```
  159. ## Config File
  160. Tired of repeating the same flags on every call? Put defaults in `~/.camoufox-cli/config.json` (override the path with `$CAMOUFOX_CLI_CONFIG`):
  161. ```json
  162. {
  163. "default": {
  164. "persistent": true,
  165. "timeout": 3600,
  166. "proxy": "http://user:pass@host:8080"
  167. },
  168. "sessions": {
  169. "<your-session-name>": {
  170. "proxy": "http://user:pass@proxy.example.com:8080",
  171. "locale": "zh-CN"
  172. }
  173. }
  174. }
  175. ```
  176. - **`default`** applies to every session.
  177. - **`sessions` is optional.** You never pre-register sessions — the name is just whatever you pass to `--session`. A `sessions.<name>` block only kicks in when you happen to run `--session <name>`, layering its keys on top of `default`; any other session (or no `--session` at all) just uses `default`. Above, `camoufox-cli --session <your-session-name> open <url>` swaps in that block's proxy + locale, while every other session keeps the `default` proxy.
  178. - **Command-line flags always win** over the file, which in turn wins over built-in defaults.
  179. - Settable keys: `proxy`, `locale`, `geoip`, `persistent` (`true` / `false` / path string), `headed`, `timeout`, `json`. `session` is command-line only (it selects which block to apply), and per-command options like `--full` or `-i` are never read from config.
  180. - A broken config never blocks a command — it's ignored with a warning on stderr.
  181. - Config is read when a session's daemon **first launches**. If one is already running for that session, run `camoufox-cli --session <name> close` first for changes to take effect.
  182. ## Persistent Identity
  183. Without `--persistent`, every launch gets a fresh random fingerprint. With `--persistent`, a `camoufox-cli.json` file is written next to the browser's user data. Fingerprint, OS, and canvas/font seeds are generated on the first launch and frozen afterwards; locale and proxy-derived timezone/geolocation are also saved but track whatever you pass on the command line. Every subsequent launch with the same path reloads the identity, so sites see the same device on every visit.
  184. ```bash
  185. # First launch: generates + stores identity
  186. camoufox-cli --persistent ~/.camoufox-cli/profiles/alice open https://example.com
  187. # Every subsequent launch: same fingerprint, same cookies, same device
  188. camoufox-cli --persistent ~/.camoufox-cli/profiles/alice open https://example.com
  189. ```
  190. **Frozen** — generated on the first launch, permanent until the directory is deleted:
  191. - Fingerprint (UA, canvas, WebGL, fonts, navigator properties)
  192. - OS (defaults to host OS)
  193. - Canvas/font noise seeds
  194. **Persisted** — stored in the file, refreshed whenever you pass the flag:
  195. - `--locale`: sets the stored locale; pass it again to change it, omit it to keep the stored value.
  196. - Timezone / geolocation: re-derived from the current proxy's IP whenever `--proxy` is active (and `--no-geoip` isn't set), then written back. Without a proxy, the last stored values stay in effect.
  197. **Per-launch** — never stored; pass on every launch for it to apply:
  198. - `--proxy`: proxies rotate or expire; re-specify each launch to avoid silently running through a stale one.
  199. - `--no-geoip`: follows the current `--proxy`.
  200. **Multiple identities in parallel.** Each persistent path is a distinct identity. Combine with `--session` for concurrent daemons:
  201. ```bash
  202. camoufox-cli --session a --persistent ~/.camoufox-cli/profiles/alice open https://...
  203. camoufox-cli --session b --persistent ~/.camoufox-cli/profiles/bob open https://...
  204. ```
  205. **Resetting an identity.** Just delete the directory (`rm -rf ~/.camoufox-cli/profiles/alice`). The next launch generates a fresh one.
  206. ## Architecture
  207. ```
  208. CLI (camoufox-cli) ──Unix socket──▶ Daemon (Python / Node) ──Playwright──▶ Camoufox (Firefox)
  209. ```
  210. The CLI sends JSON commands to a long-running daemon process via Unix socket. The daemon manages the Camoufox browser instance and maintains the ref registry between commands. The daemon auto-starts on the first command and auto-stops after 30 minutes of inactivity.
  211. ## Related
  212. - [google-analytics-cli](https://github.com/Bin-Huang/google-analytics-cli) -- Google Analytics CLI & Skills for AI agents (and humans)
  213. - [google-search-console-cli](https://github.com/Bin-Huang/google-search-console-cli) -- Google Search Console CLI & Skills for AI agents (and humans)
  214. - [youtube-analytics-cli](https://github.com/Bin-Huang/youtube-analytics-cli) -- YouTube Analytics CLI & Skills for AI agents (and humans)
  215. - [x-analytics-cli](https://github.com/Bin-Huang/x-analytics-cli) -- X Analytics CLI & Skills for AI agents (and humans)
  216. - [google-ads-open-cli](https://github.com/Bin-Huang/google-ads-open-cli) -- Google Ads CLI & Skills for AI agents (and humans)
  217. - [meta-ads-open-cli](https://github.com/Bin-Huang/meta-ads-open-cli) -- Meta Ads CLI & Skills for AI agents (and humans)
  218. - [microsoft-ads-cli](https://github.com/Bin-Huang/microsoft-ads-cli) -- Microsoft Ads CLI & Skills for AI agents (and humans)
  219. - [amazon-ads-open-cli](https://github.com/Bin-Huang/amazon-ads-open-cli) -- Amazon Ads CLI & Skills for AI agents (and humans)
  220. - [tiktok-ads-cli](https://github.com/Bin-Huang/tiktok-ads-cli) -- TikTok Ads CLI & Skills for AI agents (and humans)
  221. - [linkedin-ads-cli](https://github.com/Bin-Huang/linkedin-ads-cli) -- LinkedIn Ads CLI & Skills for AI agents (and humans)
  222. - [x-ads-cli](https://github.com/Bin-Huang/x-ads-cli) -- X Ads CLI & Skills for AI agents (and humans)
  223. - [snapchat-ads-cli](https://github.com/Bin-Huang/snapchat-ads-cli) -- Snapchat Ads CLI & Skills for AI agents (and humans)
  224. - [pinterest-ads-cli](https://github.com/Bin-Huang/pinterest-ads-cli) -- Pinterest Ads CLI & Skills for AI agents (and humans)
  225. - [reddit-ads-cli](https://github.com/Bin-Huang/reddit-ads-cli) -- Reddit Ads CLI & Skills for AI agents (and humans)
  226. - [spotify-ads-cli](https://github.com/Bin-Huang/spotify-ads-cli) -- Spotify Ads CLI & Skills for AI agents (and humans)
  227. - [apple-ads-cli](https://github.com/Bin-Huang/apple-ads-cli) -- Apple Ads CLI & Skills for AI agents (and humans)
  228. ## License
  229. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.