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

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 MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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