2Captcha 技能

使用 2Captcha 人工服务以编程方式解决验证码。

安装

# 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-captcha

# Verify
solve-captcha --version

配置

# Save your 2Captcha API key
mkdir -p ~/.config/2captcha
echo "YOUR_API_KEY" > ~/.config/2captcha/api-key

# Or use environment variable
export TWOCAPTCHA_API_KEY="your-key"

在以下地址获取您的 API 密钥https://2captcha.com/enterpage

快速参考

首先检查余额

./solve-captcha balance

图像验证码

# From file
./solve-captcha image /path/to/captcha.png

# From 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"

reCAPTCHA v2

./solve-captcha recaptcha2 --sitekey "6Le-wvk..." --url "https://example.com"

reCAPTCHA v3

./solve-captcha recaptcha3 --sitekey "KEY" --url "URL" --action "submit" --min-score 0.7

hCaptcha

./solve-captcha hcaptcha --sitekey "KEY" --url "URL"

Cloudflare Turnstile

./solve-captcha turnstile --sitekey "0x4AAA..." --url "URL"

FunCaptcha (Arkose)

./solve-captcha funcaptcha --public-key "KEY" --url "URL"

GeeTest

# 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

查找验证码参数

reCAPTCHA sitekey

查找：

• data-sitekeyHTML 中的属性
• k=reCAPTCHA iframe URL 中的参数
• 网络请求至谷歌验证码API端点

hCaptcha站点密钥

查找：

• data-sitekey属性位于hCaptcha验证码的div元素中
• 网络请求指向hcaptcha.com

Turnstile站点密钥

查找：

• data-sitekey属性位于Turnstile验证码组件中
• cf-turnstile类元素

浏览器自动化工作流程

1. 检测验证码- 检查页面是否存在验证码元素
2. 提取参数- 从页面源码中获取站点密钥/挑战参数
3. 通过命令行界面(CLI)解决- 使用参数调用solve-captcha工具
4. 注入令牌- 设置g-recaptcha-response或回调参数

示例：注入reCAPTCHA验证码令牌

// After getting token from solve-captcha
document.getElementById('g-recaptcha-response').value = token;
// Or call callback if defined
___grecaptcha_cfg.clients[0].callback(token);

成本意识

• 在大量自动化操作前检查余额
• 图像验证码：每次解决约0.001美元
• reCAPTCHA/hCaptcha/Turnstile：每次解决约0.003美元

错误处理

常见错误：

• ERROR_ZERO_BALANCE（余额为零错误）- 请充值账户
• ERROR_NO_SLOT_AVAILABLE（无可用槽位错误）- 几秒后重试
• ERROR_CAPTCHA_UNSOLVABLE（验证码无法解决错误）- 图像质量差或验证码无法识别
• ERROR_WRONG_CAPTCHA_ID（验证码ID错误）- 任务ID无效

注意事项

• 解决时间依类型而定，通常需要10-60秒
• reCAPTCHA v3可能需要多次尝试以获得高分
• 部分网站会检测自动化操作 - 请谨慎使用
• 令牌会过期！请在2-5分钟内使用