mrkeyoor.com_
Tue 01 Sept 17:40 UTC
AI Toolsevaluationupdated 27 Aug 2026

webbrain review

WebBrain is an open-source browser extension that lets an AI model read pages, answer questions, and carry out browser tasks in the tabs you already use. It can use its managed model, a cloud API, or a local OpenAI-compatible server, and it also lets coding agents delegate browser work through MCP.

+59stars / 7d
Verdict

Our WebBrain checkout installed 4 packages in 11 seconds and passed its available tests in 74 seconds, with 0 npm audit findings. Use it when an agent must work in the signed-in browser session you already have, especially through a local model or MCP client. Prefer Chromium, review data settings, and keep Act or Dev mode away from consequences you cannot reverse.

We ran it

Lab card: what happened when we ran webbrainScreenshot of webbrain (webbrain.one)
Install✓ · 11s4 packages · 19 MB
Buildn/ano build script
Tests✓ · 74sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo9892 files~388,965 lines of source · 413.6 MB · 6 CI workflows · tests dir

Answers from our run

Does webbrain build from source?

Dependencies installed in 11 seconds (4 packages), and the project has no separate build step. We cloned commit a648c60 into a clean Debian container with 3 CPUs and no project-specific setup.

Do webbrain's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does webbrain have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use webbrain?

Firefox users who need the full feature set: the README says Firefox lacks trusted mouse events, closed shadow-root access, full-page CDP screenshots, and reliable handling for some single-page app navigation.

What are the alternatives to webbrain?

Browser Use, Stagehand, Playwright MCP. Our WebBrain checkout installed 4 packages in 11 seconds and passed its available tests in 74 seconds, with 0 npm audit findings.

Setup4/5Store install is easy; local models and MCP add moving parts
Docs5/5Detailed guides cover providers, permissions, privacy, tools, and MCP
Community4/5Recent releases, current pushes, and an actively updated work queue
Maturity3/5Capable today, with a fast release pace and meaningful browser limits

Who it’s for

Developers who want an agent inside their existing signed-in Chrome or Edge session.
Local-model users who need browser automation through Ollama, llama.cpp, LM Studio, or another OpenAI-compatible server.
Teams that want permission prompts before an agent clicks, types, downloads, or changes a page.
Claude Code, Codex, or Cursor users who need an MCP bridge to a real interactive browser.

Who it’s NOT for

Firefox users who need the full feature set: the README says Firefox lacks trusted mouse events, closed shadow-root access, full-page CDP screenshots, and reliable handling for some single-page app navigation.
Security-sensitive users who are uncomfortable giving an agent access to every site where their browser session is authenticated: the security guide says the agent acts with the user's browser permissions.
Teams that require strict prevention of secret disclosure: the security guide says strict secret mode cannot guarantee protection when a model reads a secret from ordinary page text and ignores its instructions.
Organizations that cannot accept GPL-3.0-or-later for distributed extension code: releases from 33.0.0 onward use that license.
Users who need several bridge clients attached at once: the extension holds one bridge socket, so Cloud, MCP, and the LM Studio plugin cannot stay connected together.

Setup reality

Our fresh Node 22 sandbox installed 4 packages in 11 seconds and used 19 MB. The repository had 9,892 files and about 388,965 lines of source in a 413.6 MB checkout. There was no generic build script or target, so that step was skipped. Tests completed successfully in 74 seconds, and npm audit found 0 known vulnerabilities.

The easiest path is a signed browser-store extension with WebBrain Cloud. Bring-your-own cloud models need provider credentials. Local models need a running OpenAI-compatible server and enough context capacity; the README recommends at least 16k tokens for normal use.

Source loading is manual: Chrome uses an unpacked extension directory, while Firefox installs a temporary add-on that disappears after restart unless it is signed. MCP browser delegation needs Chromium, a separate local server, and a WebSocket bridge setting. Only one Cloud, MCP, or LM Studio bridge can be active at a time.

Ask reads pages; Act and Dev can change them

WebBrain puts a chat panel inside Chrome, Edge, or Firefox and lets a model inspect the current page. Ask mode reads and answers. Act mode can click, type, navigate, upload, or download. Dev mode adds page source, styles, console data, network diagnostics, and reversible page edits. That separation is useful because browser agents often blur reading and action into one permission choice. WebBrain makes the user choose a mode before a task starts.

The extension works with WebBrain Cloud, direct cloud APIs, and local OpenAI-compatible servers. The provider list is broad, while the local path covers tools such as Ollama, llama.cpp, LM Studio, and vLLM. Context size matters: the README recommends at least 16k tokens, says 8k is suitable only for its Compact tool tier, and calls 4k too small for the prompt and tool definitions. Small local models therefore need deliberate settings rather than a blind endpoint swap.

Why the existing browser session matters

