pydoll

免 WebDriver 驱动 Chromium,模拟真人操作防检测

Pydoll 是一个基于 Python 的浏览器自动化库,专为 Chromium 系浏览器设计,无需 WebDriver 即可通过 CDP 协议直接控制浏览器。它解决了传统自动化工具(如 Selenium)依赖 WebDriver 导致的环境配置复杂、易被反爬机制识别的问题。核心能力包括:模拟真实用户行为(鼠标移动、点击、键盘输入)、绕过浏览器指纹检测、支持 headless 模式、提供简洁的异步 API 进行页面交互和网络请求捕获。项目强调“真实交互”,适合爬虫、端到端测试和需要高隐蔽性的自动化场景。目前处于成长阶段,星标超 7000,社区活跃度较高。

开源 free 自动化工作流
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7095
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类自动化工作流
开发团队autoscrape-labs
所属国家
定价模式free
价格说明开源库,MIT 许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言HTML
技术栈/模型anti-detection,automation,browser-automation,cdp,chromium,crawler,e2e-tests,fingerprinting,headless,playwright,puppeteer,recaptcha-v3,scraping,selenium,testing,testing-tools,turnstile-solver,web-scraping,webdriver
GitHub 星标★ 7095
30天Star增速
HF 下载量
上线时间2024-10-27 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-10
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 3 步

环境要求

  • Python 环境(需能运行 pip)
  • Chromium 系浏览器(如 Chrome)
  • 无需 WebDriver 二进制或额外外部依赖
  • 能执行 pip 安装命令的终端

安装与启动步骤

  1. 1安装 pydoll

    通过 pip 从 PyPI 安装 pydoll-python 包,README 明确说明无需 WebDriver 二进制或外部依赖。

    pip install pydoll-python
  2. 2验证导入

    确认包已正确安装并能被 Python 导入,为后续编写自动化脚本做准备。

    python -c "import pydoll"
  3. 3编写异步脚本

    README 提到 Pydoll 提供异步 API,用于驱动 Chrome 并进行页面交互与点击输入。

如何确认成功

执行 python -c "import pydoll" 无报错,即表示库安装成功可用。

常见问题

Q:需要安装 WebDriver 吗?

A:不需要。README 明确说明 Pydoll 通过 CDP 直接驱动 Chrome,无需 WebDriver 二进制,也没有 navigator.webdriver 标志。

Q:支持哪些浏览器?

A:README 与项目简介表明其面向 Chromium 系浏览器(如 Chrome),通过 DevTools Protocol 直接控制。

Q:可以用 headless 模式吗?

A:项目简介提到支持 headless 模式,可在浏览器无界面状态下运行自动化任务。

注意事项

  • README 未给出完整示例代码,具体 API 用法请查阅官网文档 https://pydoll.tech/
  • pip 安装命令为 pip install pydoll-python,包名与项目名 pydoll 不同,注意区分
  • 该库为异步 API,编写脚本时需使用 async/await 语法

核心亮点

  • 基于 CDP 直连浏览器,无需额外驱动,环境配置极简
  • 内置反指纹和真实交互模拟,显著降低被网站识别为机器人的概率
  • API 设计简洁,异步支持,适合快速构建高并发自动化任务

不足之处

  • 仅支持 Chromium 系浏览器,Firefox 等无兼容方案
  • 文档和示例相对较少,高级用法需自行阅读源码
  • 依赖 CDP 协议,浏览器版本更新可能导致接口变动

适用场景

  • 爬虫采集需要登录或反爬严格的网站数据
  • 端到端测试中模拟真实用户操作流程
  • 自动化运营任务(如批量表单填写、UI 回归验证)

替代项目

Playwright、Puppeteer、Selenium

项目介绍

pydoll 是自动化工作流领域的开源项目,由 autoscrape-labs 开发,2024 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(7,095)位列前 7%,在自动化工作流分类的 509 个项目里位列前 13%。

近 41 天,它的 GitHub 星标从 7,013 增加到 7,095,净增 82。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。开源库,MIT 许可证,完全免费,无付费版本。从国内网络环境看,可直接访问。

它主要面向的使用场景是:爬虫采集需要登录或反爬严格的网站数据。同类可对比的替代方案包括 Playwright、Puppeteer、Selenium。

上一篇:pinchtab

下一篇:ferret

同类项目推荐

n8n 开源

拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。

Fair-code workflow automation platform with native AI capabilities. Combine visual b···

★ 205700 2026-08-10
feishu-docx 开源

让 AI 代理轻松读写飞书文档,双向转换 Markdown

Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···

★ 262 2026-08-09
robotcode 开源

让 Robot Framework 拥有现代 IDE 体验,调试、补全、运行一气呵成。

Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···

★ 301 2026-08-10
puppeteer 开源

用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。

JavaScript API for Chrome and Firefox

★ 95609 2026-08-10