esonhugh/pydoll-cf-waf-bypasser-skills

Pydoll Antibot Bypasser

Claude Code Plugin for Stealth Browser Automation & WAF Bypass

Installation · Sponsor · Capabilities · Usage · Structure · 中文说明

---

What is this?

A Claude Code Plugin that teaches Claude how to write stealth browser automation scripts using Pydoll — an async-native, zero-WebDriver Chromium automation library specialized in bypassing WAF protections and bot detection systems.

When you ask Claude Code to bypass Cloudflare, scrape a protected website, or automate a browser with anti-detection, this skill activates automatically.

---

Installation

Marketplace Install (Recommended)

This repository is a self-contained plugin marketplace. Add it and install:

# Step 1: Register the marketplace
/plugin marketplace add esonhugh/pydoll-cf-waf-bypasser-skills

# Step 2: Install the plugin
/plugin install pydoll-antibot-bypasser@pydoll-cf-waf-bypasser-skills

Install from GitHub

/plugin install github:Esonhugh/pydoll-cf-waf-bypasser-skills

Manual Install

git clone https://github.com/Esonhugh/pydoll-cf-waf-bypasser-skills.git

# Project-level (current project only)
cp -r pydoll-cf-waf-bypasser-skills/plugins/pydoll-antibot-bypasser/skills/pydoll-antibot-bypasser \
      your-project/.claude/skills/

# Or global (all projects)
cp -r pydoll-cf-waf-bypasser-skills/plugins/pydoll-antibot-bypasser/skills/pydoll-antibot-bypasser \
      ~/.claude/skills/

Team Configuration

Add to your project’s .claude/settings.json so team members are auto-prompted to install:

{
  "extraKnownMarketplaces": {
    "pydoll-cf-waf-bypasser-skills": {
      "source": {
        "source": "github",
        "repo": "Esonhugh/pydoll-cf-waf-bypasser-skills"
      }
    }
  },
  "enabledPlugins": {
    "pydoll-antibot-bypasser@pydoll-cf-waf-bypasser-skills": true
  }
}

---

Sponsor

Wait for u

---

Capabilities

WAF Support Matrix

---

Usage

Once installed, just ask Claude Code in natural language:

> Bypass Cloudflare on https://example.com and get the page title

> Scrape data from a protected website with anti-detection

> Write a stealth scraper with human-like behavior

Claude generates ready-to-run scripts using uv inline script metadata:

uv run script.py   # Auto-installs dependencies and runs

Core Concept

# Zero WebDriver — navigator.webdriver is undefined, not false
async with Chrome(options=options) as browser:
    tab = await browser.start()

    # One-line Cloudflare bypass
    async with tab.expect_and_bypass_cloudflare_captcha():
        await tab.go_to('https://protected-site.com')

    # Human-like typing with typo simulation
    await input_el.type_text('Hello', humanize=True)

    # Human-like mouse movement via Bezier curves
    await tab.mouse.click(500, 300, humanize=True)

Code Templates

8 templates included in scripts/templates.py:

---

Plugin Structure

This repository serves as a marketplace containing one plugin. It follows the Claude Code plugin marketplace specification.

pydoll-cf-waf-bypasser-skills/
├── .claude-plugin/
│   └── marketplace.json                         # Marketplace catalog
├── plugins/
│   └── pydoll-antibot-bypasser/                 # Plugin root
│       ├── .claude-plugin/
│       │   └── plugin.json                      # Plugin manifest
│       └── skills/
│           └── pydoll-antibot-bypasser/
│               ├── SKILL.md                     # Skill definition & API reference
│               ├── knowledge/
│               │   └── anti_detection.md        # Anti-detection best practices
│               ├── scripts/
│               │   └── templates.py             # 8 code templates
│               └── examples/
│                   ├── bypass_cloudflare.py
│                   ├── bypass_managed_challenge.py
│                   ├── stealth_scraper.py
│                   ├── concurrent_scraper.py
│                   └── screenshot.py
└── README.md

