cloud-one

🚀 Anti-detect browser driver with Cloudflare bypass for Node.js

A powerful CDP-based browser automation library designed to bypass Cloudflare and other anti-bot protections.

Features

• ✅ Cloudflare Bypass - Automatic Turnstile and challenge detection
• ✅ Anti-Detection - Chrome launched with stealth flags
• ✅ CDP Native - Direct Chrome DevTools Protocol control
• ✅ Cookie Persistence - Save/load sessions for faster access
• ✅ Human-like Actions - Mouse movements and clicks
• ✅ Shadow DOM - Full shadow root traversal
• ✅ TypeScript - Full type support

Installation

npm install cloud-one

Quick Start

import { Driver } from 'cloud-one';

const driver = new Driver();

await driver.start();
await driver.get('https://example.com', { bypassCloudflare: true });

const title = await driver.title;
console.log(title);

// Save cookies for next time
await driver.saveCookies('cookies.json');

await driver.close();

Cookie Persistence

Perfect for sites with Cloudflare - solve once, reuse forever:

// Load cookies from previous session
await driver.loadCookies('cookies.json');

// Navigate (Cloudflare will recognize you)
await driver.get('https://protected-site.com');

// Save updated cookies
await driver.saveCookies('cookies.json');

API Reference

Driver

| Method | Description | |--------|-------------| | start() | Launch Chrome browser | | close() | Close browser | | get(url, options) | Navigate to URL | | googleGet(url, options) | Navigate with Google referrer | | select(selector, wait?) | Find element | | selectAll(selector) | Find all elements | | getElementAtPoint(x, y) | Get element at coordinates | | getText(selector) | Get element text | | click(selector) | Click element | | screenshot(path?) | Take screenshot | | saveCookies(path) | Save cookies to file | | loadCookies(path) | Load cookies from file | | isBotDetectedByCloudflare() | Check if Cloudflare is blocking |

Configuration

const driver = new Driver({
    config: {
        headless: false,        // Show browser window
        windowWidth: 1920,
        windowHeight: 1080,
        proxy: 'http://user:pass@host:port',
        userAgent: 'custom user agent',
    }
});

Requirements

• Node.js >= 18
• Google Chrome installed

License

MIT

Credits

Inspired by botasaurus Python library.