CAPTCHA Relay v2

Solve CAPTCHAs by relaying them to a human. Two modes available.

Modes

Screenshot Mode (default) — No infrastructure needed

Grid overlay screenshot → send image to human via Telegram → human replies with cell numbers → inject clicks.

• - Zero setup beyond the skill itself. No Tailscale, no tunnels, no relay server.
• Works for any CAPTCHA type (reCAPTCHA, hCaptcha, sliders, text, etc.)
• Uses sharp for image processing + CDP for screenshots and click injection.

CODEBLOCK0

CODEBLOCK1

Token Relay Mode — Requires network access

Detects CAPTCHA type + sitekey → serves real widget on relay page → human solves natively → token injected via CDP.

• - Requires Tailscale or a tunnel (localtunnel/cloudflared) so the human's device can reach the relay server.
• Produces a proper CAPTCHA token — more reliable for reCAPTCHA v2, hCaptcha, Turnstile.
• Best when you have Tailscale already set up.

CODEBLOCK2

CODEBLOCK3

When to Use Each

Scenario	Mode
Quick & easy, no setup	INLINECODE1
Any CAPTCHA type (sliders, text, etc.)

screenshot | | Known CAPTCHA with sitekey (reCAPTCHA, hCaptcha, Turnstile) | relay | | Tailscale already configured | relay | | No network access to host | screenshot |

CLI Flags

Flag	Default	Description
INLINECODE6	INLINECODE7	Select solving mode
INLINECODE8

— | Alias for --mode screenshot | | --no-inject | inject | Return token without injecting into browser | | --no-tunnel | tunnel | Skip tunnel, use local/Tailscale IP (relay mode) | | --timeout N | 120 | Timeout in seconds | | --cdp-port N | 18800 | Chrome DevTools Protocol port |

Agent Workflow

Screenshot mode (simplest)

1. 1. Call INLINECODE14
2. Send capture.imagePath to human via message tool with INLINECODE17
3. Human replies with cell numbers (e.g. "1,3,5,7")
4. Call injectGridClicks(cdpPort, capture, selectedCells) to click those cells

Relay mode

1. 1. Call solveCaptcha({ useTunnel: false }) (Tailscale) or solveCaptcha() (tunnel)
2. Send result.relayUrl to human via message tool
3. Wait — resolves when human completes the CAPTCHA
4. Token is auto-injected; continue automation

Requirements

• - Chrome/Chromium with INLINECODE23
• Node.js 18+ and npm install (deps: ws, sharp)
• Relay mode only: Tailscale or internet for tunnel