이 문서는 playwright-bot-bypass (v2.2)라는 도구의 기술적 사양과 설계 철학을 다루며, 이는 Playwright 환경에서 웹 자동화 탐지를 우회하기 위한 통합 프레임워크입니다. 본 프로젝트는 독자적인 새로운 스텔스 엔진을 개발하는 것이 아니라, 검증된 도구들을 결합하여 자동화된 브라우저가 인간 사용자와 구별되지 않도록 최적화된 설정을 제공하는 데 목적이 있습니다.

핵심 방법론 및 기술적 구성

이 도구는 크게 세 가지 계층으로 구성된 통합 전략을 취합니다.

1. 기반 계층 (Upstream Integration):
   • rebrowser-playwright를 사용하여 Playwright의 고질적인 문제인 CDP Runtime.enable 누출을 방지하고 navigator.webdriver 값을 false로 보고하도록 합니다.
   • channel: 'chrome'을 명시하여 실제 설치된 Google Chrome을 구동함으로써, JS 레벨에서 가짜로 생성된 정보가 아닌 실제 GPU 가속(WebGL), PluginArray, 하드웨어 일관성을 확보합니다.

2. Artifact 스트립 (Artifact Stripping):
   • Playwright가 주입하는 식별자인 window.__pwInitScripts 및 __playwright*와 같은 내부 객체를 네비게이션마다 삭제하는 addInitScript를 구현합니다.
   • 특히 v2.2에서는 기존 방식처럼 navigator 객체 내의 값들을 강제로 조작(Fake)하지 않습니다. 이는 오히려 값이 일관성 없이 설정되어 탐지되는 역효과를 초래하기 때문이며, 대신 하드웨어와 일관된 네이티브 브라우저 속성을 유지합니다.

3. 환경 설정 (Environment Tuning):
   • Launch 인자값으로 --disable-blink-features=AutomationControlled를 적용합니다.
   • 인간다운 동작을 위해 simulateMouseMovement(), humanType(), humanDelay()와 같은 도우미 함수를 제공하여 behavioral 분석을 회피합니다.

주요 기술적 특징

• 원-임포트 팩토리: createStealthBrowser() 함수 하나로 스텔스 설정이 완료된 browser와 page 객체를 반환합니다.
• 검증된 탐지 우회: sannysoft, rebrowser-detector, CreepJS 등 9개의 주요 핑거프린트/자동화 탐지 도구에서 9/9의 통과율을 기록합니다.
• 상태 유지 및 편의성: storageState를 통한 쿠키 유지, 프록시 설정, 다국어 locale 설정 등 실제 사용자의 브라우징 환경을 재현합니다.

결론

이 프로젝트는 웹 사이트의 비헤이비어 분석이나 IP 평판, 로그인 월(999 에러 등)과 같은 서버 측 차단은 해결할 수 없다는 한계를 명확히 합니다. 그러나 자동화 프레임워크 탐지(Automation Framework Detection) 및 핑거프린팅 기반의 로봇 탐지 시나리오에서는 검증된 레시피를 통해 매우 높은 수준의 우회 성공률을 보장합니다. 사용자는 본 도구를 QA, 접근성 테스트, 웹 연구 등 허가된 범위 내에서만 사용해야 하며, 각 사이트의 robots.txt와 Terms of Service를 준수해야 합니다.