LLM Wiki

CloakBrowser — source-level stealth Chromium for Playwright/Puppeteer

4 min read

CloakBrowser

C++ 소스 레벨 fingerprint 패치가 들어간 stealth Chromium. Playwright/Puppeteer 드롭인 대체로 쓰면서 bot detection을 최대한 우회하는 브라우저 런타임이다.

개요

CloakBrowser는 **“일반 Chromium처럼 보이도록 수정된 브라우저 자체”**에 가까운 프로젝트다. JS injection이나 설정 꼼수가 아니라, Chromium 소스 레벨에서 canvas, WebGL, audio, fonts, GPU, screen, WebRTC, network timing, automation signals를 패치했다고 주장한다.

이 점 때문에 기존의 playwright-stealth 계열보다 더 깊은 레이어를 건드린다. 사용자 관점에서는 Playwright/Puppeteer 코드를 거의 그대로 유지하면서 import만 바꿔 붙이는 드롭인 대체로 접근할 수 있다.

핵심 포인트

  • source-level Chromium patches: fingerprint/automation signal을 브라우저 엔진 레벨에서 수정
  • drop-in replacement: Python / JavaScript에서 Playwright, Puppeteer 코드와 거의 동일하게 사용
  • humanize=True: 마우스 곡선, 키보드 타이밍, 스크롤 패턴을 사람처럼 흉내
  • binary auto-download: 첫 실행 시 stealth Chromium 바이너리를 자동 다운로드
  • profile manager: 별도 Browser Profile Manager로 프로필·프록시·세션을 관리
  • 언어 지원: Python, Node.js, Playwright, Puppeteer

사용 예시

from cloakbrowser import launch
 
browser = launch(humanize=True)
page = browser.new_page()
page.goto("https://protected-site.com")
browser.close()
import { launch } from 'cloakbrowser';
 
const browser = await launch({ humanize: true });
const page = await browser.newPage();
await page.goto('https://protected-site.com');
await browser.close();

설치

pip install cloakbrowser
npm install cloakbrowser playwright-core
npm install cloakbrowser puppeteer-core

프로젝트 정보

해석

이 레포는 AI 에이전트용 브라우저 스택에서 두 축을 동시에 건드린다.

  • Obscura처럼 경량 브라우저 엔진을 새로 만드는 방향이 아니라, Chromium 호환성을 유지한 채 스텔스 레이어를 깊게 넣는다.
  • Camofox처럼 anti-detection을 전면에 내세우지만, Firefox 대신 Chromium/Playwright 생태계에 더 가깝다.

관점에서는 Playwright 호환을 유지하면서 탐지 회피를 강화한 실행면으로 볼 수 있다. 웹 자동화/스크래핑/에이전트 도구에서 차단이 잦은 경우 비교 가치가 높다.

다만 README 주장치가 강한 편이라, 실제 도입 전에는 다음을 따로 검증하는 편이 안전하다.

  • target site별 차단율
  • 로그인 세션 안정성
  • humanize=True의 실제 탐지 회피 효과
  • Puppeteer 호환성
  • 업데이트 주기와 바이너리 신뢰성

관련 노트

Source

그래프 뷰

백링크