名称： 2captcha
描述： 通过 CLI 使用 2Captcha 服务解决验证码。适用于网络自动化、账户创建或表单提交过程中的验证码绕过。
主页： https://github.com/adinvadim/2captcha-cli

2Captcha 技能

通过 2Captcha 人工服务，以编程方式解决验证码。

安装

# 一键安装
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

# 验证安装
solve-captcha --version

配置

# 保存你的 2Captcha API 密钥
mkdir -p ~/.config/2captcha
echo "YOUR_API_KEY" > ~/.config/2captcha/api-key

# 或者使用环境变量
export TWOCAPTCHA_API_KEY="your-key"

在 https://2captcha.com/enterpage 获取你的 API 密钥。

快速参考

首先检查余额

./solve-captcha balance

图片验证码

# 从文件
./solve-captcha image /path/to/captcha.png

# 从 URL
./solve-captcha image "https://site.com/captcha.jpg"

# 使用选项
./solve-captcha image captcha.png --numeric 1 --math
./solve-captcha image captcha.png --comment "仅输入红色字母"

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 "天空是什么颜色？" --lang en

查找验证码参数

reCAPTCHA sitekey

在以下位置查找：
- HTML 中的 data-sitekey 属性
- reCAPTCHA iframe URL 中的 k= 参数
- 发送到 google.com/recaptcha/api2/anchor 的网络请求

hCaptcha sitekey

在以下位置查找：
- hCaptcha div 中的 data-sitekey
- 发送到 hcaptcha.com 的网络请求

Turnstile sitekey

在以下位置查找：
- Turnstile 小部件中的 data-sitekey
- 带有 cf-turnstile 类的元素

浏览器自动化工作流程

1. 检测验证码 - 检查页面是否包含验证码元素
2. 提取参数 - 从页面源代码中获取 sitekey/challenge
3. 通过 CLI 解决 - 使用参数调用 solve-captcha
4. 注入令牌 - 设置 g-recaptcha-response 或调用回调函数

示例：注入 reCAPTCHA 令牌

// 从 solve-captcha 获取令牌后
document.getElementById('g-recaptcha-response').value = token;
// 或者调用已定义的回调函数（如果存在）
___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

注意事项

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