@askjo/camofox-browser 1.8.0 → 1.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -5
- package/openclaw.plugin.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -42,7 +42,7 @@ This project wraps that engine in a REST API built for agents: accessibility sna
|
|
|
42
42
|
- **C++ Anti-Detection** - bypasses Google, Cloudflare, and most bot detection
|
|
43
43
|
- **Element Refs** - stable `e1`, `e2`, `e3` identifiers for reliable interaction
|
|
44
44
|
- **Token-Efficient** - accessibility snapshots are ~90% smaller than raw HTML
|
|
45
|
-
- **Runs on Anything** - lazy browser launch + idle shutdown keeps memory at ~40MB when idle. Designed to share a box with the rest of your stack — Raspberry Pi, $5 VPS, shared
|
|
45
|
+
- **Runs on Anything** - lazy browser launch + idle shutdown keeps memory at ~40MB when idle. Designed to share a box with the rest of your stack — Raspberry Pi, $5 VPS, shared infra.
|
|
46
46
|
- **Session Isolation** - separate cookies/storage per user
|
|
47
47
|
- **Cookie Import** - inject Netscape-format cookie files for authenticated browsing
|
|
48
48
|
- **Proxy + GeoIP** - route traffic through residential proxies with automatic locale/timezone
|
|
@@ -113,9 +113,24 @@ make up VERSION=135.0.1 RELEASE=beta.24
|
|
|
113
113
|
|
|
114
114
|
> **⚠️ Do not run `docker build` directly.** The Dockerfile uses bind mounts to pull pre-downloaded binaries from `dist/`. Always use `make up` (or `make fetch` then `make build`) — it downloads the binaries first.
|
|
115
115
|
|
|
116
|
-
### Fly.io
|
|
116
|
+
### Fly.io
|
|
117
117
|
|
|
118
|
-
|
|
118
|
+
For Fly.io or other remote CI, you'll need a Dockerfile that downloads binaries at build time instead of using bind mounts.
|
|
119
|
+
|
|
120
|
+
### Railway
|
|
121
|
+
|
|
122
|
+
A `railway.toml` is included. It uses `Dockerfile.ci` (which downloads binaries at build time) and maps Railway's `PORT` env var to `CAMOFOX_PORT` automatically.
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
# Install Railway CLI, then:
|
|
126
|
+
railway link
|
|
127
|
+
railway up
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Set secrets via the Railway dashboard or CLI:
|
|
131
|
+
```bash
|
|
132
|
+
railway variables set CAMOFOX_API_KEY="your-generated-key"
|
|
133
|
+
```
|
|
119
134
|
|
|
120
135
|
## Usage
|
|
121
136
|
|
|
@@ -252,7 +267,7 @@ curl -X POST http://localhost:9377/sessions/agent1/cookies \
|
|
|
252
267
|
-d '{"cookies":[{"name":"foo","value":"bar","domain":"example.com","path":"/","expires":-1,"httpOnly":false,"secure":false}]}'
|
|
253
268
|
```
|
|
254
269
|
|
|
255
|
-
#### Docker / Fly.io
|
|
270
|
+
#### Docker / Fly.io / Railway
|
|
256
271
|
|
|
257
272
|
```bash
|
|
258
273
|
docker run -p 9377:9377 \
|
|
@@ -266,6 +281,11 @@ For Fly.io:
|
|
|
266
281
|
fly secrets set CAMOFOX_API_KEY="your-generated-key"
|
|
267
282
|
```
|
|
268
283
|
|
|
284
|
+
For Railway:
|
|
285
|
+
```bash
|
|
286
|
+
railway variables set CAMOFOX_API_KEY="your-generated-key"
|
|
287
|
+
```
|
|
288
|
+
|
|
269
289
|
### Proxy + GeoIP
|
|
270
290
|
|
|
271
291
|
Route all browser traffic through a proxy with automatic locale, timezone, and geolocation derived from the proxy's IP address via Camoufox's built-in GeoIP.
|
|
@@ -480,7 +500,7 @@ Reddit macros return JSON directly (no HTML parsing needed):
|
|
|
480
500
|
| Variable | Description | Default |
|
|
481
501
|
|----------|-------------|---------|
|
|
482
502
|
| `CAMOFOX_PORT` | Server port | `9377` |
|
|
483
|
-
| `PORT` | Server port (fallback, for platforms like Fly.io) | `9377` |
|
|
503
|
+
| `PORT` | Server port (fallback, for platforms like Fly.io, Railway) | `9377` |
|
|
484
504
|
| `CAMOFOX_API_KEY` | Enable cookie import endpoint (disabled if unset) | - |
|
|
485
505
|
| `CAMOFOX_ADMIN_KEY` | Required for `POST /stop` | - |
|
|
486
506
|
| `CAMOFOX_ACCESS_KEY` | If set, all routes (except `/health`, cookie import, and `/stop`) require `Authorization: Bearer <key>`. Lets you safely expose the server beyond loopback. | - |
|
package/openclaw.plugin.json
CHANGED
package/package.json
CHANGED