Dependency update

• Refresh Python dependencies
  --> Upgrade filelock
  --> Upgrade soupsieve
  --> Drop platformdirs (Looks like nothing was using it anymore)
  --> Update some optional dependencies

What's Changed

• Dependency update by @mdmintz in #4512

Full Changelog: v4.54.11...v4.54.12

MCP Server: Patch 19

• Update the MCP server
• Update the MCP ReadMe
• Refresh Python dependencies
  --> filelock
  --> platformdirs
  --> parse
  --> uv (optional)

What's Changed

• MCP Server: Patch 19 by @mdmintz in #4511

Full Changelog: v4.54.10...v4.54.11

MCP Server: Patch 18

• Update the MCP server
  --> Make manage_cookies more secure.
  --> Update docstrings.
• Refresh Python dependencies
  --> platformdirs

What's Changed

• MCP Server: Patch 18 by @mdmintz in #4509

Full Changelog: v4.54.9...v4.54.10

MCP Server: Patch 17

• Update the MCP server
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 17 by @mdmintz in #4508

Full Changelog: v4.54.8...v4.54.9

Fix command injection and more

• Fix command injection in console scripts
• Fix issue with clearing a field that has autocomplete
• Fix typos in behave_sb.py
• Refactor console scripts
• Update the MCP server
• Refresh Python dependencies
• Update examples

What's Changed

• Fix command injection and more by @mdmintz in #4507

Full Changelog: v4.54.7...v4.54.8

MCP Server: Patch 16

• Update the MCP server
  --> annotations and docstrings
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 16 by @mdmintz in #4505

Full Changelog: v4.54.6...v4.54.7

MCP Server: Patch 15

• Add tool annotations to the MCP Server
  --> This resolves #4503
• Update the Dockerfile
• Update CDP Mode
• Update uv
• Update CDP Mode examples

What's Changed

• MCP Server: Patch 15 by @mdmintz in #4504

Full Changelog: v4.54.5...v4.54.6

MCP Server: Patch 14

• Update the MCP Server
  --> Going for a top tool score in Glama.
• Update the MCP Server ReadMe
• Refresh optional Python dependencies

What's Changed

• MCP Server: Patch 14 by @mdmintz in #4501

Full Changelog: v4.54.4...v4.54.5

MCP Server: Patch 13

• 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)
• Update the MCP Server
  --> (The MCP ReadMe was updated in the previous commit with the wrong commit message)

What's Changed

• MCP Server: Patch 13 by @mdmintz in #4500

Full Changelog: v4.54.3...v4.54.4

MCP Server: Patch 12

• Update the MCP Server
• Update the MCP Server ReadMe

What's Changed

• MCP Server: Patch 12 by @mdmintz in #4499

Full Changelog: v4.54.2...v4.54.3

MCP Server: Patch 11

• Update CDP Mode
• Update the MCP Server

What's Changed

• MCP Server: Patch 11 by @mdmintz in #4498

Full Changelog: v4.54.1...v4.54.2

MCP Server: Patch 10

• Update the MCP Server

What's Changed

• MCP Server: Patch 10 by @mdmintz in #4497

Full Changelog: v4.54.0...v4.54.1

MCP Server: Patch 9

• Update the MCP Server
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 9 by @mdmintz in #4496

Full Changelog: v4.53.8...v4.54.0

MCP Server: Patch 8

• Update the SeleniumBase MCP Server
• Update the MCP Server ReadMe

What's Changed

• MCP Server: Patch 8 by @mdmintz in #4495

Full Changelog: v4.53.7...v4.53.8

MCP Server: Patch 7

• Update the MCP Server
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 7 by @mdmintz in #4493

Full Changelog: v4.53.6...v4.53.7

MCP Server: Patch 6

• Update the MCP server

What's Changed

• MCP Server: Patch 6 by @mdmintz in #4491

Full Changelog: v4.53.5...v4.53.6

Various Updates 2

• Loosen the restrictions when validating proxy strings
  --> This resolves #4488
• Update CDP Mode
• Update the MCP Server

MCP Server: Patch 5

• Update the MCP Server and related files
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 5 by @mdmintz in #4487

Full Changelog: v4.53.3...v4.53.4

MCP Server: Patch 4

• Update CDP Mode
• Update the MCP Server

What's Changed

• MCP Server: Patch 4 by @mdmintz in #4486

Full Changelog: v4.53.2...v4.53.3

MCP Server: Patch 3

• Update the MCP Server
  --> This resolves #4484
• Refresh Python dependencies

What's Changed

• MCP Server: Patch 3 by @mdmintz in #4485

Full Changelog: v4.53.1...v4.53.2

MCP Server: Patch 2

