biusberline/cloudflare-turnstile-solver

해결하는 문제

자동 스크립트, CI 파이프라인, QA 자동화를 위한 Cloudflare Turnstile 위젯과 "5초 도전"을 간편하게 우회합니다. 필요한 cf-turnstile-response 토큰을 얻기 위해 브라우저나 웹드라이버가 필요하지 않습니다.

작동 방식

라이브러리는 대상 웹페이지의 HTML을 스캔하여 Turnstile의 data-sitekey와 선택적 data-action를 찾습니다. 이후 Peak API에 해결 작업을 제출하여 해당 사이트키와 URL에 대한 유효한 토큰을 생성합니다. 이 토큰은 폼이나 HTTP 요청에 주입되어 보안 검사를 우회할 수 있습니다.

대상 사용자

브라우저 환경을 관리하지 않고 Cloudflare Turnstile 보호 웹사이트와의 상호작용을 자동화해야 하는 개발자, 통합 엔지니어, QA 자동화 전문가.

주요 특징

• 브라우저 없이 작동: 브라우저, Node.js, 웹드라이버 없이 표준 Python 라이브러리로 작동합니다.
• 통합 워크플로우: 사이트키 탐지와 토큰 생성을 하나의 함수(token_for_page)로 처리합니다.
• CLI 지원: 쉘 스크립트 및 CI 러너에서 사용 가능한 명령줄 인터페이스를 제공합니다.
• 프록시 지원: 요청과 동일한 환경에 토큰이 바인딩되도록 프록시 사용이 가능합니다.
• 자동 재시도: create_token 함수는 일시적인 실패를 자동으로 처리합니다.