B4n1Web

Ultra-lightweight browser engine for AI agents. 33 MCP tools, 4 SDKs, cross-platform.

AI & MLPythonv0.12.2
B4n1Web

🌐 B4n1Web — Agentic Browser Engine

Ultra-lightweight headless browser for AI agents.

License PyPI npm NuGet Maven Central Docs

PyPI Downloads/month npm Downloads/month NuGet Downloads GitHub Release GitHub Downloads

Single Rust binary · 4 language SDKs · 33 MCP tools. Navigate URLs, extract structured content (markdown, links, screenshots), and build autonomous agent workflows.

📖 Full documentation: https://B4N1-com.github.io/b4n1-web/


🌍 Languages / Idiomas / 语言

🇬🇧 English🇪🇸 Español🇫🇷 Français🇩🇪 Deutsch🇵🇹 Português🇮🇹 Italiano
🇨🇳 简体中文🇯🇵 日本語🇰🇷 한국어🇷🇺 Русский🇸🇦 العربية🇮🇳 हिन्दी

🖥 Platform Support

8 pre-compiled binaries — works everywhere:

PlatformArchitecturesBinary
Linuxx86_64, aarch64, i686musl (static, no glibc)
macOSx86_64, arm64universal
Windowsx86_64, arm64, i686MSVC

Quick Start

# Install the binary
curl -sL https://raw.githubusercontent.com/B4N1-com/b4n1-web/master/scripts/install.sh | bash

# Or use your preferred package manager
pip install b4n1-web
npm install b4n1-web
dotnet add package B4n1Web
# Java: add dependency from Maven Central
from b4n1web import AgentBrowser

browser = AgentBrowser()
page = browser.goto("https://example.com")
print(page.markdown)
browser.close()

MCP Server

# stdio mode (default)
b4n1web mcp
npx b4n1-web mcp
uvx b4n1-web mcp

SDK Matrix

LanguagePackageVersionBinary
Pythonb4n1-web0.13.0Bundled (musl)
JavaScript/TypeScriptb4n1-web0.13.0Bundled (musl)
Javacom.b4n1:b4n1-web0.13.0Bundled (musl)
C# (.NET)B4n1Web0.13.0Bundled (musl)

Browser Modes

ModeDescriptionRAMStartup
LightHTTP fetch + HTML parsing~15MBInstant
JSLight + JavaScript extraction~15MBInstant
RenderFull Chromium + screenshots~100MB~2s

Features

  • 33 MCP tools for AI agent integration
  • 4 language SDKs (Python, JS, Java, C#) with bundled binary
  • Self-contained binary ~12MB, no dependencies
  • Static linking (musl) — works on any Linux, no glibc required
  • Three modes: Light (instant), JS (scripts), Render (Chromium)
  • Security shield: domain filtering, safe browsing
  • Network interception: block resources, mock responses
  • MCP Server: stdio transport, no port needed

Documentation

Links

License & Commercial Terms

  • Original Source Code: 100% Proprietary and Closed Source (All Rights Reserved by Bani Montoya).
  • Binaries & SDK Tools: Provided under the Business Source License 1.1 (BSL 1.1).
    • Free Tier: 100% free for development, evaluation, testing, personal projects, and startups with gross annual revenue < $100,000 USD.
    • Mandatory Enterprise B2B License: Required for government agencies, public bidding projects, and enterprises with gross annual revenue >= $100,000 USD.

For Enterprise B2B licensing inquiries, visit https://b4n1.com/licensing or email b4n1@b4n1.com.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y b4n1-web

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-b4n1-com-b4n1web": {
      "command": "npx",
      "args": [
        "-y",
        "b4n1-web"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

b4n1-webnpm

Compatible MCP Clients

B4n1Web works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More