Skip to main content
The Captcha node solves one captcha at this point in the run. It is how a workflow solves Cloudflare Turnstile, reCAPTCHA v2, hCaptcha, AWS WAF CAPTCHA, and a site’s own text or image challenge (Custom). Put it immediately before the action that needs the captcha cleared, usually the submit or the next navigation. New workflows solve captchas only at Captcha nodes. Automatic solving, which runs the solver before each step that acts on the page, is deprecated and will be removed. Until then it is opt-in through the API: set manual_captcha_solve to false. The dashboard no longer offers this setting. Workflows created before manual solving became the default keep their setting; move them to Captcha nodes. See Workflow Settings.

Parameters

Examples

Turnstile before a submit

reCAPTCHA v2

hCaptcha after the site’s own checkbox

Some sites show their own “I am not a robot” checkbox and open the hCaptcha challenge when it is ticked. Click that checkbox first, then solve:

AWS WAF CAPTCHA after the site’s own checkbox

Some sites load the AWS WAF puzzle hidden and show it when their own “Let’s confirm you are human” checkbox is ticked. Click that checkbox first, then solve. The same node also clears AWS’s full-page “Human Verification” page; do not click its Begin button, because the node presses it:

Text (image transcription)

A distorted-character image with a text input the user must type into. Text captchas are only solved by this node, never automatically, whatever manual_captcha_solve is. The node reads the challenge and fills the field; do not author a read-and-retype loop of your own.

Custom site challenge

Some sites draw their own challenge, such as “Please enter the number value of each image” over a row of dice, or “Enter the number of bowties shown”, with a text box for the answer. Point the node at the challenge and the answer box. It reads the challenge, types the answer, and stops; add a Click node after it to submit:
When the question is written next to the image instead of inside it, also set question_selector:
A rejected answer usually brings up a new challenge, so follow the submit with a Bool Condition that checks whether the challenge is still showing and loops back to the Captcha node. Keep its max_iterations below the number of attempts the site allows.

Notes

  • If no captcha of that type is on the page, the node passes and the run continues. Custom is the exception: it does not detect a captcha, so if an XPath matches nothing within wait_time, the node fails like a Click would
  • If the captcha is present and cannot be solved, the node fails with error code CAPTCHA-E0001, so the workflow’s error-code actions (alert, retry, pause_workflow, pause_credential) apply
  • Do not add a Click on the captcha widget itself. Clicking into a half-solved widget breaks the solver. A Click on the site’s own checkbox that opens the captcha is fine
  • Detection finds the widget’s iframe or container in the top page. reCAPTCHA v2 is also found on a page embedded in an iframe from the same site, such as a security check page that shows the captcha inside the site’s own frame. Any other captcha on an embedded page, and any captcha on a page embedded from a different site, is not detected, and the node passes as if no captcha were present
  • A text captcha is found by its challenge image and the adjacent text input in the top page; the solver reads the characters and types them, retrying up to twice more (three attempts in all) against its own Submit/Verify control if a read is rejected. When no challenge is showing yet, the node waits up to 15 seconds for one to appear
  • reCAPTCHA v2 is solved by CloudCruise’s own solver
  • hCaptcha is solved by CloudCruise’s own solver. When hCaptcha is on the page but no challenge is showing yet, the node waits up to 15 seconds for one to open, and passes as soon as the widget has a token
  • AWS WAF CAPTCHA is solved by CloudCruise’s own solver, both as a puzzle inside the site’s page and as AWS’s full-page “Human Verification” check with a Begin button. When the puzzle is on the page but not showing yet, the node waits up to 15 seconds for it to appear
  • With automatic solving on, the node still runs, and is a fast no-op once the captcha is already solved. Automatic solving only acts on a challenge that is already open when a step starts, so a captcha that a site opens from its own checkbox or button still needs a Captcha node right after that click
  • Custom reads the challenge element only, types the answer into the answer box, and does not submit. Custom challenges must be on the page itself or in a frame from the same site