smooth-operator-mcp 2.4.8 → 2.4.9
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 +20 -18
- package/dist/smooth-operator.mjs +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# SmoothOperator
|
|
2
2
|
|
|
3
|
-
Give your AI a real Chrome. SmoothOperator is a
|
|
3
|
+
Give your AI a real Chrome. SmoothOperator is a lightweight, production-grade MCP server for secure, reliable browser control. Your harness supplies the reasoning; SmoothOperator handles navigation, interaction, extraction, and browser lifecycle. No model keys. No hidden planner.
|
|
4
4
|
|
|
5
|
-
## Install —
|
|
5
|
+
## Install — directly to your harness
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Choose your harness, add SmoothOperator directly to it, and restart the harness.
|
|
8
8
|
|
|
9
9
|
**From npm** (`smooth-operator-mcp`):
|
|
10
10
|
~~~sh
|
|
@@ -27,7 +27,7 @@ Or straight from GitHub:
|
|
|
27
27
|
npm install -g github:Gitshop77/Smooth-Operator && smooth-operator install opencode
|
|
28
28
|
~~~
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
The wizard asks 7 focused questions covering browser mode, executable, headless operation, domain policy, page JavaScript, and the data directory. Run `smooth-operator install` with no harness to pick one interactively (TTY only; piped/CI runs print usage and exit). `--yes` applies the recommended defaults, so give it a target: `smooth-operator install opencode --yes`. Personal Chrome mode launches a dedicated debugging profile on `9222` and derives `browserUrl` automatically.
|
|
31
31
|
|
|
32
32
|
Requires Node 22.23.2+ and Chrome. Profile at `~/.smooth-operator/browser` — sign in once.
|
|
33
33
|
|
|
@@ -35,35 +35,37 @@ Verify: `smooth-operator --help` and `server_health` / `browser_doctor` appear a
|
|
|
35
35
|
|
|
36
36
|
## What it does
|
|
37
37
|
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
- Search web
|
|
38
|
+
- Navigate and interact with real websites: click, type, select, scroll, hover, and key input
|
|
39
|
+
- Inspect pages with snapshots, accessibility trees, HTML, styles, text search, and bounded extraction
|
|
40
|
+
- Work across tabs, frames, popups, shadow DOM, dialogs, cookies, storage, downloads, screenshots, and PDFs
|
|
41
|
+
- Search the web through bounded DuckDuckGo retrieval
|
|
42
42
|
|
|
43
|
-
Ask: *“Scrape pricing into a table
|
|
43
|
+
Ask: *“Scrape pricing into a table”*, *“Fill this form with ~/resume.pdf”*, or *“Download the monthly report as a PDF.”*
|
|
44
44
|
|
|
45
45
|
## How to use
|
|
46
46
|
|
|
47
|
-
Talk to your harness normally. It
|
|
47
|
+
Talk to your harness normally. It can call `browser_navigate` → `browser_snapshot` → `browser_click` and the rest of the MCP surface as needed. Logins and CAPTCHA challenges pause for human handoff in the Chrome window.
|
|
48
48
|
|
|
49
49
|
## Why
|
|
50
50
|
|
|
51
|
-
- Zero
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
51
|
+
- Zero setup — managed, headed, persistent Chrome by default
|
|
52
|
+
- Secure by default — domain and file policy, bounded outputs, redaction, and JavaScript disabled unless explicitly enabled
|
|
53
|
+
- Reliable — private profiles, stale-reference recovery, reconnect handling, and structured errors
|
|
54
|
+
- Flexible — stdio by default, Streamable HTTP when you need it, plus connect and disabled modes
|
|
55
55
|
|
|
56
56
|
## Benchmarks
|
|
57
57
|
|
|
58
|
+
Compared with [Browser Use MCP](https://github.com/browser-use/browser-use) · [](https://github.com/browser-use/browser-use)
|
|
59
|
+
|
|
58
60
|
| Benchmark | Metric | SmoothOperator | Browser Use MCP |
|
|
59
61
|
| --- | --- | ---: | ---: |
|
|
60
62
|
| Live Web (8 sites, 32 episodes) | URL success | **32/32** | 23/32 |
|
|
61
63
|
| Live Web | Page-text quality | **26/32** | 21/32 |
|
|
62
64
|
| Live Web | Combined success | **26/32** | 18/32 |
|
|
63
|
-
| Live Web | Task latency mean / p95 | **1,
|
|
64
|
-
| Live Web | Navigation p95 | **2,130
|
|
65
|
-
| Live Web | Click p95 |
|
|
66
|
-
| Live Web | MCP call p95 | **
|
|
65
|
+
| Live Web | Task latency mean / p95 | **1,358 / 2,957 ms** | 4,604 / 30,780 ms |
|
|
66
|
+
| Live Web | Navigation p95 | **2,130 ms** | 4,320 ms |
|
|
67
|
+
| Live Web | Click p95 | 920 ms | **142 ms** |
|
|
68
|
+
| Live Web | MCP call p95 | **943 ms** | 2,095 ms |
|
|
67
69
|
| Live Web | Trace errors | **0** | 10 |
|
|
68
70
|
| MiniWoB++ 0.14.3 (125 tasks) | Reward = 1 | **124/125** | 89/125 |
|
|
69
71
|
| MiniWoB++ | Attempts | **125** | 125 |
|
package/dist/smooth-operator.mjs
CHANGED