CloakHQ/CloakBrowser

Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 50+ tests passed.

CloakBrowser – 자동화를 위한 스텔스 Chromium

개요 – CloakBrowser는 소스 코드에 패치(약 87개의 C++ 변경)를 적용하여 안티봇 서비스가 찾는 일반적인 "자동화" 지문을 숨기는 커스텀 빌드 Chromium 바이너리입니다. 이 프로젝트는 Playwright(및 Puppeteer)와 동일한 API를 노출하는 얇은 Python, JavaScript/Node, .NET 래퍼를 제공하므로 가져오기만 변경하면 기존 스크래핑 또는 테스트 스크립트에 바로 넣을 수 있습니다.

주요 기능

소스 수준 스텔스 – 지문(canvas, WebGL, GPU, 화면 크기, WebRTC, 타이밍, navigator.webdriver 등)은 JavaScript 주입이나 플래그 설정이 아니라 컴파일 시 변경됩니다. 이로 인해 탐지 서비스에 브라우저가 일반 Chrome 설치처럼 보입니다.
Playwright/Puppeteer 드롭인 – from cloakbrowser import launch(Python) 또는 import {launch} from 'cloakbrowser'(JS)는 표준 Playwright 실행 호출과 정확히 동일하게 작동합니다. 가져오기 외에 코드 변경이 필요하지 않습니다.
인간과 유사한 상호작용 – 단일 humanize=True 플래그로 마우스 움직임, 타이핑, 스크롤이 사실적인 베지어 곡선과 타이밍 패턴을 따르게 하여 행동 검사를 통과하는 데 도움이 됩니다.
프록시 및 지리 IP 지원 – HTTP 또는 SOCKS5 프록시를 제공할 수 있으며, geoip=True를 사용하면 브라우저가 시간대/로케일을 프록시의 출구 IP와 자동으로 일치시키고 WebRTC ICE 후보를 스푸핑합니다.
크로스 플랫폼 바이너리 – Linux(x64/ARM64), Windows, macOS(Intel 및 Apple Silicon)용 사전 컴파일된 스텔스 Chromium. 바이너리는 첫 실행 시 자동 다운로드(약 200 MiB)되고 Ed25519 서명으로 검증됩니다.
Pro 버전 – 무료 티어는 최신 빌드로 하나의 동시 세션을 제공하며, 유료 플랜은 여러 동시 세션, 우선 업데이트, 지원을 제공합니다.
CloakBrowser Manager – 선택적 오픈 소스 GUI(별도 저장소)로, 무제한 격리 프로필을 생성할 수 있으며 각 프로필은 자체 지문, 프록시, 영구 상태를 가지며 상용 안티 디텍트 브라우저와 유사합니다.

일반적인 사용법

from cloakbrowser import launch

browser = launch(
    proxy="http://user:pass@residential-proxy:8080",
    geoip=True,
    headless=False,
    humanize=True,
)
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()

동일한 코드가 Node에서 import {launch} from 'cloakbrowser'로 작동합니다.

AI/자동화에 중요한 이유

많은 LLM 기반 에이전트(예: LangChain, Crawl4AI, 자율 웹 에이전트)는 Cloudflare Turnstile, reCAPTCHA v3, FingerprintJS 등에 차단되지 않는 브라우저가 필요합니다. CloakBrowser는 이러한 검사를 통과하는 "진짜" Chrome을 제공하여 에이전트가 콘텐츠를 안정적으로 검색할 수 있게 합니다.
네이티브 Playwright API를 사용하므로 기존 Python/JS 자동화 파이프라인과 원활하게 통합되며, Chrome 업데이트마다 깨지는 JS 전용 스텔스 플러그인의 유지 관리 문제가 없습니다.

제한 사항

CloakBrowser는 실제로 나타나는 CAPTCHA를 해결하지 않습니다. 단지 표시될 가능성을 줄일 뿐입니다. 챌린지가 통과되면 별도의 해결 서비스나 수동 처리가 필요합니다.
무료 티어는 하나의 동시 세션으로 제한됩니다. 대규모 스크래핑에는 Pro 라이선스가 필요합니다.

결론 – CloakBrowser는 Playwright/Puppeteer 자동화를 위한 스텔스 Chromium 바이너리를 제공하는 진정하고 활발히 유지 관리되는 도구로, 안티 디텍트 브라우저와 동일한 사용자를 대상으로 하면서 오픈 소스 래퍼와 소스 수준 지문 제거에 명확히 초점을 맞추고 있습니다.

CloakHQ/CloakBrowser

CloakBrowser – 자동화를 위한 스텔스 Chromium

관련