CapSolver Skill

Use this skill to automatically resolve various CAPTCHA challenges using the CapSolver API service. The skill supports Geetest, reCAPTCHA v2/v3, MTCaptcha, DataDome, AWS WAF, Cloudflare Turnstile, Cloudflare Challenge, and more.

Authentication: Set API_KEY in your environment or in a .env file in the repo root.

Errors: If it fails, the script will exit with code 1.

Solver

Task(Recognition)

ImageToTextTask

Solve text-based captcha.

Command:

python3 ./scripts/solver.py ImageToTextTask --body "base64_image_data"
python3 ./scripts/solver.py ImageToTextTask --body "base64_image_data" --module "module_001"

Optional:

• --websiteURL: Page source url to improve accuracy.
• --body: Base64 encoded content of the image (no newlines, no data:image/***;charset=utf-8;base64,).
• --module: Specify the module. All supported module references: https://docs.capsolver.com/en/guide/recognition/ImageToTextTask/#independent-module-support.
• --images: Only for number module, Support up to 9 base64 encoded images each time.
• --max-retries: Maximum number of retries (default: 60).

ReCaptchaV2Classification

Classify reCAPTCHA v2 images.

Command:

python3 ./scripts/solver.py ReCaptchaV2Classification --question "question" --image "base64_image_data"

Optional:

• --websiteURL: Page source url to improve accuracy.
• --websiteKey: Website key to improve accuracy.
• --question: Please refer to: https://docs.capsolver.com/guide/recognition/ReCaptchaClassification/.
• --image: Base64 image string.
• --max-retries: Maximum number of retries (default: 60).

AwsWafClassification

Classify AWS WAF images.

Command:

python3 ./scripts/solver.py AwsWafClassification --question "question" --images "base64_image_data1" "base64_image_data2" "base64_image_data3"

Too many images may exceed the command line length limit. You can try writing the base64 values of the images line by line to a file (such as aws_images.txt) and then using the xargs command to pass them to the --images parameter:

cat aws_images.txt | xargs python3 ./scripts/solver.py AwsWafClassification --question "question" --images

Optional:

• --websiteURL: Page source url to improve accuracy.
• --question: Please refer to: https://docs.capsolver.com/guide/recognition/AwsWafClassification/.
• --images: Base64 image string, aws:grid supports 9 images each time, other types support 1 image each time.
• --max-retries: Maximum number of retries (default: 60).

VisionEngine

Advanced AI vision-based captcha solving.

Command:

python3 ./scripts/solver.py VisionEngine --module "module" --image "base64_image_data" --imageBackground "base64_image_background_data"