@ulpi/browse 1.1.1 → 1.3.0

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@ulpi/browse",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/ulpi-io/browse"
   },
   "dependencies": {
     "@lightpanda/browser": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@ulpi/browse": "^0.3.0",
     "better-sqlite3": "^11.0.0",
     "diff": "^7.0.0",
@@ -41,7 +42,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "esbuild src/cli.ts --bundle --format=cjs --platform=node --target=node18 --outfile=dist/browse.cjs --external:playwright --external:playwright-core --external:better-sqlite3 --external:electron --external:chromium-bidi --banner:js='#!/usr/bin/env node\nconst __import_meta_url = require(\"url\").pathToFileURL(__filename).href;' --define:import.meta.url=__import_meta_url",
+    "build": "esbuild src/cli.ts --bundle --format=cjs --platform=node --target=node18 --outfile=dist/browse.cjs --external:playwright --external:playwright-core --external:better-sqlite3 --external:electron --external:chromium-bidi --external:@modelcontextprotocol/sdk --banner:js='#!/usr/bin/env node\nconst __import_meta_url = require(\"url\").pathToFileURL(__filename).href;' --define:import.meta.url=__import_meta_url",
     "build:all": "bash scripts/build-all.sh",
     "dev": "tsx src/cli.ts",
     "server": "tsx src/server.ts",

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: browse
-version: 3.4.0
+version: 3.5.0
 description: |
   Fast web browsing and web app testing for AI coding agents via persistent headless Chromium daemon.
   Browse any URL, read page content, click elements, fill forms, run JavaScript, take screenshots,
@@ -120,6 +120,12 @@ browse cookie-import chrome --domain .site.com
 
 # Persistent profiles
 browse --profile mysite goto https://app.com
+
+# Cloud providers (encrypted API keys, never visible to agents)
+browse provider save browserbase <api-key>
+browse --provider browserbase goto https://example.com
+browse provider list
+browse provider delete browserbase
 ```
 
 ## Command Reference
@@ -369,6 +375,7 @@ browse record stop                     Stop recording, keep steps for export
 browse record status                   Recording state and step count
 browse record export browse [path]     Export as chain-compatible JSON (replay with browse chain)
 browse record export replay [path]    Export as Chrome DevTools Recorder (Playwright/Puppeteer)
+browse record export replay --selectors css,aria [path]  Filter selector types in export
 ```
 
 ### React DevTools
@@ -386,9 +393,17 @@ browse react-devtools owners <sel>     Parent component chain
 browse react-devtools context <sel>    Context values consumed by component
 ```
 
+### Cloud Providers
+```
+browse provider save <name> <key>  Save provider API key (encrypted)
+browse provider list               List saved providers
+browse provider delete <name>      Delete provider key
+```
+
 ### Handoff (human takeover)
 ```
-browse handoff [reason]        Swap to visible browser for user to solve CAPTCHA/MFA
+browse handoff [reason]        Swap to Chrome for user to solve CAPTCHA/MFA (bypasses bot detection)
+browse handoff --chromium      Force Playwright Chromium instead of Chrome
 browse resume                  Swap back to headless, returns fresh snapshot
 ```
 
@@ -416,9 +431,12 @@ browse inspect                 Open DevTools (requires BROWSE_DEBUG_PORT)
 | `--allowed-domains <d,d>` | Block navigation/resources outside allowlist |
 | `--max-output <n>` | Truncate output to N characters |
 | `--headed` | Run browser in headed (visible) mode |
+| `--chrome` | Launch system Chrome (real browser, bypasses bot detection) |
 | `--cdp <port>` | Connect to Chrome on a specific debugging port |
 | `--connect` | Auto-discover and connect to a running Chrome instance |
-| `--runtime <name>` | Browser engine: playwright (default), rebrowser (stealth), lightpanda |
+| `--provider <name>` | Cloud browser provider (browserless, browserbase) |
+| `--runtime <name>` | Browser engine: playwright (default), rebrowser (stealth), lightpanda, chrome |
+| `--mcp` | Run as MCP server (for Cursor, Windsurf, Cline) |
 
 ## Reference Files
 

package/skill/references/guides.md

@@ -154,6 +154,7 @@ Read this section when you're unsure which command to use for a task.
 | Find suspense blockers | `react-devtools enable` then `suspense` |
 | Bypass bot detection | `--runtime rebrowser goto <url>` |
 | Persistent login state | `--profile mysite` then browse then close then reopen (still logged in) |
+| Cloud browser (CI/CD) | `provider save browserbase <key>` then `--provider browserbase goto <url>` |
 
 ## Architecture