shenhao-stu/ohmycaptcha

これは何？

主な機能

• 01YesCaptcha形式のcreateTask、getTaskResult、getBalanceエンドポイントを実装。
• 02PlaywrightとChromiumを使って、reCAPTCHA v2/v3、hCaptcha、Cloudflare Turnstileを解決。
• 03ビジョンモデルを使い、HCaptcha、reCAPTCHA v2、FunCaptcha、AWSのグリッドなどの画像CAPTCHAを分類。
• 04SGLangまたはvLLMによるローカルモデルと、OpenAI互換API経由のクラウドモデルに対応。
• 05ポーリング方式で非同期にタスクを実行し、インメモリーのTTLを10分に設定。
• 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互換の画像認識モデルを使う、セルフホスト可能な非同期API対応CAPTCHAソルバー。 OhMyCaptchaは、YesCaptcha形式のクライアントが利用するcreateTask、getTaskResult、getBalanceエンドポイントを公開する、セルフホスト型のCAPTCHA解決サービスです。FastAPIで構築されており、このプロトコルを想定するflow2apiなどのシステムに、サードパーティー製ソルバーとしてそのまま組み込めます。

ohmycaptcha は無料で使えますか？ライセンスは？

ohmycaptcha は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ohmycaptcha は今もメンテナンスされていますか？

半年以上コミットなし。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