browserforce 1.0.0 → 1.0.2
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 +42 -10
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -26,7 +26,7 @@ npm install -g browserforce
|
|
|
26
26
|
Or from source:
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
git clone https://github.com/
|
|
29
|
+
git clone https://github.com/ivalsaraj/browserforce.git
|
|
30
30
|
cd browserforce
|
|
31
31
|
pnpm install
|
|
32
32
|
```
|
|
@@ -64,7 +64,7 @@ Extension icon turns green — you're connected.
|
|
|
64
64
|
|
|
65
65
|
### OpenClaw
|
|
66
66
|
|
|
67
|
-
Add
|
|
67
|
+
Add BrowserForce as an MCP server in `~/.openclaw/openclaw.json`:
|
|
68
68
|
|
|
69
69
|
```json
|
|
70
70
|
{
|
|
@@ -77,8 +77,8 @@ Add to `~/.openclaw/openclaw.json`:
|
|
|
77
77
|
{
|
|
78
78
|
"name": "browserforce",
|
|
79
79
|
"transport": "stdio",
|
|
80
|
-
"command": "
|
|
81
|
-
"args": ["
|
|
80
|
+
"command": "npx",
|
|
81
|
+
"args": ["-y", "browserforce", "mcp"]
|
|
82
82
|
}
|
|
83
83
|
]
|
|
84
84
|
}
|
|
@@ -98,8 +98,8 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
|
98
98
|
{
|
|
99
99
|
"mcpServers": {
|
|
100
100
|
"browserforce": {
|
|
101
|
-
"command": "
|
|
102
|
-
"args": ["
|
|
101
|
+
"command": "npx",
|
|
102
|
+
"args": ["-y", "browserforce", "mcp"]
|
|
103
103
|
}
|
|
104
104
|
}
|
|
105
105
|
}
|
|
@@ -113,8 +113,8 @@ Add to `~/.claude/mcp.json`:
|
|
|
113
113
|
{
|
|
114
114
|
"mcpServers": {
|
|
115
115
|
"browserforce": {
|
|
116
|
-
"command": "
|
|
117
|
-
"args": ["
|
|
116
|
+
"command": "npx",
|
|
117
|
+
"args": ["-y", "browserforce", "mcp"]
|
|
118
118
|
}
|
|
119
119
|
}
|
|
120
120
|
}
|
|
@@ -143,7 +143,7 @@ Each `-e` command is one-shot — state does not persist between calls. For pers
|
|
|
143
143
|
Install the skill directly:
|
|
144
144
|
|
|
145
145
|
```bash
|
|
146
|
-
npx -y skills add
|
|
146
|
+
npx -y skills add ivalsaraj/browserforce
|
|
147
147
|
```
|
|
148
148
|
|
|
149
149
|
Or add to your agent config manually — the skill teaches the agent to use BrowserForce CLI commands via Bash.
|
|
@@ -280,6 +280,38 @@ RELAY_PORT=19333 browserforce serve
|
|
|
280
280
|
| `ws://.../extension` | Chrome extension WebSocket |
|
|
281
281
|
| `ws://.../cdp?token=...` | Agent CDP connection |
|
|
282
282
|
|
|
283
|
+
## Comparison
|
|
284
|
+
|
|
285
|
+
### vs Playwright MCP
|
|
286
|
+
|
|
287
|
+
| | Playwright MCP | BrowserForce |
|
|
288
|
+
|---|---|---|
|
|
289
|
+
| Browser | Spawns new Chrome | **Uses your Chrome** |
|
|
290
|
+
| Login state | Fresh — must log in every time | Already logged in |
|
|
291
|
+
| Extensions | None | Your existing ones |
|
|
292
|
+
| Bot detection | Always detected | Runs in your real profile |
|
|
293
|
+
| Memory | Double (two Chrome instances) | Uses existing Chrome |
|
|
294
|
+
|
|
295
|
+
### vs Claude Browser Extension
|
|
296
|
+
|
|
297
|
+
| | Claude Extension | BrowserForce |
|
|
298
|
+
|---|---|---|
|
|
299
|
+
| Agent support | Claude only | **Any MCP client** (OpenClaw, Claude, custom) |
|
|
300
|
+
| Context method | Screenshots (100KB+) | Accessibility snapshots (5-20KB) |
|
|
301
|
+
| Playwright API | No | Full |
|
|
302
|
+
| Network interception | Limited | Full |
|
|
303
|
+
| Raw CDP access | No | Yes |
|
|
304
|
+
|
|
305
|
+
### vs Antigravity (Jetski)
|
|
306
|
+
|
|
307
|
+
| | Jetski | BrowserForce |
|
|
308
|
+
|---|---|---|
|
|
309
|
+
| Tools | 17+ tools | 1 `execute` tool |
|
|
310
|
+
| Approach | Spawns subagent for browser tasks | Direct execution |
|
|
311
|
+
| Latency | High (agent overhead) | Low |
|
|
312
|
+
| LLM knowledge | Must learn custom tools | Already knows Playwright |
|
|
313
|
+
| Context usage | High (many tool schemas) | Low |
|
|
314
|
+
|
|
283
315
|
## Troubleshooting
|
|
284
316
|
|
|
285
317
|
| Problem | Fix |
|
|
@@ -290,4 +322,4 @@ RELAY_PORT=19333 browserforce serve
|
|
|
290
322
|
| Extension keeps reconnecting | Normal — MV3 kills idle workers; it auto-recovers |
|
|
291
323
|
| Port in use | `lsof -ti:19222 \| xargs kill -9` |
|
|
292
324
|
|
|
293
|
-
> **Want the full walkthrough?** Read the [User Guide](GUIDE.md) for a plain-English explanation of what this does and how to get started.
|
|
325
|
+
> **Want the full walkthrough?** Read the [User Guide](https://github.com/ivalsaraj/browserforce/blob/main/GUIDE.md) for a plain-English explanation of what this does and how to get started.
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "browserforce",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Give AI agents your real Chrome browser — your logins, cookies, and tabs. Works with OpenClaw, Claude, and any MCP agent.",
|
|
6
|
-
"homepage": "https://github.com/
|
|
6
|
+
"homepage": "https://github.com/ivalsaraj/browserforce",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
|
-
"url": "https://github.com/
|
|
9
|
+
"url": "https://github.com/ivalsaraj/browserforce.git"
|
|
10
10
|
},
|
|
11
11
|
"license": "MIT",
|
|
12
12
|
"keywords": [
|