browse-config: Camoufox Configuration Generator
Step 0: Ask what the user needs
Use AskUserQuestion to determine the goal. Offer these presets:
| Preset |
Description |
| Stealth browsing |
For scraping protected sites. Enables geoip, humanize, default OS fingerprint. |
| Fast scraping |
Minimal footprint. Blocks images, WebRTC, WebGL. Enables disk cache. |
| Google-safe |
For Google search without "unusual traffic" blocks. Enables geoip, humanize, random OS. |
| Custom |
Walk through each option group interactively. |
Preset defaults
Stealth browsing:
{
"geoip": true,
"humanize": true
}
Fast scraping:
{
"blockImages": true,
"blockWebrtc": true,
"blockWebgl": true,
"enableCache": true
}
Google-safe:
{
"geoip": true,
"humanize": true,
"os": ["windows", "macos", "linux"]
}
Step 1: Custom configuration (skip if preset chosen)
If the user chose "Custom", ask about each option group using AskUserQuestion. Present one group at a time.
Identity
os (string or array) -- target OS fingerprint: "windows", "macos", "linux", or an array for random selection
locale (string or array) -- browser locale, e.g. "en-US" or ["en-US", "en-GB"]
fingerprint (object) -- advanced fingerprint overrides (most users skip this)
Privacy
blockWebrtc (boolean) -- block WebRTC to prevent IP leaks
blockWebgl (boolean) -- block WebGL fingerprinting
blockImages (boolean) -- block image loading (also improves speed)
Performance
enableCache (boolean) -- enable browser disk cache
blockImages (boolean) -- already covered in Privacy, mention speed benefit here
Network
proxy (string or object) -- proxy URL like "http://user:pass@host:port" or {"server":"...","username":"...","password":"..."}
geoip (string or boolean) -- true to auto-derive from proxy IP, or a country code like "US"
Behavior
humanize (boolean or number) -- true for default human-like delays, or a number (0.5-2.0) to control speed
Advanced (offer only if user asks)
addons (string[]) -- Firefox addon paths to load
excludeAddons (string[]) -- built-in addons to skip
firefoxUserPrefs (Record) -- raw Firefox about:config preferences
args (string[]) -- extra browser launch arguments
fonts (string[]) -- custom font list
customFontsOnly (boolean) -- use only custom fonts
screen (object) -- {minWidth, maxWidth, minHeight, maxHeight}
window ([width, height]) -- fixed window size
ffVersion (number) -- target Firefox version
headless (boolean or "virtual") -- headless mode (not recommended for anti-detection)
mainWorldEval (boolean) -- enable main world JavaScript eval
executablePath (string) -- custom camoufox binary path
env (Record) -- environment variables for the browser process
virtualDisplay (string) -- virtual display config (Linux only)
disableCoop (boolean) -- disable Cross-Origin-Opener-Policy headers
debug (boolean) -- enable debug logging
Step 2: Ask where to save
Use AskUserQuestion with two options:
- browse.json -- adds a
"camoufox" section to the project's browse.json. Applied automatically whenever --runtime camoufox is used.
- Named profile -- saves to
.browse/camoufox-profiles/<name>.json. Used with --camoufox-profile <name>. Good for per-scenario configs (e.g. "google", "scrape", "stealth").
If the user picks a named profile, ask for the profile name.
Step 3: Generate and write the file
If browse.json
Read the existing browse.json first (if it exists). Merge the new camoufox key into it. Write the result:
{
"camoufox": {
"geoip": true,
"humanize": true
}
}
If named profile
Create the directory .browse/camoufox-profiles/ if needed. Write just the config object:
{
"geoip": true,
"humanize": true,
"os": "windows"
}
Step 4: Show usage
After writing the file, tell the user exactly how to use it.
If browse.json:
Run: browse --runtime camoufox goto <url>
The camoufox section is applied automatically.
If named profile:
Run: browse --runtime camoufox --camoufox-profile <name> goto <url>
Always note: "The --camoufox-profile flag only applies when starting a new server. If a server is already running, stop it first with browse stop."
All CamoufoxConfig options
All keys use camelCase in JSON. They are auto-mapped to snake_case for camoufox-js internally.
| Key |
Type |
Description |
os |
string or string[] |
Target OS fingerprint |
blockImages |
boolean |
Block image loading |
blockWebrtc |
boolean |
Block WebRTC |
blockWebgl |
boolean |
Block WebGL |
disableCoop |
boolean |
Disable COOP headers |
geoip |
string or boolean |
GeoIP spoofing (true or country code) |
humanize |
boolean or number |
Human-like delays (true or speed factor) |
locale |
string or string[] |
Browser locale |
addons |
string[] |
Firefox addon paths |
fonts |
string[] |
Custom fonts |
customFontsOnly |
boolean |
Only use custom fonts |
screen |
object |
Screen size range ({minWidth, maxWidth, minHeight, maxHeight}) |
window |
[number, number] |
Fixed window size |
fingerprint |
object |
Fingerprint overrides |
ffVersion |
number |
Firefox version |
headless |
boolean or "virtual" |
Headless mode |
mainWorldEval |
boolean |
Main world eval |
firefoxUserPrefs |
Record |
Firefox about:config prefs |
proxy |
string or object |
Proxy config |
enableCache |
boolean |
Enable disk cache |
debug |
boolean |
Debug logging |
excludeAddons |
string[] |
Addons to exclude |
executablePath |
string |
Custom browser path |
args |
string[] |
Extra browser args |
env |
Record |
Environment variables |
virtualDisplay |
string |
Virtual display (Linux) |
Guardrails
- Always use AskUserQuestion before generating config. Do not assume preferences.
- Use camelCase keys in all generated JSON (the CLI handles snake_case mapping).
- Never overwrite existing browse.json fields outside the
camoufox key.
- Never include proxy credentials in output shown to the user. Write them to the file only.
- Do not include options the user did not ask for or confirm, beyond the preset defaults.
1---
2name: browse-config
3version: 1.0.0
4description: |
5 Generate camoufox configuration for the `browse` CLI by INTERVIEW, not hand-edited JSON — an
6 AskUserQuestion-guided flow that turns a chosen preset (stealth, fast-scraping, Google-safe, or a
7 fully custom walkthrough) into a valid `browse.json` camoufox section or a named
8 `.browse/camoufox-profiles/<name>.json`, using camelCase keys, merging without clobbering existing
9 fields, and writing proxy credentials to file only. Use to create or tune an anti-detection browse
10 profile before stealth browsing.
11allowed-tools:
12 - AskUserQuestion
13 - Bash
14 - Read
15 - Write
16argument-hint: "[preset or 'custom']"
17arguments:
18 - request
19when_to_use: |
20 Use when the user asks to configure camoufox, set up a stealth/anti-detection profile, or create a
21 named browse profile. Examples: "/browse-config", "make me a Google-safe camoufox profile", "tune my
22 anti-detection settings". Do NOT use for general `browse` CLI usage or non-camoufox config (browse),
23 or to actually run the stealth session (browse-stealth); this only produces the config file the
24 stealth runtime then consumes.
25effort: medium
26metadata:
27 source: https://skillmd.com/skills/ulpi-io/browse-config
28---
29
30# browse-config: Camoufox Configuration Generator
31
32## Step 0: Ask what the user needs
33
34Use AskUserQuestion to determine the goal. Offer these presets:
35
36| Preset | Description |
37|--------|-------------|
38| **Stealth browsing** | For scraping protected sites. Enables geoip, humanize, default OS fingerprint. |
39| **Fast scraping** | Minimal footprint. Blocks images, WebRTC, WebGL. Enables disk cache. |
40| **Google-safe** | For Google search without "unusual traffic" blocks. Enables geoip, humanize, random OS. |
41| **Custom** | Walk through each option group interactively. |
42
43### Preset defaults
44
45**Stealth browsing:**
46```json
47{
48 "geoip": true,
49 "humanize": true
50}
51```
52
53**Fast scraping:**
54```json
55{
56 "blockImages": true,
57 "blockWebrtc": true,
58 "blockWebgl": true,
59 "enableCache": true
60}
61```
62
63**Google-safe:**
64```json
65{
66 "geoip": true,
67 "humanize": true,
68 "os": ["windows", "macos", "linux"]
69}
70```
71
72## Step 1: Custom configuration (skip if preset chosen)
73
74If the user chose "Custom", ask about each option group using AskUserQuestion. Present one group at a time.
75
76### Identity
77- `os` (string or array) -- target OS fingerprint: "windows", "macos", "linux", or an array for random selection
78- `locale` (string or array) -- browser locale, e.g. "en-US" or ["en-US", "en-GB"]
79- `fingerprint` (object) -- advanced fingerprint overrides (most users skip this)
80
81### Privacy
82- `blockWebrtc` (boolean) -- block WebRTC to prevent IP leaks
83- `blockWebgl` (boolean) -- block WebGL fingerprinting
84- `blockImages` (boolean) -- block image loading (also improves speed)
85
86### Performance
87- `enableCache` (boolean) -- enable browser disk cache
88- `blockImages` (boolean) -- already covered in Privacy, mention speed benefit here
89
90### Network
91- `proxy` (string or object) -- proxy URL like "http://user:pass@host:port" or `{"server":"...","username":"...","password":"..."}`
92- `geoip` (string or boolean) -- true to auto-derive from proxy IP, or a country code like "US"
93
94### Behavior
95- `humanize` (boolean or number) -- true for default human-like delays, or a number (0.5-2.0) to control speed
96
97### Advanced (offer only if user asks)
98- `addons` (string[]) -- Firefox addon paths to load
99- `excludeAddons` (string[]) -- built-in addons to skip
100- `firefoxUserPrefs` (Record) -- raw Firefox about:config preferences
101- `args` (string[]) -- extra browser launch arguments
102- `fonts` (string[]) -- custom font list
103- `customFontsOnly` (boolean) -- use only custom fonts
104- `screen` (object) -- `{minWidth, maxWidth, minHeight, maxHeight}`
105- `window` ([width, height]) -- fixed window size
106- `ffVersion` (number) -- target Firefox version
107- `headless` (boolean or "virtual") -- headless mode (not recommended for anti-detection)
108- `mainWorldEval` (boolean) -- enable main world JavaScript eval
109- `executablePath` (string) -- custom camoufox binary path
110- `env` (Record) -- environment variables for the browser process
111- `virtualDisplay` (string) -- virtual display config (Linux only)
112- `disableCoop` (boolean) -- disable Cross-Origin-Opener-Policy headers
113- `debug` (boolean) -- enable debug logging
114
115## Step 2: Ask where to save
116
117Use AskUserQuestion with two options:
118
1191. **browse.json** -- adds a `"camoufox"` section to the project's `browse.json`. Applied automatically whenever `--runtime camoufox` is used.
1202. **Named profile** -- saves to `.browse/camoufox-profiles/<name>.json`. Used with `--camoufox-profile <name>`. Good for per-scenario configs (e.g. "google", "scrape", "stealth").
121
122If the user picks a named profile, ask for the profile name.
123
124## Step 3: Generate and write the file
125
126### If browse.json
127
128Read the existing `browse.json` first (if it exists). Merge the new `camoufox` key into it. Write the result:
129
130```json
131{
132 "camoufox": {
133 "geoip": true,
134 "humanize": true
135 }
136}
137```
138
139### If named profile
140
141Create the directory `.browse/camoufox-profiles/` if needed. Write just the config object:
142
143```json
144{
145 "geoip": true,
146 "humanize": true,
147 "os": "windows"
148}
149```
150
151## Step 4: Show usage
152
153After writing the file, tell the user exactly how to use it.
154
155**If browse.json:**
156```
157Run: browse --runtime camoufox goto <url>
158The camoufox section is applied automatically.
159```
160
161**If named profile:**
162```
163Run: browse --runtime camoufox --camoufox-profile <name> goto <url>
164```
165
166Always note: "The `--camoufox-profile` flag only applies when starting a new server. If a server is already running, stop it first with `browse stop`."
167
168## All CamoufoxConfig options
169
170All keys use camelCase in JSON. They are auto-mapped to snake_case for camoufox-js internally.
171
172| Key | Type | Description |
173|-----|------|-------------|
174| `os` | string or string[] | Target OS fingerprint |
175| `blockImages` | boolean | Block image loading |
176| `blockWebrtc` | boolean | Block WebRTC |
177| `blockWebgl` | boolean | Block WebGL |
178| `disableCoop` | boolean | Disable COOP headers |
179| `geoip` | string or boolean | GeoIP spoofing (true or country code) |
180| `humanize` | boolean or number | Human-like delays (true or speed factor) |
181| `locale` | string or string[] | Browser locale |
182| `addons` | string[] | Firefox addon paths |
183| `fonts` | string[] | Custom fonts |
184| `customFontsOnly` | boolean | Only use custom fonts |
185| `screen` | object | Screen size range ({minWidth, maxWidth, minHeight, maxHeight}) |
186| `window` | [number, number] | Fixed window size |
187| `fingerprint` | object | Fingerprint overrides |
188| `ffVersion` | number | Firefox version |
189| `headless` | boolean or "virtual" | Headless mode |
190| `mainWorldEval` | boolean | Main world eval |
191| `firefoxUserPrefs` | Record | Firefox about:config prefs |
192| `proxy` | string or object | Proxy config |
193| `enableCache` | boolean | Enable disk cache |
194| `debug` | boolean | Debug logging |
195| `excludeAddons` | string[] | Addons to exclude |
196| `executablePath` | string | Custom browser path |
197| `args` | string[] | Extra browser args |
198| `env` | Record | Environment variables |
199| `virtualDisplay` | string | Virtual display (Linux) |
200
201## Guardrails
202
203- Always use AskUserQuestion before generating config. Do not assume preferences.
204- Use camelCase keys in all generated JSON (the CLI handles snake_case mapping).
205- Never overwrite existing browse.json fields outside the `camoufox` key.
206- Never include proxy credentials in output shown to the user. Write them to the file only.
207- Do not include options the user did not ask for or confirm, beyond the preset defaults.