Pydoll Antibot Bypasser

用于隐蔽浏览器自动化与 WAF 绕过的 Claude Code 插件

安装说明 · 核心能力 · 使用方法 · 插件结构 · 中文说明

## 这是什么？ 一个 **Claude Code 插件**，它教会 Claude 如何使用 [Pydoll](https://github.com/autoscrape-labs/pydoll) 编写隐蔽的浏览器自动化脚本——一个异步原生、零 WebDriver 依赖的 Chromium 自动化库，专精于绕过 WAF 防护和反机器人检测系统。 当你要求 Claude Code 绕过 Cloudflare、爬取受保护的网站或进行反检测浏览器自动化时，此技能会自动激活。 ## 安装说明 ### 插件市场安装（推荐） 本仓库是一个自包含的[插件市场](https://code.claude.com/docs/en/plugin-marketplaces)。添加并安装： ``` # 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 ``` ### 从 GitHub 安装 ``` /plugin install github:Esonhugh/pydoll-cf-waf-bypasser-skills ``` ### 手动安装 ``` 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/ ``` ### 团队配置 添加到项目的 `.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 } } ``` ## 核心能力 | 能力 | 描述 | |:---|:---| | **Cloudflare Turnstile** | 自动检测并解决 Turnstile 验证码，支持无头模式 | | **Cloudflare Managed Challenge** | 通过 `headless=False` + xvfb 在服务器上绕过 | | **Cloudflare JS Challenge** | 自动执行 JavaScript 挑战 | | **人性化交互** | 贝塞尔曲线鼠标移动、打字错误模拟、随机延迟 | | **Shadow DOM 访问** | 穿透关闭的 Shadow Root 获取隐藏元素 | | **浏览器指纹伪装** | 伪造使用时间、WebRTC 泄露防护、语言伪装 | | **并发爬取** | 异步原生，多标签页并行执行 | | **请求拦截** | 阻止图片/CSS/字体以加速页面加载 | ## 使用方法 安装后，直接用自然语言向 Claude Code 提问： ``` > 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 会生成可直接运行的脚本，使用 [uv](https://docs.astral.sh/uv/) 的内联脚本元数据： ``` uv run script.py # Auto-installs dependencies and runs ``` ### 核心概念 ``` # 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) ``` ### 代码模板 `scripts/templates.py` 中包含 8 个模板： | 模板 | 用途 | |:---|:---| | `basic_browser` | 最小化浏览器配置 | | `bypass_cloudflare` | Cloudflare WAF 绕过 | | `web_scraping` | 带资源拦截的数据提取 | | `form_filling` | 人性化表单提交 | | `hybrid_automation` | UI 登录 + API 调用 | | `screenshot` | 批量截图捕获 | | `concurrent_scraping` | 并行页面爬取 | | `stealth_browser` | 完整反检测配置 | ## 插件结构 本仓库作为一个**市场**，包含一个插件。它遵循 [Claude Code 插件市场规范](https://code.claude.com/docs/en/plugin-marketplaces)。 ``` 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"] } ``` ## 环境要求 | 依赖 | 版本 | |:---|:---| | Python | >= 3.10 | | Chrome / Chromium | 最新稳定版 | | [uv](https://docs.astral.sh/uv/)（推荐） | 最新 | 服务器 / Docker 环境需要额外依赖： ``` # 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 ``` ## 免责声明 此插件仅用于**授权的安全测试、教育目的和合法的网页自动化**。用户有责任遵守目标网站的服务条款和适用法律。请始终遵守 `robots.txt` 和速率限制。 ## 中文说明 ### 简介 这是一个 **Claude Code 插件**，让 Claude 掌握如何使用 [Pydoll](https://github.com/autoscrape-labs/pydoll) 编写隐蔽浏览器自动化脚本。Pydoll 是一个异步原生、零 WebDriver 依赖的 Chromium 自动化库，专精于绕过 WAF 防护和反机器人检测系统。 当你要求 Claude Code 绕过 Cloudflare、爬取受保护网站、或进行反检测浏览器自动化时，此技能会自动激活。 ### 安装方式 **方式一：插件市场安装（推荐）** 本仓库是一个自包含的[插件市场](https://code.claude.com/docs/en/plugin-marketplaces)。添加并安装： ``` # 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 } } ``` ### 核心能力 | 能力 | 说明 | |:---|:---| | **Cloudflare Turnstile** | 自动检测并解决 Turnstile 验证码，支持无头模式 | | **Cloudflare Managed Challenge** | 通过 `headless=False` + xvfb 绕过 | | **Cloudflare JS Challenge** | 自动执行 JavaScript 挑战 | | **人性化交互** | 贝塞尔曲线鼠标轨迹、打字错误模拟、随机延迟 | | **Shadow DOM 访问** | 穿透关闭的 Shadow Root 获取隐藏元素 | | **浏览器指纹伪装** | 伪造使用时间、WebRTC 泄露防护、语言伪装 | | **并发爬取** | 100% 异步，多标签页并行执行 | | **请求拦截** | 屏蔽图片/CSS/字体加速加载 | ### WAF 支持 | WAF 厂商 | 状态 | 备注 | |:---|:---:|:---| | Cloudflare Turnstile | ✅ 完全支持 | 支持无头模式 | | Cloudflare JS Challenge | ✅ 完全支持 | 自动执行 JS | | Cloudflare Managed Challenge | ✅ 已验证 | 需要 `headless=False` + xvfb | | DataDome | ⚠️ 部分支持 | 需要高质量代理 | | PerimeterX | ⚠️ 部分支持 | 需要随机化行为 | | Akamai Bot Manager | ⚠️ 部分支持 | TLS 指纹敏感 | ### 快速上手 安装后直接向 Claude Code 提问： ``` > 绕过 Cloudflare 访问 https://example.com 并获取页面标题 > 用反检测模式爬取受保护的网站数据 > 写一个带人性化行为模拟的隐蔽爬虫 ``` Claude 会生成可直接运行的脚本： ``` uv run script.py # 自动安装依赖并运行 ``` ### 代码模板 8 个即用模板（`scripts/templates.py`）： | 模板 | 用途 | |:---|:---| | `basic_browser` | 最小化浏览器配置 | | `bypass_cloudflare` | Cloudflare WAF 绕过 | | `web_scraping` | 带资源拦截的数据提取 | | `form_filling` | 人性化表单填写 | | `hybrid_automation` | UI 登录 + API 调用 | | `screenshot` | 批量截图 | | `concurrent_scraping` | 并行页面爬取 | | `stealth_browser` | 完整反检测配置 | ### 环境要求 | 依赖 | 版本 | |:---|:---| | Python | >= 3.10 | | Chrome / Chromium | 最新稳定版 | | [uv](https://docs.astral.sh/uv/)（推荐） | 最新 | 服务器 / Docker 环境额外依赖： ``` apt-get install -y xvfb xvfb-run -a --server-args="-screen 0 1920x1080x24" uv run script.py ``` ### 免责声明 此插件仅用于**授权安全测试、教育目的和合法的网页自动化**。用户有责任遵守目标网站的服务条款和相关法律法规。请始终遵守 `robots.txt` 和速率限制。 ## 参考资料 - [Pydoll](https://github.com/autoscrape-labs/pydoll) · [文档](https://pydoll.tech/) · [中文文档](https://autoscrape-labs.github.io/pydoll/) - [Claude Code 插件市场](https://code.claude.com/docs/en/plugin-marketplaces) · [创建插件](https://code.claude.com/docs/en/plugins)

_{由 Esonhugh 构建}

标签：Chromium自动化, Claude Code插件, Cloudflare绕过, Pydoll框架, Python自动化, URL抓取, WAF绕过, Web安全, Web爬虫, 人机验证绕过, 反机器人检测, 反检测技术, 在线服务绕过, 异步编程, 插件开发, 数字取证, 数据抓取, 浏览器自动化, 网络安全, 自动化脚本, 蓝队分析, 逆向工具, 隐私保护, 隐身浏览器