vibatchium MCP server

<!-- Absolute URL on purpose: PyPI renders this same README and cannot resolve repo-relative paths. Pinned to master so it survives tag churn. -->

vibatchium

<!-- mcp-name: io.github.trueoriginlabs/vibatchium -->

Agent-piloted browser automation that clears Cloudflare. Patched Playwright + multi-session daemon + credential vault + vision clicking + prompt-injection safety. One MCP server, N parallel Chromes, persistent per-session profiles. Plus two renderer-free lanes on a Chrome TLS fingerprint: vb search to find URLs without a search API, vb fetch to read them — both with per-request --proxy, because engines and walls both rate-limit per IP.

Where this fits. Both Anthropic and Google now ship an agent that drives

your own signed-in Chrome — Claude in Chrome and Chrome Auto Browse. If that

is what you want, use them: they are free, first-party, and better integrated.

They are also supervised — visible window, real time, and they hand control

back to you at a login wall or a CAPTCHA. vibatchium is for the other half:

unattended, headless, N-at-a-time, on a box with no human in front of it,

against sites that fight automation. That is the whole of the wedge, and it is

worth being precise about which side of it you are on.

pipx install vibatchium             # core: browse / extract / screenshot / N parallel sessions
# want the stealth HTTP lanes (vb fetch, vb search), the credential vault, VLM read, or the REST shim?
pipx install 'vibatchium[all]'      # everything; or pick extras: vibatchium[fetch], [secrets], [llm], [rest]
patchright install chrome
vb setup                    # register MCP + an auto-discoverable skill so agents reach for vb (idempotent)

Core install covers all browsing. vb fetch and vb search (the curlcffi TLS-fingerprint lane) are the [fetch] extra; vb install reports which optional lanes are available. On a uv venv (no pip), add an extra with uv pip install --python /bin/python curlcffi.

Bleeding edge from master: pipx install 'git+https://github.com/trueoriginlabs/vibatchium#egg=vibatchium[all]'

Coding agents (Codex / Cursor / Claude Code): read AGENTS.md first — it has the one-call recipes (explore, research) and the env-discovery traps to skip.

vb explore https://example.com                      # one-call: text-first (screenshot only as a fallback)
vb research --target https://example.com \          # parallel fan-out, N intents
  --intent "pricing model" --intent "customers" --intent "tech stack"

Status: active development, alpha. 1,195 tests green in CI (Linux, Python 3.11–3.13). Apache-2.0 (AGPL only via the opt-in nodriver extra).

Detector scores quoted below (bot.sannysoft, CreepJS, Cloudflare cold-launch) are manual observations, not CI-asserted — no test in the suite gates on them, and they are only as current as the last hand-run. The generated block under Measured scores is the one to trust; it is empty until someone runs it.

Updating

vb update                  # upgrade + bounce the daemon + refresh the agent skill
vb update --version 0.19.0   # or pin a specific version

vb update detects how vibatchium was installed (pipx, uv tool install, a pip-less uv venv, or pip with a PEP-668 --break-system-packages fallback), stops the running daemon so the next command loads the new code, and rewrites the agent skill / docs blocks so a coding agent is actually told about the verbs the new version ships (--no-restart / --no-setup opt out). Manual equivalent:

Shortened. The full README is on GitHub.