Pydoll + CapSolver：隐形网络自动化方案

Pydoll 是一个轻量级、异步的 Python 库，它通过 DevTools 协议（CDP）直接与 Chrome 交互，从而绕过传统的 WebDriver 检测。将其与 CapSolver 结合，您可以构建出强大、难以被察觉的自动化脚本，轻松应对最棘手的验证码挑战。

---

🌟 核心特性

🤖 Pydoll (隐形引擎)

• 无需 WebDriver：直接连接 CDP，消除了常见的机器人检测向量。
• 拟人化交互：真实的按键时间间隔、基于物理学的滚动和自然的鼠标移动。
• 异步架构：基于 asyncio 构建，实现高性能、非阻塞的 I/O。
• 完全控制：拦截网络流量、管理浏览器指纹，并处理多标签页会话。

🧩 CapSolver (验证码解决方案)

• AI 驱动的解决能力：为 reCAPTCHA (v2/v3)、Cloudflare Turnstile、AWS WAF 等提供快速可靠的解决方案。
• 无缝集成：通过简单的 API 调用，在几秒钟内获取令牌并绕过挑战。
• 生产环境就绪：专为高容量自动化设计，提供可扩展的基础设施。

---

🛠️ 安装

使用 pip 安装所需的依赖包：

pip install pydoll-python aiohttp

注意：Pydoll 需要您的系统上安装了基于 Chromium 的浏览器（如 Chrome、Edge 等）。

---

🚀 快速入门

1. 配置您的 API 密钥

在您的脚本中替换 YOUR_CAPSOLVER_API_KEY，或将其设置为环境变量。

2. 基本集成示例

此代码片段展示了如何使用 CapSolverService 工具类来解决 reCAPTCHA v2 挑战。

from pydoll.browser import Chrome
from utils.capsolver_handler import capsolver

async def main():
    async with Chrome() as browser:
        tab = await browser.start()
        await tab.go_to("https://example.com/captcha-page")
        
        # 解决 reCAPTCHA v2
        token = await capsolver.solve_recaptcha_v2(
            website_url="https://example.com/captcha-page",
            website_key="SITE_KEY_HERE"
        )
        print(f"已解决！令牌: {token[:20]}...")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

---

📂 项目结构

文件	描述
README_zh.md	项目概览和中文文档。
utils/capsolver_handler.py	可重用的 CapSolver 实用工具类，支持多种验证码类型。
examples/solve_recaptcha_v2.py	解决 reCAPTCHA v2 的完整示例。
examples/solve_turnstile.py	绕过 Cloudflare Turnstile 的完整示例。

---

⚙️ Pydoll 的拟人化特性

特性	描述
可变按键时间	30-120ms 的延迟，并模拟约 2% 的输入错误。
物理滚动	基于动量和摩擦力的滚动，实现自然移动。
贝塞尔曲线鼠标路径	模仿人手移动曲线的鼠标路径。

---

🤝 贡献

欢迎贡献！如果您发现任何错误或有功能请求，请随时提交 Pull Request 或开启 Issue。

📜 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

---

准备好自动化了吗？ 立即获取您的 CapSolver API 密钥！