보안 장벽에 막혀 멈추던 웹 자동화 작업을 다시 움직이게 하는 브라우저
클라우드플레어 터너스틸이나 리캡차 같은 보안 장벽에 막혀 데이터를 수집하지 못했던 경험이 있다면, 이제 그 장벽을 자연스럽게 넘을 수 있습니다. 이 도구는 크로미움 브라우저의 소스 코드 자체를 수정해 봇으로 인식되지 않도록 만든 특수 브라우저입니다. 기존에 쓰던 자동화 코드를 거의 그대로 유지하면서, 마치 사람이 직접 마우스를 움직이고 타이핑하는 것처럼 행동하는 브라우저를 실행할 수 있습니다.
소스 코드 레벨에서 지문을 바꾸다
기존의 스텔스 도구들은 자바스크립트를 주입하거나 설정값을 조정하는 방식으로 봇 탐지를 우회하려 하지만, 최신 보안 시스템은 이러한 표면적인 변조를 쉽게 잡아냅니다. 이 저장소는 다른 접근 방식을 취합니다. 크로미움의 C++ 소스 코드에서 87개 지점을 직접 패치하여 캔버스, 웹글, 오디오, 폰트, GPU, 화면 해상도, 웹RTC, 네트워크 타이밍, 자동화 신호, CDP 입력 동작까지 모두 실제 브라우저와 동일하게 보이도록 수정했습니다. 이 패치들은 바이너리에 컴파일되어 들어가기 때문에, 탐지 사이트는 이를 실제 크롬 브라우저로 인식합니다. 결과적으로 navigator.webdriver 값이 false로 보고되고, 플러그인 목록이나 window.chrome 객체도 실제 크롬과 동일하게 나타납니다.
사람처럼 행동하게 만드는 한 줄 설정
단순히 지문만 숨기는 것만으로는 부족할 수 있습니다. 최근 봇 탐지 시스템은 마우스 움직임의 곡선, 키보드 타이핑 속도, 스크롤 패턴 같은 행동적 신호까지 분석합니다. 이 도구는 humanize=True 플래그 하나만 추가하면 이러한 모든 상호작용을 실제 사용자와 유사하게 변경합니다. 베지어 곡선을 따르는 마우스 움직임, 문자 하나하나에 다른 타이핑 지연, 자연스러운 스크롤 패턴이 적용되어 행동 기반 탐지를 통과할 수 있습니다. 또한 geoip=True 옵션을 사용하면 프록시 IP의 위치를 자동으로 감지해 시간대와 로케일을 맞춰주며, 웹RTC를 통한 IP 유출도 자동으로 차단합니다.
기존 코드와의 호환성
이 도구는 플레이위트나 퍼펫이어 API를 그대로 따릅니다. 기존 프로젝트에서 playwright를 cloakbrowser로 import만 바꾸면 됩니다. launch() 함수를 호출하면 표준 플레이위트 Browser 객체를 반환하므로, new_page(), goto(), click() 등 기존에 쓰던 모든 메서드가 동일하게 동작합니다. 파이썬, 자바스크립트, 그리고 .NET 환경에서도 사용할 수 있으며, 첫 실행 시 필요한 크로미움 바이너리(약 200MB)가 자동으로 다운로드됩니다. 도커 컨테이너나 VPS에서도 로컬 환경과 동일한 방식으로 작동하며, 환경에 따른 추가 설정이 필요 없습니다.
라이선스 키와 무료/유료 버전
가장 최신의 크로미움 바이너리를 사용하려면 라이선스 키가 필요합니다. 깃허브 계정으로 로그인하면 무료 키를 발급받아 최신 빌드를 사용할 수 있으며, 동시 세션 1개까지 지원합니다. 프로 버전은 동시 세션 수를 5개, 20개, 200개, 2,000개 이상으로 확장할 수 있고, 새로운 패치가 적용되는 최신 빌드에 우선 접근할 수 있습니다. 무료 버전은 깃허브 릴리스에 공개된 이전 버전(v146)을 사용할 수 있지만, 봇 탐지 기술이 빠르게 변하기 때문에 오래된 바이너리는 탐지될 가능성이 높아집니다. cloakbrowser login 명령어로 키를 등록하거나, 환경 변수 CLOAKBROWSER_LICENSE_KEY를 설정하면 됩니다.
사용 전 확인해야 할 사항
이 도구는 캡차를 해결하는 것이 아니라, 캡차가 뜨지 않도록 하는 것이 목적입니다. 따라서 캡차 해결 서비스나 프록시 로테이션 기능은 내장되어 있지 않으며, 주거용 프록시를 직접 준비해야 합니다. 데이터센터 IP보다는 주거용 IP를 사용하는 것이 탐지 우회 성공률을 높입니다. 또한 일부 사이트는 헤드리스 모드를 여전히 탐지할 수 있으므로, headless=False로 헤드드 모드를 사용하는 것이 더 안전합니다. 바이너리 다운로드 시 Ed25519 서명을 검증하여 위변조 여부를 확인하지만, 보안이 중요한 환경에서는 항상 최신 빌드를 유지하는 것이 좋습니다. .NET 클라이언트는 커뮤니티가 유지 관리하며, 와이드바인(DRM) 지원은 리눅스 환경에서만 가능합니다.