• Fix sb.open_new_tab(url) to accept URLs without the protocol
  --> This resolves #4482
• Update the MCP Server and related files
  --> This resolves #4481

What's Changed

• MCP Server: Patch 2 by @mdmintz in #4483

Full Changelog: v4.53.0...v4.53.1

MCP Server and CDP Mode updates

• Add select_option_by_* methods for the Driver() format
  --> This resolves #4477
• Add fast_type(selector, text) to CDP Mode
  --> This resolves #4476
• Add wait_for_element_present(selector) to CDP Mode
  --> This resolves #4479
• Improve support for XPath in CDP Mode
  --> This adds support for the "parent::" XPath selector
• Fix bug that caused orphaned browsers in async CDP Mode
  --> This resolves #4475
• Update the MCP Server and related files
  --> This resolves #4478
• Refresh Python dependencies
  --> This includes a selenium upgrade
• Update the docs
  --> This adds the new methods
• Update examples
  --> This keeps the tests up-to-date

What's Changed

• MCP Server and CDP Mode updates by @mdmintz in #4480

Full Changelog: v4.52.4...v4.53.0

4.52.4 - Add Remote WebDriver Timeout setting

• Add REMOTE_WEBDRIVER_TIMEOUT setting for Remote WebDriver HTTP requests

What's Changed

• Add REMOTE_WEBDRIVER_TIMEOUT setting for Remote WebDriver HTTP requests by @TaylorMcGinnis in #4473

Full Changelog: v4.52.3...v4.52.4

MCP Server: Patch 1

• Fix the MCP Server on Python versions less than 3.14
  --> This resolves #4471
  --> (Due to this bug, the MCP Server only worked on Python 3.14+)
  --> (Caused by a missing line: from __future__ import annotations)
• Update logging messages
• Update the docs for MCP servers
• Refresh Python dependencies
• Update examples

What's Changed

• MCP Server: Patch 1 by @mdmintz in #4472

Full Changelog: v4.52.2...v4.52.3

MCP Server Support

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.)

• Add a SeleniumBase MCP server
• Add .mcp.json to the root folder
• Update setup.cfg files
• Update .gitignore
• Update .dockerignore
• Add configuration for using the new MCP server
• Refresh Python dependencies
• Update ReadMe files

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.

What's Changed

• MCP Server Support by @mdmintz in #4470

Full Changelog: v4.52.1...v4.52.2

Fix timeout issue with executing scripts

• Fix timeout issue with executing scripts in Selenium Mode
  --> (See the next commit where the fix was moved to a finally block)