marketplace.json

{
  "name": "pydoll-cf-waf-bypasser-skills",
  "owner": { "name": "Esonhugh" },
  "plugins": [
    {
      "name": "pydoll-antibot-bypasser",
      "source": "./plugins/pydoll-antibot-bypasser",
      "description": "Stealth browser automation skill using Pydoll..."
    }
  ]
}

plugin.json

{
  "name": "pydoll-antibot-bypasser",
  "version": "1.0.0",
  "description": "Stealth browser automation skill using Pydoll...",
  "author": { "name": "Esonhugh" },
  "license": "MIT",
  "keywords": ["cloudflare", "waf-bypass", "antibot", "stealth", "pydoll"]
}

---

Requirements

For server / Docker environments:

# Required for Managed Challenge bypass
apt-get install -y xvfb

# Run with virtual display
xvfb-run -a --server-args="-screen 0 1920x1080x24" uv run script.py

---

Disclaimer

This plugin is provided for authorized security testing, educational purposes, and legitimate web automation only. Users are responsible for complying with target websites’ Terms of Service and applicable laws. Always respect robots.txt and rate limits.

---

中文说明

简介

这是一个 Claude Code 插件，让 Claude 掌握如何使用 Pydoll 编写隐蔽浏览器自动化脚本。Pydoll 是一个异步原生、零 WebDriver 依赖的 Chromium 自动化库，专精于绕过 WAF 防护和反机器人检测系统。

当你要求 Claude Code 绕过 Cloudflare、爬取受保护网站、或进行反检测浏览器自动化时，此技能会自动激活。

安装方式

方式一：插件市场安装（推荐）

本仓库是一个自包含的插件市场。添加并安装：

# 1. 注册市场源
/plugin marketplace add esonhugh/pydoll-cf-waf-bypasser-skills

# 2. 安装插件
/plugin install pydoll-antibot-bypasser@pydoll-cf-waf-bypasser-skills

方式二：从 GitHub 安装

/plugin install github:Esonhugh/pydoll-cf-waf-bypasser-skills

方式三：手动安装

git clone https://github.com/Esonhugh/pydoll-cf-waf-bypasser-skills.git

# 项目级安装
cp -r pydoll-cf-waf-bypasser-skills/plugins/pydoll-antibot-bypasser/skills/pydoll-antibot-bypasser \
      your-project/.claude/skills/

# 或全局安装
cp -r pydoll-cf-waf-bypasser-skills/plugins/pydoll-antibot-bypasser/skills/pydoll-antibot-bypasser \
      ~/.claude/skills/

方式四：团队配置

在项目的 .claude/settings.json 中添加，团队成员信任项目时自动提示安装：

{
  "extraKnownMarketplaces": {
    "pydoll-cf-waf-bypasser-skills": {
      "source": {
        "source": "github",
        "repo": "Esonhugh/pydoll-cf-waf-bypasser-skills"
      }
    }
  },
  "enabledPlugins": {
    "pydoll-antibot-bypasser@pydoll-cf-waf-bypasser-skills": true
  }
}

核心能力

WAF 支持

快速上手

安装后直接向 Claude Code 提问：

> 绕过 Cloudflare 访问 https://example.com 并获取页面标题

> 用反检测模式爬取受保护的网站数据

> 写一个带人性化行为模拟的隐蔽爬虫

Claude 会生成可直接运行的脚本：

uv run script.py   # 自动安装依赖并运行

代码模板

8 个即用模板（scripts/templates.py）：

环境要求

服务器 / Docker 环境额外依赖：

apt-get install -y xvfb
xvfb-run -a --server-args="-screen 0 1920x1080x24" uv run script.py

免责声明

此插件仅用于授权安全测试、教育目的和合法的网页自动化。用户有责任遵守目标网站的服务条款和相关法律法规。请始终遵守 robots.txt 和速率限制。

---

References

• Pydoll · Docs · 中文文档

• Claude Code Plugin Marketplaces · Create Plugins

  Built by Esonhugh