# ZFC-Digital/puppeteer-real-browser

This package is designed to bypass puppeteer's bot-detecting captchas such as Cloudflare. It acts like a real browser and can be managed with puppeteer.

Repository: https://github.com/ZFC-Digital/puppeteer-real-browser
Canonical: https://ross.abutalabs.com/products/puppeteer-real-browser
Homepage: https://www.npmjs.com/package/puppeteer-real-browser
Language: JavaScript
License: MIT
License Family: permissive
Topics: cloudflare-bypass, puppeteer, puppeteer-cloudflare-captcha, puppeteer-extra-plugin, puppeteer-fingerprint, puppeteer-real-browser, undetected-browser, puppeteer-undetected-browser, undetected-puppeteer, undetected
Last push: 2025-09-03T17:09:37+00:00

## Health v2 (maintenance only)
Score: 35/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 40, release rhythm 8, longevity 70
- inputs: {"age_days": 985, "days_push": 364, "days_rel": 723, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1642, forks 204 (observed 2026-08-28T04:05:15.365882+00:00)

## What it is
A Node.js library that wraps Puppeteer with a real-browser profile to bypass bot detection systems like Cloudflare and Turnstile captchas. It exposes a connect() API returning standard Puppeteer page and browser objects for automation.

## Use cases
- scrape websites protected by cloudflare
- bypass turnstile captcha in puppeteer
- automate browser without being detected as a bot
- pass cloudflare challenge with puppeteer
- undetected browser automation in nodejs
- use puppeteer with real browser fingerprint

## When to choose
- you need to automate or scrape Cloudflare-protected sites with Puppeteer-style APIs
- you want a drop-in undetected browser for Node.js scripts

## When to avoid
- you need an actively maintained library - the repo no longer receives updates
- you only need Cloudflare WAF clearance - the authors recommend cf-clearance-scraper instead
- your target site does not use bot detection - plain Puppeteer or Playwright suffices

## Facets
- artifact type: library
- maturity: abandoned
- function: web-scraping, http-client, security
- domain: crawlers, web-development, security
- platform: windows
- tags: puppeteer, cloudflare-bypass, anti-bot-detection, browser-automation, captcha-bypass, stealth-browser, turnstile, automation, nodejs, linux, macos

## Member repositories
- ZFC-Digital/puppeteer-real-browser (main) score 35

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:15.365882+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:46:19.548006+00:00, confidence not recorded.
  - readme: https://github.com/ZFC-Digital/puppeteer-real-browser (fetched 2026-08-28T04:05:15.365882+00:00, sha b52287b029db)
- Data as of 2026-08-30T08:39:29.467469+00:00.
