unbrowser by Unchained

by protostatis

Not rated
GitHub

About

Lightweight MCP browser for LLM agents: no Chrome, low-token BlockMaps, stateful sessions, JavaScript execution, forms, cookies, and escalation hints.

Details

Author
protostatis
Categories
Web Scraping, Automation, Other

Setup

Install unbrowser by Unchained in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/protostatis/unbrowser

Follow the installation instructions in the repository README, then restart your MCP client.

Official MCP Registry identity:mcp-name: io.github.protostatis/unbrowser

Defaultnavigateis a fast static/SSR pass.Setexec_scripts: trueonly when you need bounded QuickJS execution. Heavy SPAs, pixels, V8 fidelity, extensions, and interactive anti-bot challenges belong in a real Chrome tier.

Useunbrowserwhen HTTP alone is too dumb and a full browser is too expensive. When the page needs Chrome, the output tells the agent to escalate rather than pretending compatibility it does not have.

Docker — Linux amd64/arm64, ~13 MiB pull

docker pull ghcr.io/protostatis/unbrowser:latest # One-shot navigation docker run --rm ghcr.io/protostatis/unbrowser:latest \ navigate https://example.com --json # Default mode: MCP over stdio docker run --rm -i ghcr.io/protostatis/unbrowser:latest

The image is distroless and runs as non-root: no shell, package manager, or persistent state. Pin:vX.Y.Zor an image digest in production.

pipx install pyunbrowser # recommended on macOS / modern Linux # or, inside a Python 3.10+ virtual environment: pip install pyunbrowser
from unbrowser import Client with Client() as ub: ub.navigate("https://news.ycombinator.com") for link in ub.query(".titleline > a")[:3]: print(link["text"], link["attrs"]["href"])

On macOS,/usr/bin/python3is 3.9 and cannot install the wheel; usepipxor a Homebrew Python. The PyPI distribution ispyunbrowser, while the import and executable remainunbrowser.

{ "mcpServers": { "unbrowser": { "command": "unbrowser", "args": ["--mcp"] } } }
{ "mcpServers": { "unbrowser": { "command": "docker", "args": [ "run", "--rm", "-i", "ghcr.io/protostatis/unbrowser:latest" ] } } }

Seeinstallation and interface referencefor Cargo, release archives, source builds, persistent shell sessions, raw JSON-RPC, and all MCP options.

{"id":1,"method":"navigate","params":{"url":"https://example.com","exec_scripts":true}}

Withexec_scripts: true, inline and external scripts run in QuickJS under a bounded watchdog. This can materialize light hydration and fetch-visible data; it is not V8 or a rendering engine. Heavy React/Vue/Ember apps may still leave an empty shell.

MCP server for browser automation via Vercel agent-browser CLI

Convert any URL to LLM-ready Markdown via real Chrome browsers. 3 tools: scrape, crawl, search. Free via MCP, pay-per-use via x402.

An MCP server that allows AI agents to control a web browser using the browser-use library.

Exposes Chrome browser functionality to AI assistants for automation, content analysis, and semantic search via a Chrome extension.

Control a Chrome browser through the Chrome DevTools Protocol (CDP) from MCP clients for browsing, inspection, and automation workflows.

Stealthy, LLM-drivable browser engine — a Python library + 85-tool MCP server on stealth Chromium with full Chrome DevTools Protocol.

Multi-session browser MCP for AI agents — stealth mode, session pooling, humanization, 10x fewer tokens than Playwright

A Go-based MCP server for interacting with the Lightpanda Browser using the Chrome DevTools Protocol (CDP).

A browser automation agent using the Model Context Protocol (MCP) to enable browser interactions.

A browser automation service for capturing console output, useful for tasks like public sentiment analysis.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.