Most browser automation opens a clean profile. That is desirable for repeatable tests, though it becomes awkward when a task sits behind SSO, a saved login, or a client-rendered account page. WebBrain works in the browser session already open on the desktop. A coding agent can ask it to inspect a signed-in dashboard without rebuilding authentication in Playwright.

The MCP server is the clearest expression of that idea. Claude Code, Codex, Cursor, and OpenClaw can delegate a high-level browser task through six tools covering runs, extraction, status, clarification, aborts, and diagnostics. The server does not expose every low-level browser primitive. Permission checks stay inside WebBrain's agent loop, where the extension can ask before a consequential action. Structured extraction also accepts a JSON Schema when a caller needs predictable fields.

There are operational limits. MCP delegation is Chromium-only because it uses an offscreen document. Users must run a local MCP process, point the extension at its WebSocket URL, and keep the process alive. The extension also holds one bridge connection, so switching among WebBrain Cloud, MCP, and the LM Studio plugin means changing the bridge URL rather than leaving all three attached.

What happened when we ran it

We cloned commit a648c60 into a fresh unprivileged Node 22 container with 3 CPUs, 8 GB of RAM, and no secrets. The checkout contained 9,892 files, about 388,965 lines of source, and occupied 413.6 MB. Installation succeeded in 11 seconds, adding 4 packages and using 19 MB on disk.

The repository had no generic build script or target for the lab to run, so we skipped that step. Its test command succeeded in 74 seconds. The npm audit reported 0 known vulnerabilities across critical, high, moderate, and low severities. Those results make the contributor baseline look healthy, although they do not test a live extension against changing websites or judge model accuracy.

Permission design helps, but the risk stays real

The security documentation is refreshingly specific. Page-derived content is marked as untrusted, consequential tools use capability and origin grants, Ask mode stays read-only, and an optional planning step can wait for approval before tools run. The code also includes loop detection, duplicate-submit protection on Chrome, checks for obscured click targets, and handling for credential-shaped fields. These controls reduce common automation mistakes.

They cannot turn an authenticated browser agent into a low-risk utility. The security guide says the agent can do anything the user can do in the browser. A malicious email, document, issue comment, or web page can place instructions in material sent to the model. Permission prompts and untrusted-content wrappers provide layers of resistance, but the model remains part of the decision path. Keep financial, administrative, and production accounts away from casual Act-mode experiments.

Strict secret handling has a stated boundary too. Cloud runs redact values typed into fields or recognized through credential labels. A secret read from ordinary page text may escape that detection, and protection then depends on the model following its prompt. Profile autofill data is stored locally in plain text and sent to the chosen provider when enabled. These are reasons to use a separate browser profile and limit saved credentials.

Privacy also depends on provider choice. Local inference stays on the machine, while direct API use sends page context to the selected provider. WebBrain Cloud's Help Improve setting is on by default and may retain eligible prompts, page text, model output, tool calls, and outcomes. Users who do not want that collection need to disable it. The documentation explains the path clearly, which makes the setting possible to evaluate rather than discover by accident.

Chrome is the intended experience

Firefox gets the shared agent logic and permission gate, but its browser APIs impose real losses. The README names missing trusted mouse events, closed shadow-root traversal, CDP screenshots, stronger retries, and some single-page navigation handling. The security guide adds that Firefox lacks WebMCP, recording, and Chrome's wired duplicate-submit guard. This is a meaningful capability gap for automation on modern web apps.

Release 33.3.0 arrived on August 26, 2026, and the repository was pushed later that day. GitHub showed 6 open issues and pull requests combined, with issue activity through August 25. The release adds broader selection context, fixes selection-restore races, and clarifies trace privacy and retention. The fast release history makes pinning and changelog review sensible for any browser profile used for real work.

WebBrain earns a trial when using the current signed-in browser is the requirement. Its local-model support and MCP bridge widen the ways it can fit into a developer workflow. The right trial uses Chromium, a separate browser profile, Ask mode by default, and explicit review before any action that sends, buys, publishes, or deletes.

Alternatives

ProjectWhat it isPick it when
Browser Use gh↗A Python framework for agents that operate browsers through code and hosted services.pick this instead when browser automation belongs in a Python application rather than a user-installed side panel.
StagehandA TypeScript browser automation SDK that mixes natural-language actions with Playwright.pick this instead when developers need code-owned browser sessions and Playwright-level control.
Playwright MCP gh↗An MCP server that exposes Playwright browser automation to compatible agents.pick this instead when an MCP client needs a fresh automation browser and existing signed-in tabs are unnecessary.

What people are saying

  1. [github-trending] webbrain-one/webbrain

Sources

  1. WebBrain README
  2. WebBrain security model
  3. WebBrain privacy and data flow
  4. WebBrain release 33.3.0
  5. WebBrain issues and pull requests

More ai tools reviews

claudian · SkillSpector · robin · mjlab · MoGe · awesome-design-md · the whole board →