Skip to main content

Solve Captcha

Solves image-based captchas by extracting text from the image. Supports various captcha formats including Google, Yandex, Steam, Facebook, and other popular captcha providers.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Session - The session ID returned from the Create Session node.
  • Captcha Image - Base64 encoded image data of the captcha. The format should be a data URL (e.g., data:image/png;base64,iVBORw0KG...).

Options​

  • Module - Recognition module optimized for specific captcha types. Available options:
    • Amazon - Optimized for Amazon captchas
    • Bot Detect - For BotDetect captchas
    • Facebook - Facebook captcha recognition
    • GMX - GMX email captchas
    • Google - Google image captchas (default)
    • Hotmail - Hotmail/Outlook captchas
    • Mail.ru - Mail.ru captchas
    • Steam - Steam platform captchas
    • VK - VKontakte captchas
    • Yandex - Yandex captchas
    • Yandex New - New Yandex captcha format
    • Yandex Wave - Yandex Wave captchas
    • Universal - General-purpose recognition

Output​

  • Text - The recognized text extracted from the captcha image.

How It Works​

The Solve Captcha node processes image-based captchas and returns the recognized text. When executed, it:

  1. Retrieves the session using the provided session ID
  2. Receives the base64-encoded captcha image
  3. Creates a captcha solving task with the specified module
  4. Sends the task to CapMonster Cloud for processing
  5. Waits for the solution
  6. Returns the recognized text

Requirements​

  • A valid CapMonster session (from Create Session node)
  • A base64-encoded captcha image
  • Sufficient account balance
  • The image must be in a supported format (PNG, JPEG, GIF, BMP)

Error Handling​

The node will fail in the following cases:

  • Missing or invalid session ID
  • Session not found
  • Empty or invalid captcha image data
  • Unsupported image format
  • Insufficient account balance
  • Network connectivity issues
  • Captcha solving timeout
  • Unrecognizable captcha

Usage Notes​

  • The captcha image must be base64-encoded with a data URL prefix
  • The recognition accuracy depends on the captcha complexity and module selection
  • Different modules are optimized for different captcha styles
  • Use the most specific module for better accuracy
  • The Universal module works for most captchas but may be less accurate
  • Solving time typically ranges from 5-15 seconds

Capturing Captcha Images​

You can capture captcha images using various methods:

Using Browser Package​

Browser: Take Screenshot (element selector)
  → Convert to Base64
    → Solve Captcha

Using HTTP Package​

HTTP: Download Image
  → Convert to Base64
    → Solve Captcha

Example: Solving Google Captcha​

Inputs:

  • Session: (from Create Session node)
  • Captcha Image: data:image/png;base64,iVBORw0KGgoAAAANS...

Options:

  • Module: Google

Output:

  • Text: "abc123"

Example: Complete Flow​

Create Session
  → Browser: Navigate to page
    → Browser: Take Screenshot of captcha
      → Convert image to base64
        → Solve Captcha (Module: Google)
          → Browser: Type text into input field
            → Browser: Click submit button

Module Selection Tips​

  • Use specific modules when you know the captcha provider for better accuracy
  • Google module works well for most distorted text captchas
  • Universal module is a fallback when you're unsure of the captcha type
  • Steam/VK/Yandex modules are highly optimized for their respective platforms
  • Test different modules if accuracy is low with your initial selection

Best Practices​

  • Always specify the most appropriate module for your captcha type
  • Handle solving errors gracefully with retry logic
  • Add delays between retry attempts to avoid rate limiting
  • Log captcha images and results for debugging purposes
  • Monitor accuracy and adjust module selection if needed
  • Consider implementing a fallback to different modules if solving fails

Common Issues and Solutions​

Issue: Low recognition accuracy

  • Solution: Try a different module optimized for your captcha type
  • Solution: Ensure the image quality is good (not too blurry or distorted)
  • Solution: Check that the entire captcha is captured in the image

Issue: Base64 encoding errors

  • Solution: Verify the data URL prefix is correct (data:image/png;base64,)
  • Solution: Ensure the image is properly encoded without line breaks

Issue: Timeout errors

  • Solution: Check your internet connection
  • Solution: Verify CapMonster Cloud service status
  • Solution: Implement retry logic with exponential backoff

Cost Considerations​

  • Image captchas are typically the most affordable captcha type
  • Pricing varies by captcha complexity
  • Check your balance before processing large batches
  • Consider bulk pricing for high-volume operations