nodriver-cf-verify

A lightweight async extension for nodriver to detect and verify Cloudflare Turnstile challenges.

🚀 Description

nodriver-cf-verify is a simple plugin for the nodriver project. It automatically detects if a webpage is protected by a Cloudflare Turnstile challenge and attempts to verify it using the browser automation interface provided by nodriver.

This extension is useful when automating headless access to pages protected by Cloudflare's JS-based or iframe-based turnstiles.

✅ Features

• Detects Cloudflare protection scripts
• Locates the embedded Turnstile iframe
• Simulates a click on the challenge
• Works asynchronously using asyncio
• Supports retrying with configurable intervals

⚙️ Requirements

• Python 3.9+
• nodriver
• asyncio (standard lib)

📦 Installation

Install the required dependencies using pip:

• pip install -r requirements.txt

Make sure nodriver is available in your environment.

You can also install it manually:

• pip install nodriver

💻 Example Usage

import nodriver, time
from nodriver_cf_verify import CFVerify

async def main() -> None:
    browser: nodriver.Browser = await nodriver.start()
    browser_tab: nodriver.Tab = await browser.get("https://nowsecure.nl")

    start: float = time.perf_counter()

    cf_verify: CFVerify = CFVerify(_browser_tab=browser_tab, _debug=True)
    result: bool = await cf_verify.verify(_max_retries=10, _interval_between_retries=1, _reload_page_after_n_retries=0)

    duration: float = (time.perf_counter() - start)

    if result:
        print(f"Cloudflare was successfully verified in {duration:.2f} seconds.")
        return
    
    print(f"Failed to verify Cloudflare. Elapsed time: {duration:.2f} seconds.")

nodriver.loop().run_until_complete(main())

📄 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). You can read the full license text here: https://www.gnu.org/licenses/agpl-3.0.txt

This project is an independent, unofficial extension based on:

• nodriver – https://github.com/ultrafunkamsterdam/nodriver (AGPL-3.0)

We are not affiliated with or endorsed by the original nodriver authors. All source code is provided openly to comply with AGPL-3.0 section 13.

📝 NOTICE

This software is based on or makes use of:

• nodriver — https://github.com/ultrafunkamsterdam/nodriver Licensed under the GNU Affero General Public License v3.0

No changes were made to nodriver's source code. This extension communicates externally using nodriver’s public API.

⚠️ Disclaimer

The authors are not responsible for any misuse of this project. Use at your own risk. This code is provided for educational and research purposes only. Ensure your usage complies with all applicable laws and terms of service.

📬 Contact

Built by OMEGASTRUX. If you have questions, ideas, or feedback — open an issue or reach out.