2captcha

# 2Captcha Skill

Solve CAPTCHAs programmatically using the 2Captcha human-powered service.

## Installation

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

## Configuration

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

Get your API key at https://2captcha.com/enterpage

## Quick Reference

### Check Balance First
```bash
./solve-captcha balance
```

### Image CAPTCHA
```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"
```

### Text Question
```bash
./solve-captcha text "What color is the sky?" --lang en
```

## Finding CAPTCHA Parameters

### reCAPTCHA sitekey
Look for:
- `data-sitekey` attribute in HTML
- `k=` parameter in reCAPTCHA iframe URL
- Network request to `google.com/recaptcha/api2/anchor`

### hCaptcha sitekey
Look for:
- `data-sitekey` in hCaptcha div
- Network requests to `h...

# solve-captcha

Solve CAPTCHAs from the command line using [2Captcha](https://2captcha.com) human-powered service.

## Features

- **10 captcha types** — Image, reCAPTCHA v2/v3, hCaptcha, Turnstile, FunCaptcha, GeeTest, Amazon WAF
- **Zero dependencies** — Pure Python 3 stdlib
- **Human-first design** — Clear output, helpful errors, progress indicators
- **Script-friendly** — `--json` output, proper exit codes, `--quiet` mode
- **Flexible config** — Flag > env > config file precedence

## Installation

```bash
# Quick install (one line)
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

# Or with Homebrew (coming soon)
# brew install adinvadim/tap/solve-captcha

# Or clone manually
git clone https://github.com/adinvadim/2captcha-cli.git
cd 2captcha-cli
chmod +x solve-captcha
sudo ln -s $(pwd)/solve-captcha /usr/local/bin/
```

## Configuration

API key lookup order:
1. `--api-key` / `-k` flag
2. `TWOCAPTCHA_API_KEY` environment variable  
3. `~/.config/2captcha/api-key` file

```bash
# Option 1: Environment
export TWOCAPTCHA_API_KEY="your-key"

# Option 2: Config file
mkdir -p ~/.config/2captcha
echo "your-key" > ~/.config/2captcha/api-key
```

## Usage

### Quick examples

```bash
# Image captcha
solve-captcha image captcha.png
solve-captcha image https://example.com/captcha.jpg --math

# reCAPTCHA v2
solve-captcha recaptcha2 -s 6Le-wvkSAAAA... -u https://example.com

# hCaptcha
solve-captcha hcaptcha -s a5f74b19-9e45... -u https://example.com

# Cloudflare Turnstile
solve-captcha turnstile -s 0x4AAA... -u https://example.com

# Check balance
solve-captcha balance
```

### Commands

| Command | Description |
|---------|-------------|
| `image <file\|url>` | Solve image captcha (OCR) |
| `recaptcha2` | Solve reCAPTCHA v2 |
| `recaptcha3` | Solve reCAPTCHA v3 |
| `hcaptcha` | Solve hCaptcha |
| `turnstile` | Solve Cloudflare Turnstile |
| `funcaptcha` |...