unbrowse 2.12.0 → 2.12.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 +5 -56
- package/bin/unbrowse-wrapper.mjs +0 -0
- package/dist/cli.js +232 -471
- package/package.json +1 -1
- package/runtime-src/analytics-session.ts +5 -27
- package/runtime-src/api/browse-session.ts +3 -1
- package/runtime-src/api/browse-submit.ts +27 -34
- package/runtime-src/api/routes.ts +103 -145
- package/runtime-src/cli.ts +8 -175
- package/runtime-src/client/index.ts +44 -15
- package/runtime-src/execution/index.ts +1 -6
- package/runtime-src/indexer/index.ts +2 -4
- package/runtime-src/kuri/client.ts +35 -2
- package/runtime-src/orchestrator/index.ts +2 -2
- package/runtime-src/reverse-engineer/index.ts +0 -8
- package/runtime-src/runtime/setup.ts +7 -7
- package/runtime-src/server.ts +4 -3
- package/dist/mcp.js +0 -20392
- package/runtime-src/agent-outcome.ts +0 -166
- package/runtime-src/mcp.ts +0 -1065
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
This package installs the `unbrowse` CLI.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Turn any website into a reusable API interface for agents. Unbrowse captures network traffic, reverse-engineers the real endpoints underneath the UI, and stores what it learns in a shared marketplace so the next agent can reuse it instantly.
|
|
6
6
|
|
|
7
7
|
One agent learns a site once. Every later agent gets the fast path.
|
|
8
8
|
|
|
@@ -10,35 +10,6 @@ Unbrowse is a drop-in replacement for OpenClaw / `agent-browser` browser flows f
|
|
|
10
10
|
|
|
11
11
|
> Security note: capture and execution stay local by default. Credentials stay on your machine. Learned API contracts are published to the shared marketplace only after capture. See [SKILL.md](./SKILL.md) for the full agent-facing API reference and tool-policy guidance.
|
|
12
12
|
|
|
13
|
-
## MCP server
|
|
14
|
-
|
|
15
|
-
Unbrowse implements the Model Context Protocol over stdio. `unbrowse mcp` is the MCP server entrypoint.
|
|
16
|
-
|
|
17
|
-
- Protocol: JSON-RPC 2.0 MCP over stdio
|
|
18
|
-
- Handshake: `initialize`, `notifications/initialized`, `ping`
|
|
19
|
-
- Capability surface today: `tools/list` and `tools/call`
|
|
20
|
-
- Current MCP shape: tools only. No `resources/*` or `prompts/*` methods yet.
|
|
21
|
-
- Runtime model: the MCP server fronts the local Unbrowse runtime on `http://localhost:6969`; hosts talk standard MCP, and Unbrowse uses the local HTTP runtime behind the scenes.
|
|
22
|
-
|
|
23
|
-
Core MCP tools:
|
|
24
|
-
|
|
25
|
-
- Discovery: `unbrowse_health`, `unbrowse_search`, `unbrowse_resolve`, `unbrowse_execute`, `unbrowse_feedback`
|
|
26
|
-
- Auth/cache: `unbrowse_login`, `unbrowse_skills`, `unbrowse_skill`, `unbrowse_sessions`
|
|
27
|
-
- Browser capture: `unbrowse_go`, `unbrowse_snap`, `unbrowse_click`, `unbrowse_fill`, `unbrowse_type`, `unbrowse_press`, `unbrowse_select`, `unbrowse_scroll`, `unbrowse_submit`, `unbrowse_screenshot`, `unbrowse_text`, `unbrowse_markdown`, `unbrowse_cookies`, `unbrowse_eval`, `unbrowse_sync`, `unbrowse_close`
|
|
28
|
-
|
|
29
|
-
Typical MCP host config:
|
|
30
|
-
|
|
31
|
-
```json
|
|
32
|
-
{
|
|
33
|
-
"mcpServers": {
|
|
34
|
-
"unbrowse": {
|
|
35
|
-
"command": "npx",
|
|
36
|
-
"args": ["-y", "unbrowse", "mcp"]
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
|
-
```
|
|
41
|
-
|
|
42
13
|
## Quick start
|
|
43
14
|
|
|
44
15
|
```bash
|
|
@@ -51,9 +22,7 @@ cd ~/unbrowse && ./setup --host off
|
|
|
51
22
|
|
|
52
23
|
If a wallet is configured, that wallet address becomes the contributor/payment truth: it is synced onto your agent profile, used as the destination for contributor payouts when your routes earn, and used as the spending wallet for paid marketplace routes.
|
|
53
24
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
Unbrowse supports wallet providers such as Crossmint `lobster.cash` for x402-gated routes. If you use `lobster.cash`, set `LOBSTER_WALLET_ADDRESS`. Other providers can use `AGENT_WALLET_ADDRESS` and optional `AGENT_WALLET_PROVIDER`.
|
|
25
|
+
Unbrowse supports wallet providers such as `lobster.cash` for x402-gated routes. If you use `lobster.cash`, set `LOBSTER_WALLET_ADDRESS`. Other providers can use `AGENT_WALLET_ADDRESS` and optional `AGENT_WALLET_PROVIDER`.
|
|
57
26
|
|
|
58
27
|
For repeat npm use after a healthy publish:
|
|
59
28
|
|
|
@@ -62,15 +31,6 @@ npm install -g unbrowse
|
|
|
62
31
|
unbrowse setup
|
|
63
32
|
```
|
|
64
33
|
|
|
65
|
-
For generic MCP hosts:
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
git clone --single-branch --depth 1 https://github.com/unbrowse-ai/unbrowse.git ~/unbrowse
|
|
69
|
-
cd ~/unbrowse && ./setup --host mcp
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
That writes a ready-to-import MCP config to `~/.config/unbrowse/mcp/unbrowse.json`. A generic template is also published at [`/mcp.json`](https://www.unbrowse.ai/mcp.json).
|
|
73
|
-
|
|
74
34
|
If your agent host uses skills:
|
|
75
35
|
|
|
76
36
|
```bash
|
|
@@ -89,14 +49,6 @@ git pull --ff-only
|
|
|
89
49
|
./setup --host off
|
|
90
50
|
```
|
|
91
51
|
|
|
92
|
-
If you installed for a generic MCP host:
|
|
93
|
-
|
|
94
|
-
```bash
|
|
95
|
-
cd ~/unbrowse
|
|
96
|
-
git pull --ff-only
|
|
97
|
-
./setup --host mcp
|
|
98
|
-
```
|
|
99
|
-
|
|
100
52
|
If your agent host uses skills, rerun its skill install/update command too:
|
|
101
53
|
|
|
102
54
|
```bash
|
|
@@ -105,8 +57,8 @@ npx skills add unbrowse-ai/unbrowse
|
|
|
105
57
|
|
|
106
58
|
Need help or want release updates? Join the Discord: [discord.gg/VWugEeFNsG](https://discord.gg/VWugEeFNsG)
|
|
107
59
|
|
|
108
|
-
Every CLI command auto-starts the local
|
|
109
|
-
|
|
60
|
+
Every CLI command auto-starts the local server on `http://localhost:6969` by default. Override with `UNBROWSE_URL`, `PORT`, or `HOST`. On first startup it auto-registers as an agent with the marketplace and caches credentials in `~/.unbrowse/config.json`. `unbrowse setup` now prompts for an email-shaped identity first; headless setups can provide `UNBROWSE_AGENT_EMAIL`.
|
|
61
|
+
Canonical docs: [docs.unbrowse.ai](https://docs.unbrowse.ai)
|
|
110
62
|
|
|
111
63
|
Works with Claude Code, Open Code, Cursor, Codex, Windsurf, and any agent host that can call a local CLI or skill.
|
|
112
64
|
|
|
@@ -116,22 +68,19 @@ Works with Claude Code, Open Code, Cursor, Codex, Windsurf, and any agent host t
|
|
|
116
68
|
- Prebuilds the packaged CLI runtime and installs the stable `unbrowse` shim for the repo bootstrap path.
|
|
117
69
|
- Verifies the bundled Kuri binary, or builds it from the vendored Kuri source when working from repo source with Zig installed.
|
|
118
70
|
- Registers the Open Code `/unbrowse` command when Open Code is present.
|
|
119
|
-
- Runs the first-use flow: ToS, agent registration/API-key caching, wallet detection
|
|
71
|
+
- Runs the first-use flow: ToS, agent registration/API-key caching, and wallet detection.
|
|
120
72
|
- Starts the local Unbrowse server unless `--no-start` is passed.
|
|
121
73
|
|
|
122
74
|
## Common commands
|
|
123
75
|
|
|
124
76
|
```bash
|
|
125
77
|
unbrowse health
|
|
126
|
-
unbrowse mcp
|
|
127
78
|
unbrowse resolve --intent "get trending searches" --url "https://google.com" --pretty
|
|
128
79
|
unbrowse login --url "https://calendar.google.com"
|
|
129
80
|
unbrowse skills
|
|
130
81
|
unbrowse search --intent "get stock prices"
|
|
131
82
|
```
|
|
132
83
|
|
|
133
|
-
For most MCP hosts, the standard flow is `unbrowse_resolve` first, then `unbrowse_execute`. For JS-heavy or first-time capture workflows, use the browser tool chain: `unbrowse_go -> unbrowse_snap -> action tools -> unbrowse_submit/unbrowse_sync -> unbrowse_close`.
|
|
134
|
-
|
|
135
84
|
## Demo notes
|
|
136
85
|
|
|
137
86
|
- First-time capture/indexing on a site can take 20-80 seconds. That is the slow path; repeats should be much faster.
|
package/bin/unbrowse-wrapper.mjs
CHANGED
|
File without changes
|