SZ

shubhamchoulkar/zendriver-mcp

浏览器自动化

本页由 AI 翻译,技术细节请以原文为准。 查看原文

6 stars 6 forks 质量 56 趋势 18

Undetectable browser automation MCP server for LLM agents. Uses Chrome DevTools Protocol to bypass bot detection (Cloudflare, Akamai).

概览

A powerful MCP (Model Context Protocol) server for browser automation using Zendriver - an undetectable, async-first browser automation framework. Built specifically for LLM-powered automation with a focus on . Most browser automation tools (Selenium, Playwright, Puppeteer) use WebDriver protocol, which is easily detected by anti-bot systems. - Automating sites with bot protection (Cloudflare, Akamai, etc.) - Scraping dynamic SPAs that block traditional automation - Testing authenticated workflows on protected sites - Building AI agents that interact with the real web - - Uses Chrome DevTools Protocol, bypassing WebDriver detection - - 78% reduction in token usage vs raw HTML - - Focused, powerful browser automation capabilities - - Works with contenteditable divs, SPAs, and dynamic content - - Auto-skips hidden elements, provides selector suggestions - - Real-time network request and console log capture, its super easy to create endpoint based scrappers as llms can directly access...

README

以下为原文 README 节选,完整内容请查看原文。

Zendriver-MCP

A powerful MCP (Model Context Protocol) server for browser automation using Zendriver - an undetectable, async-first browser automation framework. Built specifically for LLM-powered automation with a focus on token efficiency.

Why Zendriver?

Most browser automation tools (Selenium, Playwright, Puppeteer) use WebDriver protocol, which is easily detected by anti-bot systems. Zendriver is different:

Feature WebDriver-based Zendriver
Detection Easily detected via navigator.webdriver Undetectable - no WebDriver flags
Protocol WebDriver (standardized, detectable) CDP (Chrome DevTools Protocol)
Async Sync-first, async bolted on Async-first architecture
Bot Protection Blocked by Cloudflare, PerimeterX, etc. Bypasses most protections

Use cases where Zendriver is better than others:

  • Automating sites with bot protection (Cloudflare, Akamai, etc.)
  • Scraping dynamic SPAs that block traditional automation
  • Testing authenticated workflows on protected sites
  • Building AI agents that interact with the real web

Features

  • Undetectable - Uses Chrome DevTools Protocol, bypassing WebDriver detection
  • Token-Optimized DOM Walker - 78% reduction in token usage vs raw HTML
  • 35+ Essential Tools - Focused, powerful browser automation capabilities
  • Modern Web Support - Works with contenteditable divs, SPAs, and dynamic content
  • Smart Element Handling - Auto-skips hidden elements, provides selector suggestions
  • CDP Network Logging - Real-time network request and console log capture, its super easy to create endpoint based scrappers as llms can directly access the network logs
  • Security Auditing - Comprehensive security analysis tool

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "zendriver": {
      "command": "python",
      "args": ["path/to/Zendriver-MCP/run.py"]
    }
  }
}

Token Optimization Protocol

The Problem

Traditional approaches send raw HTML or verbose element trees to LLMs:


The Solution

Our DOM walker produces compact, semantic output:

{"id": 1, "t": "btn", "l": "Search", "r": "hdr"}

Optimization Techniques

Technique Before After Reduction
Compact Keys tagName, label, region t, l, r ~60%
Smart Labels “(unlabeled)” everywhere Inferred from aria/text/placeholder ~40% fewer elements
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "zendriver": { "command": "python", "args": ["path/to/Zendriver-MCP/run.py"] } } }