NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #3401 most downloaded on PyPI
SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
Latest stable
4.58.3
Last release today
21 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
8 versions withdrawn
withdrawn after publishing
11 years old
1238 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Fix issue that caused deprecated methods to be called --> This resolves #4568
Full Changelog: v4.58.2...v4.58.3
4.58.3 - Fix driver bugs Latest
Latest
Compare
Your coding agent can read these notes before it upgrades. Set up the MCP server →
A few fixes and dependency updates
Full Changelog: v4.58.1...v4.58.2
4.58.2 - A few fixes and dependency updates
Compare
Since PyOTP 2.12.0 broke backwards compatibility, we're going to replace it with in-house 2FA algorithm to handle time-based 2-factor authentication.
Since PyOTP 2.12.0 broke backwards compatibility, we're going to replace it with in-house 2FA algorithm to handle time-based 2-factor authentication. The algorithm will work exactly as it did before so that backwards-compatibility is retained for existing scripts.
Gemini-generated snippet:
Replace pyotp with standard library TOTP in get_mfa_code()
Maintains backwards compatibility with 16-character Base32 secrets
after pyotp 2.12.0 enforced a 112-bit minimum key length.
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@://github.com>
Full Changelog: v4.58.0...v4.58.1
Simulate pressing "Shift" when uppercase letters are typed --> This resolves #4552
Full Changelog: v4.57.1...v4.58.0
Linux aarch64 driver support (and more)
aarch64 driver support (and more)Full Changelog: v4.57.0...v4.57.1
aarch64 driver support (and more)aarch64 driver support (and more) by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4547Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.57.0...v4.57.1
4.57.1 - Linux aarch64 driver support (and more)
Compare
CDP and MCP updates (and dependencies)
pipwebsocketsfilelocktrioseleniumuv (optional dependency)Full Changelog: v4.56.5...v4.57.0
pip
--> websockets
--> filelock
--> trio
--> selenium
--> uv (optional dependency)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.56.5...v4.57.0
4.57.0 - CDP and MCP updates (and dependencies)
Compare
Suppress exceptions caused by cdp.dom.enable() --> This resolves #4537
Full Changelog: v4.56.4...v4.56.5
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.56.4...v4.56.5
Fix issue with listing tabs in CDP Mode --> This resolves #4533
certifisoupsievecoverage (optional dependency)playwright (optional dependency)pycparser (optional dependency)uv (optional dependency)Full Changelog: v4.56.3...v4.56.4
certifi
--> soupsieve
--> coverage (optional dependency)
--> playwright (optional dependency)
--> pycparser (optional dependency)
--> uv (optional dependency)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.56.3...v4.56.4
Refresh dependencies for security
Full Changelog: v4.56.2...v4.56.3
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.56.2...v4.56.3
4.56.3 - Refresh dependencies for security
Compare
Update decorators and dependencies
Full Changelog: v4.56.1...v4.56.2
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.56.1...v4.56.2
4.56.2 - Update decorators and dependencies
Compare
Fix dependency issue caused by a yank
4.56.1 - Fix dependency issue caused by a yank
Compare
Refresh Python dependencies --> This resolves #4523
Full Changelog: v4.55.2...v4.56.0
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.55.2...v4.56.0
Refresh Dependencies and Examples
Full Changelog: v4.55.1...v4.55.2
4.55.2 - Refresh Dependencies and Examples
Compare
Add Fast Mode to CDP Mode --> This resolves #4519
The main reason for Fast Mode (fast=True / --fast) is because CDP Mode normally performs actions at human-like speed to avoid triggering bot-detection when web sites are tracking time between actions performed on a web page. Since not all websites have that tracking, it may be possible to do browser automation at full speed while still maintaining stealth. Also, if people are using CDP Mode on sites that don't have any bot-detection at all, then there might not be a good reason to throttle the speed in the first place.
In Fast Mode, there is also no initial delay when navigating to a website. The purpose of this delay was to give time for automatic CAPTCHAs to complete successfully, such as the Cloudflare interstitial page.
Full Changelog: v4.55.0...v4.55.1
Refresh Python dependencies --> selenium --> filelock --> charset-normalizer --> pyflakes (optional) --> cryptography (optional)
seleniumfilelockcharset-normalizerpyflakes (optional)cryptography (optional)Full Changelog: v4.54.13...v4.55.0
selenium
--> filelock
--> charset-normalizer
--> pyflakes (optional)
--> cryptography (optional)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.13...v4.55.0
A.I. Updates by @mdmintz in #4515
Refresh Python dependencies --> Upgrade filelock --> Upgrade soupsieve --> Drop platformdirs (Looks like nothing was using it anymore) --> Update some
filelocksoupsieveplatformdirs (Looks like nothing was using it anymore)Full Changelog: v4.54.11...v4.54.12
filelock
--> Upgrade soupsieve
--> Drop platformdirs (Looks like nothing was using it anymore)
--> Update some optional dependenciesFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.11...v4.54.12
Refresh Python dependencies --> filelock --> platformdirs --> parse --> uv (optional)
filelockplatformdirsparseuv (optional)Full Changelog: v4.54.10...v4.54.11
filelock
--> platformdirs
--> parse
--> uv (optional)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.10...v4.54.11
Update the MCP server --> Make manage_cookies more secure. --> Update docstrings.
manage_cookies more secure.
--> Update docstrings.platformdirsFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.9...v4.54.10
manage_cookies more secure.platformdirsFull Changelog: v4.54.9...v4.54.10
MCP Server: Patch 17 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4508
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.8...v4.54.9
Fix command injection in console scripts
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.7...v4.54.8
Full Changelog: v4.54.7...v4.54.8
4.54.8 - Fix command injection and more
Compare
Update the MCP server --> annotations and docstrings
Full Changelog: v4.54.6...v4.54.7
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.6...v4.54.7
Add tool annotations to the MCP Server --> This resolves #4503
Full Changelog: v4.54.5...v4.54.6
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.5...v4.54.6
Update the MCP Server --> Going for a top tool score in Glama.
Full Changelog: v4.54.4...v4.54.5
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.4...v4.54.5
Update CDP Mode (add timeout to a few methods) --> (One of the ReadMe files should've been committed in the next commit with a different message)
Full Changelog: v4.54.3...v4.54.4
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.3...v4.54.4
MCP Server: Patch 12 by @mdmintz in #4499
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.2...v4.54.3
MCP Server: Patch 11 by @mdmintz in #4498
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.1...v4.54.2
MCP Server: Patch 10 by @mdmintz in #4497
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.54.0...v4.54.1
MCP Server: Patch 9 by @mdmintz in #4496
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.8...v4.54.0
Update the SeleniumBase MCP Server
MCP Server: Patch 7 by @mdmintz in #4493
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.6...v4.53.7
MCP Server: Patch 6 by @mdmintz in #4491
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.5...v4.53.6
Loosen the restrictions when validating proxy strings --> This resolves #4488
Update the MCP Server and related files
MCP Server: Patch 4 by @mdmintz in #4486
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.2...v4.53.3
Update the MCP Server --> This resolves #4484
Full Changelog: v4.53.1...v4.53.2
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.1...v4.53.2
Fix sb.open_new_tab(url) to accept URLs without the protocol --> This resolves #4482
Full Changelog: v4.53.0...v4.53.1
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.53.0...v4.53.1
MCP Server and CDP Mode updates
"parent::" XPath selectorselenium upgradeFull Changelog: v4.52.4...v4.53.0
"parent::" XPath selectorselenium upgradeFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.52.4...v4.53.0
Add REMOTE_WEBDRIVER_TIMEOUT setting for Remote WebDriver HTTP requests
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.52.3...v4.52.4
Full Changelog: v4.52.3...v4.52.4
Fix the MCP Server on Python versions less than 3.14 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4471 --> (Due to this bug,
from __future__ import annotations)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.52.2...v4.52.3
from __future__ import annotations)Full Changelog: v4.52.2...v4.52.3
If you love AI tools, this is one of the biggest releases this year for SeleniumBase! The new `seleniumbase-mcp` command starts the "Pure CDP Mode" MC
If you love AI tools, this is one of the biggest releases this year for SeleniumBase!
The new seleniumbase-mcp command starts the "Pure CDP Mode" MCP Server.
(Be sure to install seleniumbase[mcp] to get mcp>=2.0.0!)
(To debug the MCP server from a git clone of SeleniumBase, get uv as well before calling mcp dev server.py from the SeleniumBase/mcp_servers/ folder.)
Note that you will need mcp>=2.0.0 for the MCP Server to work!
⚠️ Note: Due to a typing bug, (https://github.com/seleniumbase/SeleniumBase/issues/4471), the MCP Server in this release only worked on Python 3.14+. Upgrade to https://github.com/seleniumbase/SeleniumBase/releases/tag/v4.52.3 for the fix.
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.52.1...v4.52.2
If you love AI tools, this is one of the biggest releases this year for SeleniumBase!
The new seleniumbase-mcp command starts the "Pure CDP Mode" MCP Server.
(Be sure to install seleniumbase[mcp] to get mcp>=2.0.0!)
(To debug the MCP server from a git clone of SeleniumBase, get uv as well before calling mcp dev server.py from the SeleniumBase/mcp_servers/ folder.)
Note that you will need mcp>=2.0.0 for the MCP Server to work!
⚠️ Note: Due to a typing bug, (#4471), the MCP Server in this release only worked on Python 3.14+.
Upgrade to https://github.com/seleniumbase/SeleniumBase/releases/tag/v4.52.3 for the fix.
Full Changelog: v4.52.1...v4.52.2
Fix timeout issue with executing scripts in Selenium Mode --> (See the next commit where the fix was moved to a finally block)
finally block)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.52.0...v4.52.1
finally block)Full Changelog: v4.52.0...v4.52.1
Improve output from driver downloads
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.12...v4.52.0
Full Changelog: v4.51.12...v4.52.0
Perform no-op on duplicate quit() calls to avoid coroutine warnings --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4458
setuptools and platformdirsFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.11...v4.51.12
setuptools and platformdirsFull Changelog: v4.51.11...v4.51.12
Fix memory leaks, fix bugs, and update timing
Special thanks to @crippledgeek (https://github.com/seleniumbase/SeleniumBase/issues/4454 and https://github.com/seleniumbase/SeleniumBase/issues/4455)
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.10...v4.51.11
Special thanks to @crippledgeek (#4454 and #4455)
Full Changelog: v4.51.10...v4.51.11
Patch the vendored version of nest_asyncio for Python 3.14+
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.9...v4.51.10
Full Changelog: v4.51.9...v4.51.10
Fix non-authenticated proxy in the sb_cdp format
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.8...v4.51.9
Full Changelog: v4.51.8...v4.51.9
Add a CDP-based drag_and_drop() method --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4442
drag_and_drop() with CDPdrag_and_drop()drag_and_drop() with CDP by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4443Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.7...v4.51.8
drag_and_drop() with CDPdrag_and_drop()Full Changelog: v4.51.7...v4.51.8
Add a CDP-based click_and_hold() method
click_and_hold() with CDPclick_and_hold() with CDP by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4441Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.6...v4.51.7
Make CDP Mode stealthier --> Improve fingerprint on actions and add randomization
clear() & clear_input(), which are the same)certifi and a few optional dependencies)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.5...v4.51.6
clear() & clear_input(), which are the same)certifi and a few optional dependencies)Full Changelog: v4.51.5...v4.51.6
CDP Mode: Patch 123 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4438
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.4...v4.51.5
Update CDP Mode --> For a stealthier fingerprint
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.3...v4.51.4
Update CDP Mode -- Add scroll & timeout args for some methods. -- Handle a special case for clicking svg elements.
scroll & timeout args for some methods.
-- Handle a special case for clicking svg elements.websockets, filelock, platformdirs)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.2...v4.51.3
Drop support for the deprecated Atlas Browser -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4427
sb.goto(url) is stealthier than page.goto(url))filelock and coverage)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.1...v4.51.2
Update the xpath-to-css converter
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.0...v4.51.1
Update CDP Mode --> New methods for logging from CDP Mode
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.6...v4.51.0
Update scroll timing in CDP Mode
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.5...v4.50.6
The --test-type arg started breaking Brave on version 150. It's no longer used if Brave is set.
--test-type arg started breaking Brave on version 150. It's no longer used if Brave is set.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.4...v4.50.5
Add support for "socks5h" proxies without auth
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.3...v4.50.4
Update CDP Mode -- Simplifies --use-chromium to just --chromium in command-line options -- Use the mock-keychain when setting a custom Chromium binary
--use-chromium to just --chromium in command-line options
-- Use the mock-keychain when setting a custom Chromium binary location
-- Adjusts the DataDome Slider CAPTCHA-solving algorithmasyncio.run() instead of loop.run_until_complete() as neededFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.2...v4.50.3
One column per quarter.