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 CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  This package installs the `unbrowse` CLI.
4
4
 
5
- Unbrowse is a local Model Context Protocol (MCP) server and CLI that turns any website into a reusable API interface for agents. It 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.
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
- Recommended for new installs: set up Crossmint `lobster.cash` during bootstrap. `unbrowse setup` now encourages it, and when the tooling is already present it will try `npx @crossmint/lobster-cli setup` automatically. That wallet becomes the payout destination for contributed routes and the spending wallet for paid marketplace routes.
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 runtime on `http://localhost:6969` by default, and `unbrowse mcp` uses that same runtime behind the MCP stdio surface. 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`.
109
- Public companion docs: [docs.unbrowse.ai](https://docs.unbrowse.ai)
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, and Crossmint `lobster.cash` encouragement.
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.
File without changes