Repolode
shenhao-stu

shenhao-stu/ohmycaptcha

Playwright 자동화와 OpenAI 호환 비전 모델을 사용하는 자체 호스팅 CAPTCHA 솔버

대체할 수 있는 제품:YesCaptcha

스타
897
포크
276
열린 이슈
10
마지막 커밋
7개월 전

어떤 프로젝트인가요?

OhMyCaptcha는 YesCaptcha 방식의 클라이언트에서 사용하는 createTask, getTaskResult, getBalance 엔드포인트를 제공하는 자체 호스팅 CAPTCHA 해결 서비스입니다. FastAPI로 구축되었으며, flow2api처럼 이 프로토콜을 지원하는 시스템에서 서드파티 솔버를 바로 대체해 사용할 수 있도록 설계되었습니다.

이 서비스는 두 종류의 작업을 처리합니다. reCAPTCHA v2/v3(Enterprise 변형 포함), hCaptcha, Cloudflare Turnstile은 Playwright로 헤드리스 Chromium을 구동해 토큰을 생성합니다. 이미지 CAPTCHA 및 분류 작업은 이미지를 비전 모델로 전송하며, SGLang이나 vLLM 같은 로컬 서버 또는 원격 OpenAI 호환 엔드포인트를 사용할 수 있습니다.

작업은 비동기적으로 실행되며 10분 TTL의 인메모리 큐에 저장되므로 결과를 폴링해 가져옵니다. 모델 엔드포인트, 재시도 및 타임아웃 제한, 헤드리스 브라우저 모드, 인증용 클라이언트 키 등을 설정할 수 있습니다. 로컬 머신, Render, Hugging Face Spaces에 배포하는 방법이 문서화되어 있습니다.

핵심 기능

  • 01YesCaptcha 방식의 createTask, getTaskResult, getBalance 엔드포인트를 구현합니다.
  • 02Playwright와 Chromium으로 reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile을 해결합니다.
  • 03비전 모델을 사용해 HCaptcha, reCAPTCHA v2, FunCaptcha, AWS 그리드 등의 이미지 CAPTCHA를 분류합니다.
  • 04SGLang 또는 vLLM을 통한 로컬 모델과 OpenAI 호환 API를 통한 클라우드 모델을 지원합니다.
  • 05폴링 방식으로 작업을 비동기 실행하고 10분 TTL의 인메모리 큐에 저장합니다.
  • 06Docker를 사용해 로컬에 배포하거나 Render 및 Hugging Face Spaces에 배포할 수 있습니다.

활용 사례

  • YesCaptcha 프로토콜을 사용하는 flow2api 또는 기타 도구의 CAPTCHA 해결 백엔드로 활용합니다.
  • 권한이 부여된 보안 평가에서 사이트의 reCAPTCHA, hCaptcha 또는 Turnstile 연동 동작을 테스트합니다.
  • 유료 서드파티 서비스 대신 자체 인프라에서 CAPTCHA 인식을 실행합니다.

빠른 시작

  1. 1

    가상 환경을 만들고 활성화합니다

    python -m venv .venv && source .venv/bin/activate
  2. 2

    Python 종속 항목을 설치합니다

    pip install -r requirements.txt
  3. 3

    Playwright Chromium 브라우저를 설치합니다

    playwright install --with-deps chromium
  4. 4

    모델 환경 변수를 설정하고 CLIENT_KEY를 설정한 다음 서버를 시작합니다

    python main.py

사용 전 알아둘 점

  • 작업은 메모리에 저장되며 TTL은 10분이므로 재시작하면 사라집니다.
  • 브라우저 기반 해결은 환경, IP 평판, 대상 사이트의 동작에 따라 달라집니다.
  • 이미지 분류 품질은 사용하는 비전 모델에 따라 달라집니다.
  • 상용 CAPTCHA 서비스의 모든 기능이 구현된 것은 아니며 minScore도 적용되지 않습니다.

토픽

자주 묻는 질문

ohmycaptcha은(는) 무엇인가요?
Playwright 자동화와 OpenAI 호환 비전 모델을 사용하는 자체 호스팅 CAPTCHA 솔버 OhMyCaptcha는 YesCaptcha 방식의 클라이언트에서 사용하는 createTask, getTaskResult, getBalance 엔드포인트를 제공하는 자체 호스팅 CAPTCHA 해결 서비스입니다. FastAPI로 구축되었으며, flow2api처럼 이 프로토콜을 지원하는 시스템에서 서드파티 솔버를 바로 대체해 사용할 수 있도록 설계되었습니다.
ohmycaptcha은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ohmycaptcha은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ohmycaptcha은(는) 아직 유지보수되고 있나요?
6개월 이상 커밋 없음. ohmycaptcha의 마지막 커밋은 2026년 3월 9일입니다.
ohmycaptcha은(는) 어디에 사용할 수 있나요?
YesCaptcha 프로토콜을 사용하는 flow2api 또는 기타 도구의 CAPTCHA 해결 백엔드로 활용합니다. 권한이 부여된 보안 평가에서 사이트의 reCAPTCHA, hCaptcha 또는 Turnstile 연동 동작을 테스트합니다. 유료 서드파티 서비스 대신 자체 인프라에서 CAPTCHA 인식을 실행합니다.
ohmycaptcha는 어떻게 설치하나요?
가상 환경을 만들고 활성화합니다: python -m venv .venv && source .venv/bin/activate Python 종속 항목을 설치합니다: pip install -r requirements.txt Playwright Chromium 브라우저를 설치합니다: playwright install --with-deps chromium 모델 환경 변수를 설정하고 CLIENT_KEY를 설정한 다음 서버를 시작합니다: python main.py
ohmycaptcha은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/shenhao-stu/ohmycaptcha

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트