CloakBrowser: 2.4K⭐ Stealth Browser — Pass All Bot Detection Tests

// CloakBrowser generates realistic fingerprints
const profile = await cloak.generateProfile({
    os: 'Windows 11',
    browser: 'Chrome 120',
    resolution: '1920x1080',
    language: 'en-US',
    timezone: 'America/New_York'
});

// Each profile is unique and consistent
console.log(profile.webgl.vendor);  // "Google Inc. (NVIDIA)"
console.log(profile.webgl.renderer); // "ANGLE (NVIDIA, NVIDIA GeForce GTX 1660..."

// Rotate fingerprints every session
const browser = await cloak.launch({
    rotateFingerprint: true,
    rotationInterval: 'per_session',  // per_session | per_request | per_minute
    proxy: {
        type: ' residential',
        country: 'US',
        city: 'New York'
    }
});

// Each new page gets a fresh identity
const page1 = await browser.newPage();  // Profile A
const page2 = await browser.newPage();  // Profile B (different!)

const { CloakBrowser } = require('cloakbrowser');

const browser = await CloakBrowser.launch({
    // Stealth options
    stealth: {
        // Hide automation flags
        hideWebDriver: true,
        hideChromeRuntime: true,
        hidePermissions: true,
        
        // Spoof navigator properties
        spoofNavigator: {
            hardwareConcurrency: 8,
            deviceMemory: 8,
            maxTouchPoints: 0
        },
        
        // Canvas fingerprint protection
        canvas: {
            mode: 'noise',  // noise | block | off
            seed: 'random'
        },
        
        // WebGL spoofing
        webgl: {
            vendor: 'Google Inc. (NVIDIA)',
            renderer: 'ANGLE (NVIDIA, NVIDIA GeForce GTX 1660...)'
        }
    }
});

// Built-in proxy rotation
const browser = await CloakBrowser.launch({
    proxy: {
        provider: 'brightdata',  // brightdata | oxylabs | smartproxy | custom
        type: 'residential',     // residential | datacenter | mobile
        rotation: 'per_request',  // per_request | per_session | sticky
        
        // Geolocation targeting
        geo: {
            country: 'US',
            state: 'California',
            city: 'Los Angeles'
        }
    }
});

// High-level scraping API
const scraper = await browser.newScraper();

// Extract data with automatic retry
const data = await scraper.extract({
    url: 'https://example.com/products',
    
    // Wait for dynamic content
    waitFor: '.product-list',
    timeout: 30000,
    
    // Extract structured data
    schema: {
        products: {
            selector: '.product-item',
            multiple: true,
            fields: {
                name: '.product-title',
                price: '.price',
                image: '.product-img@src',
                rating: '.rating@data-score'
            }
        },
        pagination: {
            next: '.next-page@href'
        }
    },
    
    // Auto-handle pagination
    pagination: {
        enabled: true,
        maxPages: 10,
        delay: 2000  // 2s between pages
    }
});

console.log(`Scraped ${data.products.length} products`);

// Human-like mouse movements
await page.humanLikeMove({
    x: 100,
    y: 200,
    duration: 800,  // 800ms (human speed)
    curve: 'bezier'  // Natural bezier curve
});

// Random delays between actions
await page.randomDelay({
    min: 500,
    max: 3000,
    distribution: 'normal'  // Normal distribution (bell curve)
});

// Scroll with variable speed
await page.humanLikeScroll({
    distance: 500,
    speed: 'variable',  // Starts fast, slows down
    pauseProbability: 0.3  // 30% chance to pause mid-scroll
});

// Randomize request timing
await cloak.randomizeRequests({
    // Add jitter to intervals
    jitter: {
        min: 0.8,   // 80% of base delay
        max: 1.5    // 150% of base delay
    },
    
    // Randomize header order
    headerOrder: 'random',
    
    // Add random query params (cache busting)
    cacheBust: true
});

# NPM
npm install cloakbrowser

# Yarn
yarn add cloakbrowser

# PNPM
pnpm add cloakbrowser

const { CloakBrowser } = require('cloakbrowser');

(async () => {
    // Launch stealth browser
    const browser = await CloakBrowser.launch({
        headless: false,  // Use false for debugging
        stealth: true
    });
    
    // Open page
    const page = await browser.newPage();
    
    // Navigate with anti-detection
    await page.goto('https://bot-detector.example.com', {
        waitUntil: 'networkidle2',
        timeout: 30000
    });
    
    // Check detection score
    const score = await page.evaluate(() => {
        return window.botDetector?.getScore() || 'unknown';
    });
    
    console.log(`Bot detection score: ${score}`);  // Should be low (< 0.3)
    
    // Take screenshot for verification
    await page.screenshot({ path: 'stealth-test.png' });
    
    await browser.close();
})();

FROM node:20-slim

# Install dependencies
RUN apt-get update && apt-get install -y \
    chromium \
    fonts-liberation \
    libappindicator3-1 \
    libasound2 \
    libatk-bridge2.0-0 \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY package*.json ./
RUN npm install

COPY . .

# Run with CloakBrowser
CMD ["node", "scraper.js"]

// Monitor competitor prices
const monitor = await cloak.createMonitor({
    targets: [
        { url: 'https://amazon.com/dp/B08N5WRWNW', selector: '.a-price' },
        { url: 'https://walmart.com/ip/123456', selector: '[data-automation-id="product-price"]' }
    ],
    interval: '1h',
    proxy: { type: 'residential', rotation: true }
});

monitor.on('priceChange', (data) => {
    console.log(`Price changed: ${data.product} - ${data.oldPrice} -> ${data.newPrice}`);
    // Send alert to Slack/Discord
});

// Track search rankings without detection
const tracker = await cloak.createRankTracker({
    keywords: ['AI trading bot', 'crypto automation'],
    locations: ['US', 'UK', 'CA'],
    searchEngines: ['google', 'bing'],
    proxy: { type: 'residential' }
});

const results = await tracker.check();
console.log(results);
// [{ keyword: 'AI trading bot', rank: 3, url: '...' }, ...]

// Automate social media without bans
const social = await cloak.createSocialBot({
    platform: 'twitter',
    fingerprint: {
        device: 'mobile',
        os: 'iOS 17'
    }
});

// Post with human-like delays
await social.post({
    content: 'Check out this new AI tool!',
    media: ['./image.png'],
    delay: { min: 5000, max: 15000 }  // Random 5-15s delay
});

// Create custom browser profile
const profile = await cloak.createProfile({
    // Hardware
    cpu: {
        cores: 8,
        architecture: 'x86_64'
    },
    memory: 16,  // GB
    
    // Display
    screen: {
        width: 1920,
        height: 1080,
        colorDepth: 24,
        pixelRatio: 1
    },
    
    // Software
    os: {
        name: 'Windows',
        version: '11',
        platform: 'Win32'
    },
    browser: {
        name: 'Chrome',
        version: '120.0.0.0',
        language: 'en-US'
    }
});

// Save for reuse
await profile.save('my-windows-profile');

// Custom plugins for specific sites
const browser = await CloakBrowser.launch({
    plugins: [
        // Amazon-specific evasion
        require('cloakbrowser/plugins/amazon'),
        
        // Google-specific evasion
        require('cloakbrowser/plugins/google'),
        
        // Custom plugin
        {
            name: 'my-plugin',
            onBeforeRequest: (request) => {
                // Modify requests
                if (request.url.includes('tracking')) {
                    request.abort();
                }
            }
        }
    ]
});