Solve CAPTCHAs using 2Captcha service via CLI. Use for bypassing captchas during web automation, account creation, or form submission.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Solve CAPTCHAs programmatically using the 2Captcha human-powered service.
# One-line install curl -fsSL https://raw.githubusercontent.com/adinvadim/2captcha-cli/main/solve-captcha \ -o /usr/local/bin/solve-captcha && chmod +x /usr/local/bin/solve-captchaVerify
solve-captcha --version
# Save your 2Captcha API key mkdir -p ~/.config/2captcha echo "YOUR_API_KEY" > ~/.config/2captcha/api-keyOr use environment variable
export TWOCAPTCHA_API_KEY="your-key"
Get your API key at https://2captcha.com/enterpage
./solve-captcha balance
# From file ./solve-captcha image /path/to/captcha.pngFrom URL
./solve-captcha image "https://site.com/captcha.jpg"
With options
./solve-captcha image captcha.png --numeric 1 --math ./solve-captcha image captcha.png --comment "Enter red letters only"
./solve-captcha recaptcha2 --sitekey "6Le-wvk..." --url "https://example.com"
./solve-captcha recaptcha3 --sitekey "KEY" --url "URL" --action "submit" --min-score 0.7
./solve-captcha hcaptcha --sitekey "KEY" --url "URL"
./solve-captcha turnstile --sitekey "0x4AAA..." --url "URL"
./solve-captcha funcaptcha --public-key "KEY" --url "URL"
# v3 ./solve-captcha geetest --gt "GT" --challenge "CHALLENGE" --url "URL"v4
./solve-captcha geetest4 --captcha-id "ID" --url "URL"
./solve-captcha text "What color is the sky?" --lang en
Look for:
data-sitekeyk=google.com/recaptcha/api2/anchorLook for:
data-sitekeyhcaptcha.comLook for:
data-sitekeycf-turnstileg-recaptcha-response// After getting token from solve-captcha document.getElementById('g-recaptcha-response').value = token; // Or call callback if defined ___grecaptcha_cfg.clients[0].callback(token);
Common errors:
ERROR_ZERO_BALANCEERROR_NO_SLOT_AVAILABLEERROR_CAPTCHA_UNSOLVABLEERROR_WRONG_CAPTCHA_IDNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.