clawdbrunner/captcha-solver

captcha-solver is a Python project for automated browsers that need to get through CAPTCHA challenges. It is meant for browser automation scripts, the kind that scrape websites, log into accounts, or test web apps. The README describes a three-layer approach: avoid the CAPTCHA when possible, click through it when it is a simple checkbox, and fall back to a paid solving service for anything harder. The first layer is a sibling project called CloakBrowser. The README claims it is a modified Chromium 146 build with 57 patches applied at the C++ source level, so that the browser looks like a real human session and avoids triggering most CAPTCHA challenges in the first place. The author reports a 0.9 reCAPTCHA v3 score and successful pass-through on Cloudflare Turnstile, with results listed for Google Search, Google Accounts, LinkedIn, Discord, and others. This layer is free. The second layer is ClickSolver, a small helper that finds a Turnstile checkbox inside an iframe and clicks it without calling any external API. The third layer is the paid fallback: the project plugs into 2Captcha and CapSolver, two commercial CAPTCHA-solving services, which between them handle over 30 challenge types including reCAPTCHA v2, v3, and Enterprise, hCaptcha, FunCaptcha, GeeTest, DataDome, Akamai, Imperva, MTCaptcha, and Amazon WAF. The README quotes a price of about $3 per 1000 solves and tabulates which service supports which CAPTCHA type. Usage is mostly a single Python class called StealthBrowser, which combines the cloaked browser, automatic detection, and automatic solving behind one navigate call. There are also command-line scripts for one-off solves when you already have a browser session and just need the token. Requirements are Python 3.10 or newer, the CloakBrowser package which downloads its own Chromium binary on first run, and at least one API key from 2Captcha or CapSolver. The license is MIT.