Refresh Dependencies and Examples

README.md

@@ -8,9 +8,7 @@
 <meta property="og:image" content="https://seleniumbase.github.io/cdn/img/mac_sb_logo_5b.png" />
 <link rel="icon" href="https://seleniumbase.github.io/img/logo7.png" />
 
-<h1>SeleniumBase</h1>
-
-<p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="424" /></a></p>
+<p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="400" /></a></p>
 
 <p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>
 
@@ -52,21 +50,17 @@
 <br />
 </p>
 
-📊 <a href="https://github.com/seleniumbase/SeleniumBase/"><b translate="no">SeleniumBase</b></a> is a complete framework for browser automation and testing with Python and <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a>. Includes stealth options and other advanced features.
-
-🐙 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">UC Mode</a> and <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> can bypass bot-detection, handle CAPTCHAs, and call methods from the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome Devtools Protocol</a>. CDP Mode includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which makes Playwright stealthy.
-
-📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 100 ready-to-run examples. Examples that start with `test_` or end with `_test.py`/`_tests.py` are specifically designed to run with `pytest`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
+--------
 
-🥷 Stealthy examples are located in [SeleniumBase/examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
+🥷 Stealth modes: <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> can bypass bot-detection, handle CAPTCHAs, and call methods from the <a href="https://chromedevtools.github.io/devtools-protocol/" translate="no">Chrome Devtools Protocol</a>. CDP Mode includes <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md"><b><span translate="no">Stealthy Playwright Mode</span></b></a>, which makes Playwright stealthy.
 
---------
+🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
 
-<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
+🐙 CDP Mode (stealth) examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="640" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
+🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
 
-(For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
+📚 Examples that have `test_` or  `_test` in the filename are specifically designed to run with `pytest` / `pynose`. Other examples run directly with raw `python` (those files generally start with `raw_` to avoid confusion).
 
 --------
 
@@ -76,18 +70,22 @@
 from seleniumbase import sb_cdp
 
 sb = sb_cdp.Chrome(incognito=True)
-sb.goto("www.planetminecraft.com/account/sign_in")
-sb.solve_captcha()
-# "LOG IN" is enabled when the CAPTCHA is bypassed
-sb.wait_for_element_absent("input[disabled]")
-sb.sleep(2)
+sb.goto("https://www.planetminecraft.com/account")
+sb.assert_element('input[name="login"]')
+sb.type('input[name="email"]', "test@example.com")
+sb.type('input[name="password"]', "Fake_Password")
+sb.click("input#autologin")  # The checkbox
+if sb.is_element_visible("input[disabled]"):
+    sb.solve_captcha()  # Enables the input
+sb.assert_element_absent("input[disabled]")
+sb.sleep(1.5)
 sb.quit()
 ```
 
 > `python raw_cdp_planetmc.py`
 
 <p align="left">
-<img src="https://seleniumbase.github.io/other/pmc_captcha_2.png" width="570" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
+<img src="https://seleniumbase.github.io/other/pmc_captcha_2.png" width="530" style="max-width: 100% !important; height: auto !important;" alt="Cloudflare Turnstile bypassed successfully" />
 </p>
 
 ✅ <b><code>sb.solve_captcha()</code></b> handles CAPTCHAs that aren't bypassed automatically.<br />(If called when there's no CAPTCHA on the page, then nothing happens / no-op.)
@@ -99,51 +97,22 @@ sb.quit()
 ```python
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()
+sb = sb_cdp.Chrome(fast=True)
 sb.goto("https://news.ycombinator.com/submitted?id=seleniumbase")
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
-    print("* %s" % element.text)
+    print("* " + element.text)
 ```
 
 > `python raw_cdp_yc_news.py`
 
 <p align="left">
-<img src="https://seleniumbase.github.io/other/yc_news_results.png" alt="SeleniumBase" width="524" style="max-width: 100% !important; height: auto !important;"/>
+<img src="https://seleniumbase.github.io/other/yc_news_results.png" alt="SeleniumBase" width="510" style="max-width: 100% !important; height: auto !important;"/>
 </p>
 
-----
-
-<p align="left">📝 Here’s <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_cdp_methods.py" target="_blank">SeleniumBase/examples/cdp_mode/raw_cdp_methods.py</a>:<br />(It performs several different actions on the web page)</p>
-
-```python
-from seleniumbase import sb_cdp
-
-sb = sb_cdp.Chrome(fast=True)
-sb.goto("https://seleniumbase.io/demo_page")
-sb.type("input", "Quickly type text!")
-sb.press_keys("textarea", "Slowly type text!")
-sb.click("#myButton")
-sb.set_value("input#mySlider", "100")
-sb.click_visible_elements("input.checkBoxClassB")
-sb.select_option_by_text("#mySelect", "Set to 75%")
-sb.hover_and_click("#myDropdown", "#dropOption2")
-sb.click("#checkBox1")
-sb.drag_and_drop("img#logo", "div#drop2")
-sb.nested_click("iframe#myFrame3", ".fBox")
-sb.highlight("#myButton")
-sb.quit()
-```
-
-> `python raw_cdp_methods.py`
-
-<img src="https://seleniumbase.github.io/cdn/gif/demo_page_6.gif" width="580" style="max-width: 100% !important; height: auto !important;" alt="SeleniumBase Example" />
-
-ℹ️  Setting `fast=True` lets your automation go at full speed, which may be useful if maximum stealth isn't your goal.
-
-----
+--------
 
-<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This example</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b><br />(If the Turnstile isn't bypassed automatically,  <b><code>sb.solve_captcha()</code></b> handles it.)</p>
+<p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py" target="_blank">This example</a> bypasses Cloudflare's challenge page with UC + CDP Mode:</b></p>
 
 ```python
 from seleniumbase import SB
@@ -160,22 +129,14 @@ with SB(uc=True, test=True, locale="en") as sb:
 > `python raw_gitlab.py`
 
 <p align="left">
-<img src="https://seleniumbase.github.io/other/gitlab_bypass_2.png" alt="SeleniumBase" width="430" style="max-width: 100% !important; height: auto !important;"/>
+<img src="https://seleniumbase.github.io/other/gitlab_bypass_2.png" alt="SeleniumBase" width="420" style="max-width: 100% !important; height: auto !important;"/>
 </p>
 
 --------
 
-🧪 End-to-End Testing examples are located in [./examples/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples).
-
-🐙 Stealthy CDP Mode examples are located in [./examples/cdp_mode/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/cdp_mode).
-
-🎭 Stealthy Playwright examples are located in [./examples/cdp_mode/playwright/](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/).
-
---------
-
 <h3 align="left">🌐 CLI Options for Supported Chromium Browsers</h3>
 
-<p>💡 You can set the Chromium browser to use via command line parameters:</p>
+<p>💡 You can set which Chromium browser to use via command-line parameters:</p>
 
 ```zsh
 python SCRIPT.py --chromium  # Use the unbranded Chromium browser
@@ -194,11 +155,13 @@ sb = sb_cdp.Chrome(use_chromium=True)
 
 --------
 
-<h3>🧪 Comprehensive E2E Testing with <code>pytest</code>:</h3>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-📚 The [SeleniumBase/examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder includes over 150 ready-to-run examples of E2E testing. Examples that start with `test_` or end with `_test.py`/`_tests.py` run with `pytest`. Other examples run directly with raw `python` (those generally start with `raw_` to avoid confusion).
+<img src="https://seleniumbase.github.io/other/sb_architecture.png" width="540" style="max-width: 100% !important; height: auto !important;" alt="Stealthy architecture flowchart" />
 
+--------
 
+<h3>🧪 Comprehensive E2E Testing with <code>pytest</code>:</h3>
 
 <p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py" target="_blank">This example</a> tests an e-commerce site with <code>pytest</code>:</b></p>
 
@@ -228,6 +191,8 @@ class MyTestClass(BaseCase):
 
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" width="500" style="max-width: 100% !important; height: auto !important;" /></a>
 
+🥷 For stealth with `pytest`, add `--uc` as a command-line option.
+
 --------
 
 <p align="left"><b>📝 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_coffee_cart.py" target="_blank">This example</a> tests another e-commerce site with <code>pytest</code>:</b></p>
@@ -254,7 +219,7 @@ pytest test_demo_site.py
 
 > Easy to type, click, select, toggle, drag & drop, and more.
 
-(For more examples, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.)
+📚 For more examples, see the <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">SeleniumBase/examples/</a> folder.
 
 --------
 

examples/cdp_mode/playwright/raw_clearcote_sync.py

@@ -26,3 +26,7 @@
         score = sb.get_text("div.text-successText")
         print(f" ❌ Fingerprint tampering detected! Score: {score}")
     sb.sleep(1)
+    folder = "downloaded_files"
+    file_name = "c_audit_results_pw.pdf"
+    sb.save_as_pdf(file_name, folder)
+    print('"./%s/%s" was saved!' % (folder, file_name))

examples/cdp_mode/playwright/raw_footlocker_sync.py

@@ -3,29 +3,25 @@
 
 sb = sb_cdp.Chrome(locale="en", ad_block=True)
 sb.goto("https://www.footlocker.com/")
+sb.click_if_visible('button[id*="Agree"]', timeout=3)
+sb.click('input[name="query"]')
+search = "Nike Shoes"
+sb.press_keys('input[name="query"]', search)
 endpoint_url = sb.get_endpoint_url()
 
 with sync_playwright() as p:
     browser = p.chromium.connect_over_cdp(endpoint_url)
     page = browser.contexts[0].pages[0]
     input_field = 'input[name="query"]'
-    page.wait_for_selector(input_field)
-    sb.sleep(1.5)
-    sb.click_if_visible('button[id*="Agree"]')
-    sb.sleep(0.6)
-    page.click(input_field)
-    sb.sleep(0.6)
-    search = "Nike Shoes"
-    page.type(input_field, search)
     sb.sleep(1.2)
     page.click('ul[id*="typeahead"] li div')
     sb.sleep(3.5)
-    elements = sb.select_all("a[data-productcard]")
-    if elements:
+    items = page.locator("a[data-productcard]")
+    count = items.count()
+    if count:
         print('**** Found results for "%s": ****' % search)
     else:
         print('**** No results found for "%s". ****' % search)
-    for element in elements:
+    for i in range(items.count()):
         print("------------------ >>>")
-        print("* " + element.text)
-    sb.sleep(2)
+        print("* " + items.nth(i).inner_text().replace("\n", " "))

examples/cdp_mode/playwright/raw_planetmc_sync.py

@@ -1,14 +1,22 @@
+from playwright.sync_api import expect
 from playwright.sync_api import sync_playwright
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()
+sb = sb_cdp.Chrome(incognito=True)
 endpoint_url = sb.get_endpoint_url()
 
 with sync_playwright() as p:
     browser = p.chromium.connect_over_cdp(endpoint_url)
     page = browser.contexts[0].pages[0]
-    page.goto("https://www.planetminecraft.com/account/sign_in/")
-    sb.solve_captcha()
-    input_disabled = page.locator("input[disabled]")
-    input_disabled.wait_for(state="hidden", timeout=5000)
-    page.wait_for_timeout(2000)
+    page.goto("https://www.planetminecraft.com/account")
+    expect(page.locator('input[name="login"]')).to_be_visible()
+
+    email_field = page.locator('input[name="email"]')
+    email_field.press_sequentially("test@example.com", delay=55)
+    page.locator('input[name="password"]').fill("Fake_Password")
+    page.locator("input#autologin").click(force=True)
+
+    if page.locator('input[disabled]').is_visible():
+        sb.solve_captcha()  # Enables the input button
+    expect(page.locator("input[disabled]")).to_be_hidden()
+    page.wait_for_timeout(1500)

examples/cdp_mode/playwright/raw_yc_news_sync.py

@@ -1,7 +1,7 @@
 from playwright.sync_api import sync_playwright
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()
+sb = sb_cdp.Chrome(fast=True)
 endpoint_url = sb.get_endpoint_url()
 
 with sync_playwright() as p:

examples/cdp_mode/raw_cdp_planetmc.py

@@ -1,9 +1,13 @@
 from seleniumbase import sb_cdp
 
 sb = sb_cdp.Chrome(incognito=True)
-sb.goto("www.planetminecraft.com/account/sign_in")
-sb.solve_captcha()
-# "LOG IN" is enabled when the CAPTCHA is bypassed
-sb.wait_for_element_absent("input[disabled]")
-sb.sleep(2)
+sb.goto("https://www.planetminecraft.com/account")
+sb.assert_element('input[name="login"]')
+sb.type('input[name="email"]', "test@example.com")
+sb.type('input[name="password"]', "Fake_Password")
+sb.click("input#autologin")  # The checkbox
+if sb.is_element_visible("input[disabled]"):
+    sb.solve_captcha()  # Enables the input button
+sb.assert_element_absent("input[disabled]")
+sb.sleep(1.5)
 sb.quit()

examples/cdp_mode/raw_cdp_yc_news.py

@@ -1,7 +1,7 @@
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome()
+sb = sb_cdp.Chrome(fast=True)
 sb.goto("https://news.ycombinator.com/submitted?id=seleniumbase")
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
-    print("* %s" % element.text)
+    print("* " + element.text)

examples/cdp_mode/raw_footlocker.py

@@ -3,14 +3,11 @@
 with SB(uc=True, test=True, locale="en", ad_block=True) as sb:
     sb.activate_cdp_mode()
     sb.goto("https://www.footlocker.com/")
-    sb.sleep(2.5)
-    sb.click_if_visible('button[id*="Agree"]')
-    sb.sleep(0.6)
+    sb.click_if_visible('button[id*="Agree"]', timeout=3)
     sb.click('input[name="query"]')
-    sb.sleep(0.6)
     search = "Nike Shoes"
     sb.press_keys('input[name="query"]', search)
-    sb.sleep(2.5)
+    sb.sleep(1.2)
     sb.click('ul[id*="typeahead"] li div')
     sb.sleep(3.5)
     elements = sb.select_all("a[data-productcard]")
@@ -21,4 +18,3 @@
     for element in elements:
         print("------------------ >>>")
         print("* " + element.text)
-    sb.sleep(2)

examples/cdp_mode/raw_hacker_news.py

@@ -1,8 +1,8 @@
 from seleniumbase import SB
 
-with SB(uc=True) as sb:
+with SB(uc=True, fast=True) as sb:
     sb.activate_cdp_mode()
     sb.goto("https://news.ycombinator.com/submitted?id=seleniumbase")
     elements = sb.find_elements("span.titleline > a")
     for element in elements:
-        print("* %s" % element.text)
+        print("* " + element.text)

examples/cdp_mode/raw_planetmc.py

@@ -1,9 +1,14 @@
 from seleniumbase import SB
 
-with SB(uc=True, test=True, guest=True) as sb:
+with SB(uc=True, test=True, incognito=True) as sb:
     sb.activate_cdp_mode()
-    sb.goto("www.planetminecraft.com/account/sign_in")
-    sb.solve_captcha()
-    # "LOG IN" is enabled when the CAPTCHA is bypassed
-    sb.wait_for_element_absent("input[disabled]")
-    sb.sleep(2)
+    sb.goto("https://www.planetminecraft.com/account")
+    sb.assert_element('input[name="login"]')
+    sb.assert_text("Sign in to Planet Minecraft")
+    sb.type('input[name="email"]', "test@example.com")
+    sb.type('input[name="password"]', "Fake_Password")
+    sb.click("input#autologin")  # The checkbox
+    if sb.is_element_visible("input[disabled]"):
+        sb.solve_captcha()  # Enables the input button
+    sb.assert_element_absent("input[disabled]")
+    sb.sleep(1.5)

mcp_servers/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "seleniumbase-mcp"
-version = "1.4.1dev0"
+version = "1.4.2dev0"
 description = "MCP server exposing SeleniumBase CDP Mode as tools for MCP clients."
 readme = "README.md"
 requires-python = ">=3.10"

requirements.txt

@@ -40,7 +40,7 @@ selenium==4.50.0
 cssselect>=1.5.0,<2
 sortedcontainers==2.4.0
 execnet==2.1.2
-iniconfig==2.3.0
+iniconfig~=2.3.1
 pluggy==1.6.0
 pytest==8.4.2;python_version<"3.11"
 pytest==9.1.1;python_version>="3.11"
@@ -68,5 +68,5 @@ coverage>=7.16.2
 pytest-cov>=7.1.0
 flake8==7.4.1
 mccabe==0.7.0
-pyflakes==4.0.2
+pyflakes==4.0.3
 pycodestyle==2.15.0

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.55.1"
+__version__ = "4.55.2"

server.json

@@ -3,7 +3,7 @@
   "name": "io.github.seleniumbase/seleniumbase",
   "title": "SeleniumBase MCP",
   "description": "Stealthy browser automation, testing, and web-scraping via CDP Mode.",
-  "version": "4.55.1",
+  "version": "4.55.2",
   "repository": {
     "url": "https://github.com/seleniumbase/SeleniumBase",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "seleniumbase",
-      "version": "4.55.1",
+      "version": "4.55.2",
       "transport": {
         "type": "stdio"
       },