zendriver-rs

Async-first, undetectable browser automation via the Chrome DevTools Protocol — drive real Chrome from Rust, or hand the keys to an LLM agent over the Model Context Protocol.

A Rust port of zendriver. Drives Chrome via raw CDP — no WebDriver, no JS shim — with anti-detection patches baked in by default.

📖 User guide & full documentation → · 🦀 API reference (docs.rs) → · 🤖 MCP server for AI agents →

Quick example

use zendriver::Browser;

#[tokio::main]
async fn main() -> zendriver::Result<()> {
    let browser = Browser::builder().headless(true).launch().await?;
    let tab = browser.main_tab();

    tab.goto("https://example.com").await?;
    tab.wait_for_load().await?;

    // Find by visible text (auto-waits up to the selector's timeout).
    let link = tab.find().text("More information...").one().await?;
    link.click().await?;
    tab.wait_for_load().await?;

    // Read back from the page's main world.
    let title: String = tab.evaluate_main("document.title").await?;
    println!("title: {title}");

    browser.close().await?;
    Ok(())
}

More working examples in crates/zendriver/examples/.

Feature matrix

Separate binary crate (not a feature on zendriver):

Install

Pick the use case that matches what you're building.

Just browse:

cargo add zendriver

Default stealth is on.

Stealth scraping (explicit):

cargo add zendriver --features stealth

Same as above — only spell out the feature if you want it visible in Cargo.toml.

Everything:

cargo add zendriver --features "interception expect cloudflare fetcher"

Adds request interception, expect() matchers, Cloudflare Turnstile bypass, and the Chrome for Testing fetcher.

Drive a stealth browser from your AI agent

zendriver-mcp is a first-class Model Context Protocol server that hands the entire zendriver-rs surface to any LLM client — Claude Desktop, Claude Code, Cursor, or your own agent loop. 49 tools, two transports (stdio + streamable HTTP), and the same stealth-by-default fingerprinting baked into the lib. Unlike generic browser MCP servers, this one bypasses Cloudflare Turnstile, ships an isolated-world JS eval that survives anti-bot detection, and lets agents persist auth state across sessions.

cargo install zendriver-mcp

Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "zendriver": {
      "command": "zendriver-mcp"
    }
  }
}

What agents get out of the box:

• Stealth navigation — browser_open, browser_goto, browser_back/forward/reload, browser_wait_for_idle, plus a runtime-swappable browser_set_stealth_profile (auto / native / spoof_macos / spoof_linux / spoof_windows)
• Selector-based find + actions — one Selector arg works across browser_find, browser_click, browser_type, browser_press, browser_set_value, browser_upload, etc., with CSS / XPath / visible-text / ARIA-role lookups and per-frame scoping
• Three ways to "see" the page — browser_html (trimmed DOM), browser_screenshot (PNG / JPEG / WebP as inline image content), browser_element_state (visibility / geometry / attrs)
• Stateful primitives agents need for real work — browser_cookies_persist for save/load auth, full browser_storage_*, multi-tab management, frame traversal
• Anti-bot superpowers (gated cargo features, on by default for the published binary):
  • browser_solve_turnstile — Cloudflare Turnstile bypass without a CAPTCHA-solving service
  • browser_intercept_* — block/redirect/respond/modify requests via CDP Fetch.*
  • browser_expect_register / _await — Playwright-style "wait for response/dialog/download" matchers, split across MCP calls so the agent can act in between
  • browser_install_chrome — pull a pinned Chrome-for-Testing build on demand
• Actionable errors — every error carries an _meta.suggested_next hint pointing the agent at the right recovery tool (e.g. ElementNotFound → "try browser_html to inspect")

See the MCP chapter for the full tool reference, CLI flags, HTTP-mode operator notes, and troubleshooting guide.

Phases

Six development phases shipped into the v0.1.0 release. The mdBook covers each surface in depth.

1. Foundation — CDP transport + minimal Browser/Tab/Element. See introduction.
2. Stealth — fingerprint patches + isolated worlds + stealth JS bundle. See stealth.
3. Element API completeness — CSS/XPath/text/role selectors, actionability, input controller, screenshots. See quickstart.
4. Tab/Browser completeness — multi-tab, cookies, storage, frames, nav history, wait_for_idle. See multi-tab + frames.
5. Optional gated features — request interception, expect() matchers, Cloudflare bypass, Chrome-for-Testing fetcher. See interception, expect, cloudflare, fetcher.
6. Polish + release — trait extraction, rustdoc + mdBook, publish to crates.io.

Comparison

Subjective rows marked *opinion. All claims accurate as of the 0.1.0 release; check upstream changelogs before relying on them.

Contributing

See CONTRIBUTING.md. Issues and PRs welcome.

License

Dual-licensed under MIT (LICENSE-MIT) and Apache-2.0 (LICENSE-APACHE) at your option.