SeleniumBase
写 Python 脚本自动开浏览器，绕过反爬还能跑测试
SeleniumBase 是一个基于 Python 的浏览器自动化框架，在原生 Selenium 之上做了大量封装，用于网页抓取、端到端测试和自动化工作流。它最大的特点是内置 CDP Mode，通过 Chrome DevTools Protocol 驱动一个经过伪装的 Chromium 实例，能绕过多数常见的机器人检测系统，让爬虫和自动化脚本在受保护站点上稳定运行。项目同时兼容 pytest，提供简洁的链式 API，支持断言、报告、截图、多标签页、文件上传下载等测试常用能力，并附带 MCP server，方便接入 AI Agent 工作流。相比裸写 Selenium，它减少了等待、定位和反检测方面的样板代码，适合需要兼顾测试与抓取的团队。
项目数据
使用教程
⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。
环境要求
- Python 运行环境（项目为 Python 框架，README 节选未注明具体版本）
- pip 包管理工具，用于从 PyPI 安装
- 本机需具备 Chrome / Chromium 浏览器环境（项目描述为 Stealthy Chromium Automation）
- 若用于测试，需了解 pytest（README 关键词中出现 pytest）
安装与启动步骤
-
1确认 Python 环境
先确认本机已安装 Python 与 pip，README 节选未给出具体版本要求，建议使用较新的 Python 3。
python --version pip --version -
2从 PyPI 安装
README 节选仅提供了 PyPI 链接，未写出 pip 命令，此处按 PyPI 包名推断为 seleniumbase，请以官网文档为准。
pip install seleniumbase -
3验证依赖可用
在 Python 中导入包，若无报错说明依赖安装成功；README 节选未给出启动或运行命令。
python -c "import seleniumbase; print(seleniumbase.__version__)"
如何确认成功
执行 import seleniumbase 不报错、无缺失依赖提示，即表示库已就绪；README 节选未提供启动命令，无法进一步验证运行状态。
常见问题
Q：安装后怎么运行示例或脚本？
A：README 节选未给出任何运行命令，无法据此编写，请查阅官网 https://seleniumbase.io 的文档获取用法。
Q：需要额外安装浏览器或驱动吗？
A：README 描述为 Stealthy Chromium Automation，依赖 Chromium/Chrome 环境；具体安装方式节选中未说明，请参考官方文档。
Q：支持 pytest 吗？
A：README 关键词中包含 pytest，说明项目兼容 pytest 测试框架，但具体用法与插件名节选中未给出。
Q：README 里没有安装命令怎么办？
A：本教程的 pip 安装命令由 README 中的 PyPI 链接推断而来，并非原文照抄，请以官网文档的安装说明为准。
注意事项
- 本次提供的 README 节选以页面元信息（og 标签、logo、关键词）为主，不含完整安装与使用说明。
- 包名 seleniumbase 与 pip 安装方式由 README 中的 PyPI 链接推算，非 README 明确写出，存在偏差可能。
- 项目宣称的绕过机器人检测能力，请仅在合法合规、获得授权的场景下使用。
- 完整文档与示例请访问官网 https://seleniumbase.io 或 GitHub 仓库。
核心亮点
- CDP Mode 提供反检测 Chromium，能应对多数 bot-detection 站点
- 基于 pytest，测试断言、报告、截图等能力开箱即用
- API 链式调用简洁，比原生 Selenium 少写大量样板代码
不足之处
- 反检测能力依赖 Chromium 版本与站点策略，需持续跟进更新
- 功能面较广，文档量大，新手需要一定学习成本
适用场景
- 爬取有反爬保护的电商或社交平台数据
- 用 pytest 编写端到端 Web 测试并生成报告
- 给 AI Agent 提供浏览器操作能力做自动化任务
替代项目
Playwright、Puppeteer、Undetected-Chromedriver
项目介绍
上一篇：coypu
下一篇：docker-selenium
同类项目推荐
n8n
开源
拖拽搭建自动化流程，轻松接入 AI 与 400+ 应用，搞定重复工作。
Fair-code workflow automation platform with native AI capabilities. Combine visual b···
robotcode
开源
让 Robot Framework 拥有现代 IDE 体验，调试、补全、运行一气呵成。
Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···
puppeteer
开源
用 JavaScript 轻松操控无头浏览器，搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox
customermates
开源
比 Pipedrive 直观 10 倍的现代开源 CRM，轻松管理客户与自动化流程。
Building a modern alternative to Pipedrive that is 10x more intuitive.