Skip to content

Add BrowseCLI in a Vercel Sandbox example#1517

Draft
shrey150 wants to merge 1 commit into
vercel:mainfrom
shrey150:browsecli-vercel-sandbox
Draft

Add BrowseCLI in a Vercel Sandbox example#1517
shrey150 wants to merge 1 commit into
vercel:mainfrom
shrey150:browsecli-vercel-sandbox

Conversation

@shrey150

Copy link
Copy Markdown

What

Adds solutions/browsecli-vercel-sandbox — an example that runs the browse CLI inside a Vercel Sandbox (an ephemeral Firecracker microVM) and connects out over CDP to a Verified Browserbase browser.

A vanilla microVM has a datacenter IP and no anti-bot hardening, so an in-sandbox browser gets blocked on the real web. Here the browser lives on Browserbase instead — residential IP, Verified-browser anti-bot fingerprinting, and server-side CAPTCHA / challenge solving — so the sandbox can reach protected, bot-defended sites that an in-sandbox datacenter-IP Chrome gets walled on.

Vercel Sandbox (node24 + `browse` CLI)  ──CDP/wss──▶  Browserbase Verified browser

Contents

  • sandbox.ts — standalone, directly-runnable script (Sandbox.create({ runtime: 'node24' })npm i -g browse → run the demo, streaming stdout)
  • app/api/run/route.ts — optional Next.js (App Router) POST /api/run variant
  • browsecli-demo.sh — creates a Verified session, opens a Cloudflare-protected page over CDP, and asserts real content
  • package.json / tsconfig.json / .env.example / .gitignore

Verification

Verified end-to-end on a real Vercel Sandbox: the microVM installs browse, opens a Verified Browserbase session, loads a Cloudflare-protected page over CDP, and the demo asserts real page content (RESULT: ✅ PASS).

Note: Verified browsers/sessions (residential IP + automatic CAPTCHA solving) require a Browserbase Scale plan — see https://www.browserbase.com/pricing. On lower plans, drop --verified.


This PR is intentionally a draft. Opening for early visibility / format review before marking ready.

Signed-off-by: Shrey Pandya <shrey@browserbase.com>
@vercel

vercel Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

@shrey150 is attempting to deploy a commit to the Vercel Examples Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addednpm/​@​vercel/​sandbox@​2.2.17210010098100

View full report

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant