Menyediakan web runtime non-visual yang ringan untuk agent yang dapat menangani cookies, state DOM, dan HTML forms tanpa perlu instalasi Chrome secara penuh.
Juga dikenal sebagai protostatis/unbrowser, unbrowser, pyunbrowser
- Stars
- 17
- Tools
- —
- Unduhan, 30 hari
- 551
- Versi terbaru
- 0.0.21
- Commit terakhir
- 21 Agu 2026
- Lisensi
- Apache-2.0
Apa itu unbrowser MCP?
Menyediakan web runtime non-visual yang ringan untuk agent yang dapat menangani cookies, state DOM, dan HTML forms tanpa perlu instalasi Chrome secara penuh.
Ringkasan dibuat dari README proyek
Tentang unbrowser MCP server
unbrowser menyediakan web runtime non-visual yang ringan yang dirancang khusus untuk AI agents yang membutuhkan kapabilitas lebih dari sekadar HTTP fetch sederhana, namun dengan overhead yang lebih rendah dibandingkan instalasi Chrome penuh. Ia berfungsi sebagai jalan tengah yang stateful untuk menjaga cookies, mengelola state DOM, serta menangani HTML forms dan link dalam sebuah sesi. Developer dapat men-deploy-nya secara lokal melalui native binary, package Python bernama pyunbrowser, atau melalui Docker image distroless.
User terhubung ke server melalui MCP menggunakan stdio atau dengan memanfaatkan shared Streamable HTTP endpoint untuk keperluan testing. Runtime ini menyertakan tools seperti navigate, query, dan extract untuk membantu agent berinteraksi dengan konten web. Ia memiliki engine QuickJS yang terbatas untuk mengeksekusi script halaman ketika HTML statis tidak mencukupi, meskipun ini bukan pengganti engine V8 yang lengkap. Saat agent menghadapi tantangan interaktif yang kompleks atau single-page applications yang berat, server akan memberikan sinyal spesifik untuk menyarankan agar tugas tersebut dialihkan ke browser asli.
Apa yang bisa Anda lakukan dengannya
- 1Navigasi web forms yang kompleksRuntime ini memungkinkan agent untuk mengelola sesi yang mencakup persistensi cookie dan kemampuan untuk mengirimkan form GET atau POST.
- 2Deteksi kebutuhan anti-bot atau SPAServer akan menginformasikan agent ketika sebuah situs memerlukan browser penuh dengan memberikan sinyal terkait tantangan (challenges) atau halaman kosong (empty shells).
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal unbrowser MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal unbrowser MCP di Claude Code
$ claude mcp add unbrowser -- uvx pyunbrowserInstal unbrowser MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}Instal unbrowser MCP di VS Code
.vscode/mcp.json
{
"servers": {
"unbrowser": {
"type": "stdio",
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}Instal unbrowser MCP di VS Code CLI
$ code --add-mcp '{"name":"unbrowser","type":"stdio","command":"uvx","args":["pyunbrowser"]}'Instal unbrowser MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}Instal unbrowser MCP di Codex
$ codex mcp add unbrowser -- uvx pyunbrowserInstal unbrowser MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.unbrowser] command = "uvx" args = ["pyunbrowser"]
Instal unbrowser MCP di Gemini CLI
$ gemini mcp add -s user unbrowser uvx -- pyunbrowserInstal unbrowser MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"unbrowser": {
"command": "uvx",
"args": [
"pyunbrowser"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauprotostatis/unbrowser is public and reachablegithub.com/protostatis/unbrowser ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyapyunbrowser names protostatis/unbrowser as sourcepypi.org/project/pyunbrowser/ ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for pyunbrowserpypi.org/project/pyunbrowser/ ↗Lolos
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-08-21github.com/protostatis/unbrowser ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from pyunbrowserLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubunbrowser
The cheap browser pass for agents. One native binary. No Chrome.
Official MCP Registry identity: mcp-name: io.github.protostatis/unbrowser
unbrowser is a stateful, non-visual web runtime for agents. It sits between curl/WebFetch and a real browser: it retains cookies and DOM state, returns queryable element refs, handles links and HTML forms, detects challenge and SPA signals, and can run bounded QuickJS page scripts when static HTML is not enough.
Default
navigateis 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.
Try the live public-web demo before installing. It accepts only the fixed public source sets shown on the page; do not send private data, cookies, or authenticated tasks through it. A shared Streamable HTTP MCP endpoint is available at https://unchainedsky.com/unbrowser-mcp for public smoke tests; production sessions should use a local install.
Use unbrowser only on sites, accounts, and data you are permitted to access.
Challenge detection and cookie import do not grant permission to bypass access
controls or site terms. Treat session cookies as credentials: keep them local,
scope them to the authorized task, and never send them to the public demo.
Pick the right tier
| Need | curl / WebFetch | unbrowser | Real Chrome |
|---|---|---|---|
| Static / SSR HTML | raw response | structured BlockMap + DOM queries | full browser |
| Cookies, links, HTML forms | DIY | built in | built in |
| Client-side page scripts | ❌ | bounded QuickJS, opt-in | V8 |
| Pixels, Canvas, WebGL, Workers, extensions | ❌ | ❌ | ✅ |
| Agent-oriented output | DIY parsing | element refs, page signals, structured extraction | DIY CDP / DOM parsing |
| Interactive access challenge | ❌ | detect + stop or escalate | authorized browser / human confirmation |
Use unbrowser when 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.
Quick start
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.Z or an image digest in production.
Python
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/python3 is 3.9 and cannot install the wheel; use pipx or a Homebrew Python. The PyPI distribution is pyunbrowser, while the import and executable remain unbrowser.
MCP
{
"mcpServers": {
"unbrowser": {
"command": "unbrowser",
"args": ["--mcp"]
}
}
}
Minimal surface: add "--mcp-profile", "minimal" to expose only navigate/query/extract/help and let the agent discover the rest via help(topic). The Python wrapper ships a 3-tool smart server (search/open/help) as the unbrowser-smart console script.
{
"mcpServers": {
"unbrowser": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"ghcr.io/protostatis/unbrowser:latest"
]
}
}
}
See installation and interface reference for Cargo, release archives, source builds, persistent shell sessions, raw JSON-RPC, and all MCP options.
What an agent gets
navigatereturns a BlockMap: page title, landmarks, headings, interactives, density signals, and an ASCII outline. Its size is page-dependent; it is structured for planning rather than a fixed-token promise.- Stable element refs (
e:142): query an element once, thenclick,type, orsubmitit without re-parsing HTML. - Stateful cookies and forms: cookie jar, GET and URL-encoded POST form submission, links, and redirects persist within a session.
- Page and challenge signals:
density.likely_js_filled,thin_shell, andchallenge.providertell an agent whether to run scripts, inspect embedded data, stop, or escalate to an authorized browser session. - Routing aids on every result:
micro_hint(the single next concrete step),next_tools(ranked candidates),avoid(tools with nothing to act on), and a stableescalationtaxonomy (challenge,thin_shell,partial_result, …) with retryable/severity/evidence — recommendations never contradictavoid. - Structured helpers: route discovery, card extraction, table normalization,
text_main, and selector debugging cover common extraction workflows.
Script mode and escalation
{"id":1,"method":"navigate","params":{"url":"https://example.com","exec_scripts":true}}
With exec_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.
Escalate to unchainedsky-cli or Unchained when a permitted task needs real pixels, Canvas/WebGL, Workers, browser extensions, V8 compatibility, an authenticated profile, or human confirmation. When the user has already established an authorized session in Chrome, cookies_set can import the required session cookie locally until it expires; it is not a license to circumvent a site's controls.
Documentation
| Need | Read |
|---|---|
| Install paths, session CLI, one-shot CLI, raw RPC, MCP, shims, full RPC table | Usage reference |
| Script compatibility, SPA signals, challenge handling, authorized cookie handoff, escalation | Compatibility and escalation |
| Distribution and supported directory listings | Distribution notes |
| Build the native binary | Build instructions |
License
Apache-2.0 — see LICENSE.
Pertanyaan tentang unbrowser MCP
Bagaimana cara menambahkan unbrowser MCP ke Claude Code?
Jalankan claude mcp add unbrowser -- uvx pyunbrowser di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan unbrowser MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah bisa mengeksekusi JavaScript?
Ya, ia dapat menjalankan script halaman QuickJS yang terbatas jika diaktifkan melalui parameter exec_scripts, meskipun ini bukan engine V8 yang lengkap.
Kapan saya sebaiknya menggunakan browser Chrome asli sebagai gantinya?
Anda sebaiknya beralih ke browser asli jika membutuhkan rendering pixel, Canvas, WebGL, workers, extensions, atau kompatibilitas V8 dengan fidelitas tinggi.
Bagaimana cara menginstalnya menggunakan Python?
Anda dapat menginstalnya via pipx menggunakan 'pipx install pyunbrowser' atau via pip menggunakan 'pip install pyunbrowser'.