Solving captchas (YesCaptcha / CapSolver) and the captcha guard
One command solves reCAPTCHA, Turnstile, the Cloudflare challenge, hCaptcha, GeeTest, text-image captchas, AWS WAF and DataDome. When a step fails on a captcha, the tool solves it, retries and adds the step to your script.
What you need
- Top up YesCaptcha (yescaptcha.com) or CapSolver (capsolver.com), or both, and get your key.
- Open Run & settings, find the Captcha solving box, paste the key and press Save. Press Check balance to test the key.
du_lieu/ folder on your PC, never inside scripts. Sharing a script never leaks your key.With both keys, if one service runs out of credit or cannot solve, the tool switches to the other.
Add the command to a script
On the Script page, group File · Network · Wallet, pick Solve captcha (YesCaptcha / CapSolver). Put it after the step that opens the page with the captcha and before the Submit / Sign up click. The defaults are fine:
- Captcha type: Auto-detect. The tool scans the page.
- Service: Auto. YesCaptcha first, CapSolver on failure. There is also the reverse order if you prefer CapSolver.
- Proxy: Account proxy. The captcha is solved from the account's own IP, so the site is less suspicious.
| Captcha type | YesCaptcha | CapSolver |
|---|---|---|
| reCAPTCHA v2 (checkbox, invisible), reCAPTCHA v3 | ✔ | ✔ |
| Cloudflare Turnstile | ✔ | ✔ |
| Cloudflare challenge ("Just a moment" page) | ✔ needs proxy | ✔ needs proxy, preferred |
| hCaptcha | ✔ | ✘ |
| GeeTest v3 / v4 | ✘ | ✔ |
| Text / digit / math image captcha | ✔ | ✔ |
| AWS WAF, DataDome, MTCaptcha | ✘ | ✔ |
The result goes into {$cap}. Extra variables: {$cap_ua}, {$cap_loai} (captcha type) and {$cap_dv} (the service that solved it).
Special cases
- Text image captcha: fill Captcha image (CSS or XPath of the image) and Text input box. The tool reads the image, has it solved and types the text into the box.
- Captcha that appears only after a click (e.g. a login dialog): add the command twice. First choose Prepare: set a trap and put it before the click. Second choose Solve now after the captcha appears.
- Cloudflare challenge: the account must have a public proxy. The service gets the cookie through that proxy, the tool loads it into the browser and reloads the page.
- reCAPTCHA v3: if the site uses its own action name, fill it into the Action box.
Captcha guard
This mode is on by default. When a step fails (button not found, click doesn't work…), the tool:
- Checks whether the page shows a captcha. This costs nothing.
- If it does, the tool detects the type, solves it and retries the step that failed.
- If that step now passes, the tool adds a "Solve captcha" step to your script right before it and saves. The old script is kept in the
ban_cu/folder next to the script file.
From the next run the script solves the captcha right away instead of waiting for an error. To limit cost, each account auto-solves at most 3 times per run. On pages without a captcha the failing step is reported as usual.
To turn it off: untick the 2 boxes in the Captcha solving box on Run & settings.
Common errors
- ERROR_ZERO_BALANCE: out of credit. Top up, or add the other service's key so the tool switches.
- ERROR_KEY_DOES_NOT_EXIST / KEY_DENIED: wrong key. Paste it again in the Captcha solving box.
- ERROR_CAPTCHA_UNSOLVABLE: the service could not solve it this time and did not charge. Rerun that account.
- Proxy … is a local address: proxies like 127.0.0.1 or 192.168.x are unreachable for the service. The tool solves from the service's IP instead, except the Cloudflare challenge which needs a public proxy.
- No captcha detected on the page: pick Captcha type by hand, and fill Sitekey if needed (press F12 and search for
sitekey).