AI SMART HUB· Guide
Scripts · Chapter 14/14

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.

3 min read · updated Nov 20, 2026

What you need

  1. Top up YesCaptcha (yescaptcha.com) or CapSolver (capsolver.com), or both, and get your key.
  2. Open Run & settings, find the Captcha solving box, paste the key and press Save. Press Check balance to test the key.
💡 Keys are stored in the 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 typeYesCaptchaCapSolver
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.
⚠ A token (the solved code) lives about 2 minutes and works only once. Keep the Submit click right after the solve step. The command is not retried on error, so you never pay twice.

Captcha guard

This mode is on by default. When a step fails (button not found, click doesn't work…), the tool:

  1. Checks whether the page shows a captcha. This costs nothing.
  2. If it does, the tool detects the type, solves it and retries the step that failed.
  3. 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.

💡 If the failing step is inside a sub-script (called with "Call script"), the tool still solves the captcha but cannot add the step by itself. The log reminds you to add it.

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).
© 2026 AI Smart Hub · Automate Intelligence. Elevate Possibilities. · Updated Nov 20, 2026
Home · Blog · Terms · Zalo · Telegram