• Improve the earlier commit that fixes the script timeout issue
  --> (A method that changed the default timeout wasn't resetting it back afterward)
  --> This resolves #4467
• Update examples
  --> (Updates some examples after changes were made on the site being tested)

What's Changed

• Fix timeout issue with executing scripts by @mdmintz in #4468

Full Changelog: v4.52.0...v4.52.1

CDP Mode: Patch 129

• Update CDP Mode
• Improve output from driver downloads
• Drop support for Python 3.9
• Refresh Python dependencies
• Add scraping examples

Resolutions:

• This resolves #4461
• This resolves #4462
• This resolves #4463
• This resolves #4464
• This resolves #4465

What's Changed

• CDP Mode: Patch 129 by @mdmintz in #4466

Full Changelog: v4.51.12...v4.52.0

CDP Mode: Patch 128

• Perform no-op on duplicate quit() calls to avoid coroutine warnings
  --> This resolves #4458
• Refresh Python dependencies
  --> setuptools and platformdirs

What's Changed

• CDP Mode: Patch 128 by @mdmintz in #4459

Full Changelog: v4.51.11...v4.51.12

CDP Mode: Patch 127

• Fix memory leaks, fix bugs, and update timing
• Refresh Python dependencies
• Update examples

Special thanks to @crippledgeek (#4454 and #4455)

What's Changed

• CDP Mode: Patch 127 by @mdmintz in #4457

Full Changelog: v4.51.10...v4.51.11

CDP Mode: Patch 126

• Patch the vendored version of nest_asyncio for Python 3.14+
• Update timing of stealthy CDP Mode clicks
• Refresh Python dependencies

What's Changed

• CDP Mode: Patch 126 by @mdmintz in #4453

Full Changelog: v4.51.9...v4.51.10

CDP Mode: Patch 125

• Fix non-authenticated proxy in the sb_cdp format
• Refresh Python dependencies
• Update CDP Mode examples

What's Changed

• CDP Mode: Patch 125 by @mdmintz in #4450

Full Changelog: v4.51.8...v4.51.9

Add drag_and_drop() with CDP

• Add a CDP-based drag_and_drop() method
  --> This resolves #4442
• Update CDP Mode examples
  --> Specifically for drag_and_drop()
• Update the docs

What's Changed

• Add drag_and_drop() with CDP by @mdmintz in #4443

Full Changelog: v4.51.7...v4.51.8

Add click_and_hold() with CDP

• Add a CDP-based click_and_hold() method
• Adjust timings and refactor
• Update examples
• Update the docs

What's Changed

• Add click_and_hold() with CDP by @mdmintz in #4441

Full Changelog: v4.51.6...v4.51.7

CDP Mode: Patch 124

• Make CDP Mode stealthier
  --> Improve fingerprint on actions and add randomization
• Sync up BaseCase and sb_cdp methods
  --> (For clear() & clear_input(), which are the same)
• Refresh Python dependencies
  --> (Includes certifi and a few optional dependencies)
• Update CDP Mode examples

What's Changed

• CDP Mode: Patch 124 by @mdmintz in #4439

Full Changelog: v4.51.5...v4.51.6

CDP Mode: Patch 123

• Make CDP Mode super stealthy
• Refresh Python dependencies
• Update CDP Mode examples

What's Changed

• CDP Mode: Patch 123 by @mdmintz in #4438

Full Changelog: v4.51.4...v4.51.5

CDP Mode: Patch 122

• Update CDP Mode --> For a stealthier fingerprint
• Refresh Python dependencies
• Update CDP Mode examples

What's Changed

• CDP Mode: Patch 122 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4435

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.3...v4.51.4

CDP Mode: Patch 121

• Update CDP Mode -- Add scroll & timeout args for some methods. -- Handle a special case for clicking svg elements.
• Refresh Python dependencies -- (websockets, filelock, platformdirs)

What's Changed

• CDP Mode: Patch 121 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4431

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.2...v4.51.3

CDP Mode: Patch 120

• Fix WebRTC leak for non-proxied navigation -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4428
• Drop support for the deprecated Atlas Browser -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4427
• Remove Copilot examples (requires login now) -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4429
• Add a CDP Mode fingerprint test -- (Uses the Clearcote fingerprint scanner / auditor)
• Update Stealthy Playwright Mode examples -- (sb.goto(url) is stealthier than page.goto(url))
• Refresh Python dependencies -- (filelock and coverage)

What's Changed

• CDP Mode: Patch 120 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4430

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.1...v4.51.2

Updates to multiple areas

• Update the xpath-to-css converter
• Update the CDP Mode ad-block list
• Update error messages for proxy failures
• Update proxy validation
• Update the Slider CAPTCHA solver
• Update CDP Mode examples

What's Changed

• Updates to multiple areas by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4424

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.51.0...v4.51.1

CDP Mode: Patch 119

• Update CDP Mode --> New methods for logging from CDP Mode
• Don't ignore the cache by default on reload()
• Update the docs
• Update examples
• Refresh Python dependencies

What's Changed

• CDP Mode: Patch 119 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4422

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.6...v4.51.0

Update timing, dashboard layout, and dependencies

• Update scroll timing in CDP Mode
• Update dashboard layout
• Refresh Python dependencies
• Update CDP Mode examples

What's Changed

• Update timing, dashboard layout, and dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4420

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.5...v4.50.6

Fix Brave and Opera automation

• Fix Brave Browser automation
• Fix Opera Browser automation
• Refresh Python dependencies

More info:

• The --test-type arg started breaking Brave on version 150. It's no longer used if Brave is set.
• Brave with regular Chromedriver stopped worked. Since it works with UC, that mode is forced.
• Opera Browser now needs specific versions of Chromedriver and UC. (Those versions are set.)

What's Changed

• Fix Brave and Opera automation by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4418

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.4...v4.50.5

Updates for SOCKS5h support and PDF downloads

• Add support for "socks5h" proxies without auth
• Update how PDF downloads are handled
• Update console scripts
• Refresh optional Python dependencies
• Update documentation and comments
• Update examples

What's Changed

• Updates for SOCKS5h support and PDF downloads by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4415

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.3...v4.50.4

CDP Mode: Patch 118

• Update CDP Mode -- Simplifies --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 algorithm
• Update CDP Mode examples -- Use asyncio.run() instead of loop.run_until_complete() as needed

What's Changed

• CDP Mode: Patch 118 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4412

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.2...v4.50.3

CDP Mode: Patch 117

• Optimize CDP Mode
• Update Dashboard layout
• Update CDP Mode examples
• Refresh Python dependencies

This includes several improvements to CDP Mode:

• Fixes a bug where temporary user_data_dirs wasn't getting cleaned up properly.
• Fewer asyncio event loops used for browser processes. (Same one for startup and usage.)
• The painted flash() dot is no longer used everywhere automatically. (Anti-bots started detecting it.)

Other updates include:

• Refreshed Python dependencies.
• A small change to Dashboard layout.
• Updated examples due to website changes.

Special thanks to @montovaneli. (https://github.com/seleniumbase/SeleniumBase/issues/4408)

Changes are expected in version 4.50.2.

What's Changed

• CDP Mode: Patch 117 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4409

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.1...v4.50.2

Fix Layout in Recorder App

• Fix the layout of the SeleniumBase Recorder App

What's Changed

• Fix Layout in Recorder App by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4405

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.50.0...v4.50.1

Improve Recorder and Fix Bugs

• Improve the desktop Recorder App and Recorder Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4403
• Fix sb.solve_captcha() on Windows for Slider CAPTCHAs -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4399
• Prevent cleanup warnings on Windows -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4400
• Fix issue with get_title() failing at random -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4401
• Update the docs -- It's mostly around the updated Recorder
• Refresh Python dependencies -- selenium and certifi

What's Changed

• Improved Recorder App and Bug Fixes by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4404

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.14...v4.50.0

Chromium overhaul with CDP Mode updates

• Fix issue that caused Chromium 151 to crash at startup -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4393
• Add option for setting the exact Chromium revision to download -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4394
• Update Chromium options -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4395 -- this resolves https://github.com/seleniumbase/SeleniumBase/issues/4396
• Update CDP Mode

Here's an example of downloading a custom Chromium revision:

sbase get chromium --revision=1639046

*** Chromium revision to download = 1639046

Downloading chrome-mac.zip from:
https://storage.googleapis.com/chromium-browser-snapshots/Mac_Arm/1639046/chrome-mac.zip ...
Download Complete!

... [UNZIPPING] ...

Unzip Complete!

Chromium was saved inside:
..../seleniumbase/drivers/chromium_drivers/
chrome-mac

What's Changed

• Chromium overhaul with CDP Mode updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4397

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.13...v4.49.14

Refresh Python dependencies

• Refresh Python dependencies -- Refresh filelock, pytest, and pyotp.

What's Changed

• Refresh Python dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4390

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.12...v4.49.13

CDP Mode: Patch 116

• Add missing await for async method call in CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4388 -- (Applies to setting ad_block=True in CDP Mode)

What's Changed

• CDP Mode: Patch 116 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4389

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.11...v4.49.12

CDP Mode: Patch 115

• Update MyCDP -- (Note that all CDP calls go through MyCDP)
• Update CDP Mode -- Added a custom message option for all assertions -- Added more time for the ad-blocker to take effect

What's Changed

• CDP Mode: Patch 115 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4385

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.10...v4.49.11

CDP Mode: Patch 114

• Update CDP Mode -- Improve error-handling for various edge-cases -- Make sure all CDP Mode methods can be called via sb.METHOD (rather than sb.cdp.METHOD)
• Optimize imports in browser_launcher.py -- A few of the big imports are not always needed
• Update examples
• Update the docs

What's Changed

• CDP Mode: Patch 114 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4381

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.9...v4.49.10

CDP Mode: Patch 113

• Add functionality for handling downloads in CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4376
• Add method for extracting all links in CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4377
• Allow custom messages with failed assertions in CDP Mode
• Update the docs
• Update examples
• Refresh Python dependencies

What's Changed

• CDP Mode: Patch 113 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4378

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.8...v4.49.9

The Great Refactor

• Update the self-hosted dashboard -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4372
• Refactor code, examples, and docs -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4370 -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4371
• Refresh Python dependencies

What's Changed

• The Great Refactor by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4373

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.7...v4.49.8

CDP Mode: Patch 112

• Fix RuntimeWarning: coroutine 'Connection.aclose' was never awaited

What's Changed

• CDP Mode: Patch 112 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4367

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.6...v4.49.7

CDP Mode: Patch 111 (and more)

• Fix RuntimeWarning: coroutine 'Event.wait' was never awaited --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4363
• Remove the selenium-wire integration --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4362
• activate_cdp_mode(url) should still open the url if already active
• Save time & memory by only importing sb_install if needed
• Update the CDP Mode activation sequence
• Optimize the pytest-html report plugin
• Refresh Python dependencies
• Update examples

What's Changed

• CDP Mode: Patch 111 (and more) by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4365

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.5...v4.49.6

CDP Mode: Patch 110

• Update error-handling for checking if a process is still running

What's Changed

• CDP Mode: Patch 110 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4360

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.4...v4.49.5

CDP Mode: Patch 109

• Handle PermissionError in methods that use psutil
• Refresh Python dependencies

What's Changed

• CDP Mode: Patch 109 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4358

Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.3...v4.49.4