Cloak Real Puppeteer Core

API-compatible fork of cloak-real-puppeteer-core, but the default launcher uses CloakBrowser (cloakbrowser/puppeteer) instead of Cloak.

CloakBrowser downloads and runs its patched Chromium binary automatically on first launch.

Install

npm install cloak-real-puppeteer-core puppeteer-core

Usage

import puppeteer, { launch } from 'cloak-real-puppeteer-core';

const browser = await launch({
  headless: false,
  humanize: true,
  proxy: 'http://user:pass@proxy:8080',
  geoip: true,
});

const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

You can still use Puppeteer APIs from this package:

import puppeteer from 'cloak-real-puppeteer-core';

const browser = await puppeteer.launch({
  executablePath: await (await import('cloak-real-puppeteer-core')).ensureBinary(),
});

CloakBrowser options

launch() forwards options to cloakbrowser/puppeteer, including:

• headless
• proxy (http://... or socks5://...)
• args
• stealthArgs
• timezone
• locale
• geoip
• humanize
• humanPreset
• humanConfig
• launchOptions

Utilities

import { ensureBinary, binaryInfo, clearCache, checkForUpdate } from 'cloak-real-puppeteer-core';

console.log(await ensureBinary());
console.log(await binaryInfo());

Environment

• CLOAKBROWSER_BINARY_PATH — use a local CloakBrowser/Chromium binary
• CLOAKBROWSER_CACHE_DIR — binary cache directory
• CLOAKBROWSER_AUTO_UPDATE=false — disable update checks

Notes

• This package depends on cloakbrowser for the actual browser binary and launch implementation.
• Puppeteer CDP can leak more signals than Playwright on some sites; CloakBrowser recommends Playwright for the hardest reCAPTCHA Enterprise targets.