2Captcha 技能

使用 2Captcha 人工驱动服务以编程方式求解 CAPTCHA。

源码与反馈：https://github.com/adinvadim/2captcha-cli

隐私与授权使用

该技能会将 CAPTCHA 图像、页面 URL、sitekey、挑战 ID 及任务元数据发送至 2Captcha，由其服务及人工解答者进行处理。请仅将其用于已获授权的自动化场景；除非获得明确批准，否则不得提交敏感信息、受监管数据、内部数据或第三方用户数据。

安装

# 使用 skills.sh 安装此 agent 技能
npx skills add adinvadim/2captcha-cli

# 或使用 ClawHub/OpenClaw 安装
openclaw skills install 2captcha

# 审阅源码后安装 CLI
git clone https://github.com/adinvadim/2captcha-cli.git
cd 2captcha-cli
python3 solve-captcha --version
mkdir -p ~/.local/bin
ln -sf "$PWD/solve-captcha" ~/.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 密钥

CLI 仅从以下任一位置读取凭据：--api-key 参数、TWOCAPTCHA_API_KEY 环境变量、~/.config/2captcha/api-key 文件或 ~/.2captcha-api-key 文件。

快速参考

首先检查余额

solve-captcha balance

图像型 CAPTCHA

# 从本地文件读取
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"

文本问答型 CAPTCHA

solve-captcha text "天空是什么颜色？" --lang en

CAPTCHA 参数获取方法

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. 检测 CAPTCHA —— 检查页面是否包含 CAPTCHA 元素
2. 提取参数 —— 从页面源码中获取 sitekey / challenge
3. 调用 CLI 求解 —— 使用参数执行 solve-captcha
4. 注入 token —— 设置 g-recaptcha-response 字段值或调用对应回调函数

示例：注入 reCAPTCHA token

// 在通过 solve-captcha 获取 token 后
document.getElementById('g-recaptcha-response').value = token;
// 若已定义回调函数，则调用之
___grecaptcha_cfg.clients[0].callback(token);

费用意识

• 大规模自动化前，请先检查账户余额
• 图像型 CAPTCHA：约 $0.001 / 次求解
• reCAPTCHA / hCaptcha / Turnstile：约 $0.003 / 次求解

错误处理

常见错误：

• ERROR_ZERO_BALANCE —— 账户余额不足，请充值
• ERROR_NO_SLOT_AVAILABLE —— 当前无可用处理队列，请数秒后重试
• ERROR_CAPTCHA_UNSOLVABLE —— 图像质量差或 CAPTCHA 本身不可解
• ERROR_WRONG_CAPTCHA_ID —— 任务 ID 无效

注意事项

• 求解耗时通常为 10–60 秒，具体取决于类型
• reCAPTCHA v3 可能需多次尝试才能获得高分
• 部分网站可检测自动化行为，请谨慎使用
• token 具有有效期！请在 2–5 分钟内完成使用