SeleniumBase

写 Python 脚本自动开浏览器,绕过反爬还能跑测试

开源 🏷️完全免费 ✅ 目前可打开 自动化工作流 🍴 复刻 1613 🐛 待处理 13 👀 关注 153
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 13225
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,MIT许可证

项目预览

SeleniumBase 项目界面预览图
图片来源:项目官网

项目数据

分类自动化工作流
开发团队seleniumbase
定价模式🏷️完全免费
价格说明开源免费,MIT许可证
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言Python
技术栈/模型bot-detection,cdp,chrome-devtools-protocol,chromedriver,cloudflare-bypass,e2e-testing,end-to-end-testing,mcp,playwright,pytest,python,selenium-python,seleniumbase,test-automation,web-automation,web-scraping
GitHub 星标★ 13225
上线时间2014-03-04 00:00:00
代码更新2026-11-04
仓库体积15.4 MB
本站数据更新2026-11-05
维护状态活跃
收录时间2026-09-18
浏览次数1

项目介绍

SeleniumBase 是一个基于 Python 的浏览器自动化框架,在原生 Selenium 之上做了大量封装,用于网页抓取、端到端测试和自动化工作流。它最大的特点是内置 CDP Mode,通过 Chrome DevTools Protocol 驱动一个经过伪装的 Chromium 实例,能绕过多数常见的机器人检测系统,让爬虫和自动化脚本在受保护站点上稳定运行。项目同时兼容 pytest,提供简洁的链式 API,支持断言、报告、截图、多标签页、文件上传下载等测试常用能力,并附带 MCP server,方便接入 AI Agent 工作流。相比裸写 Selenium,它减少了等待、定位和反检测方面的样板代码,适合需要兼顾测试与抓取的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-18 · 当前星标 ★ 13225

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

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

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 运行环境(项目为 Python 框架,README 节选未注明具体版本)
  • pip 包管理工具,用于从 PyPI 安装
  • 本机需具备 Chrome / Chromium 浏览器环境(项目描述为 Stealthy Chromium Automation)
  • 若用于测试,需了解 pytest(README 关键词中出现 pytest)

安装与启动步骤

  1. 1确认 Python 环境

    先确认本机已安装 Python 与 pip,README 节选未给出具体版本要求,建议使用较新的 Python 3。

    python --version
    pip --version
  2. 2从 PyPI 安装

    README 节选仅提供了 PyPI 链接,未写出 pip 命令,此处按 PyPI 包名推断为 seleniumbase,请以官网文档为准。

    pip install seleniumbase
  3. 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

同类项目推荐

meta-automation 开源

让 AI 代理自动在 Threads 和 Instagram 上找客户、聊客户

Autonomous AI Lead Generation, Social Discovery & Smart Conversational Growth Agent ···

★ 113 2026-11-05
wa-automate-nodejs 开源

用 Node.js 快速搭建 WhatsApp 聊天机器人,自动收发消息

The most reliable tool for chatbots with advanced features. Be sure to this reposit···

★ 3676 2026-09-14
WinShun 开源

双击Ctrl,拼音秒搜文件、全文和剪贴板

Win顺:免费开源的 Windows 快速搜索启动器。双击 Ctrl,拼音秒搜文件、全文搜索 Word/Exc···

★ 861 2026-10-12
AVA 开源

让 AI Agent 自己看懂数据、选图、写结论

AI-native Visual Analytics framework build for agents.

★ 1601 2026-10-11
useR2024-pipeline-workshop 开源

用 R 免费部署监控 ML 管道,从零到生产实战

Materials for the useR!2024 conference workshop "Deploy and Monitor ML Pipelines wit···

★ 57 2026-08-09
MacroDroid 开源

导入即用的安卓自动化宏,发条 Telegram 就能远程控手机

MacroDroid macros collection for Android automation: control your Android via Telegr···

★ 142 2026-10-07
self-hosted 开源

自托管搭内部工具,低代码配流程一键部署

Internal tools and workflow automations

★ 301 2026-11-04
chrome-devtools-mcp 开源

让 AI 直接开浏览器调试页面,写完代码自己验证

Chrome DevTools for coding agents

★ 54802 2026-10-22
zadig 开源

一套平台搞定 CI/CD 与环境发布,开发者自助上线

Zadig: An AI-powered, cloud-native, distributed DevOps platform designed for develop···

★ 3269 2026-10-08