2Captcha CLI

# 2Captcha Skill

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

## 安装

```bash # 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 ```

## 配置

```bash # 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" ```

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

## 快速参考

### 首先检查余额 ```bash ./solve-captcha balance ```

### 图像验证码 ```bash # 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 ```bash ./solve-captcha recaptcha2 --sitekey "6Le-wvk..." --url "https://example.com" ```

### reCAPTCHA v3 ```bash ./solve-captcha recaptcha3 --sitekey "KEY" --url "URL" --action "submit" --min-score 0.7 ```

### hCaptcha ```bash ./solve-captcha hcaptcha --sitekey "KEY" --url "URL" ```

### Cloudflare Turnstile ```bash ./solve-captcha turnstile --sitekey "0x4AAA..." --url "URL" ```

### FunCaptcha (Arkose) ```bash ./solve-captcha funcaptcha --public-key "KEY" --url "URL" ```

### GeeTest ```bash # v3 ./solve-captcha geetest --gt "GT" --challenge "CHALLENGE" --url "URL"

# v4 ./solve-captcha geetest4 --captcha-id "ID" --url "URL" ```

### 文本问题 ```bash ./solve-captcha text "What color is the sky?" --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 令牌 ```javascript // 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

## 注意事项

- 解决时间根据类型需 10-60 秒不等 - reCAPTCHA v3 可能需要多次尝试以获得高分 - 某些网站会检测自动化 - 请谨慎使用 - 令牌会过期！请在 2-5 分钟内使用