How do I install the Captcha Relay skill?

Run npx skillmds@latest add dvcrn/captcha-relay in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Captcha Relay safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Captcha Relay?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Captcha Relay free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Captcha Relay?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Captcha Relay by dvcrn — Agent Skill

Name: Captcha Relay
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

Captcha Relay

Human-in-the-loop CAPTCHA solving with two modes: screenshot (default, zero infrastructure) and token relay (requires network access). Screenshot mode captures the page with a grid overlay, sends it to the human, and injects clicks based on their reply. Token relay mode detects CAPTCHA type + sitekey, serves the real widget on a relay page for native solving, and injects the token via CDP.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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.

node index.js                       # screenshot mode (default)
node index.js --mode screenshot     # explicit
node index.js --screenshot          # legacy alias

const { solveCaptchaScreenshot } = require('./index');
const capture = await solveCaptchaScreenshot({ cdpPort: 18800 });
// capture.imagePath — annotated screenshot to send to human
// capture.prompt — text prompt for the human

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.

node index.js --mode relay              # with localtunnel
node index.js --mode relay --no-tunnel  # with Tailscale/LAN

const { solveCaptcha } = require('./index');
const result = await solveCaptcha({ cdpPort: 18800, useTunnel: false });
// result.relayUrl — URL to send to human
// result.token — solved CAPTCHA token

When to Use Each

Scenario	Mode
Quick & easy, no setup	`screenshot`
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
`--mode screenshot\|relay`	`screenshot`	Select solving mode
`--screenshot`	—	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)

Call solveCaptchaScreenshot({ cdpPort })
Send capture.imagePath to human via message tool with capture.prompt
Human replies with cell numbers (e.g. "1,3,5,7")
Call injectGridClicks(cdpPort, capture, selectedCells) to click those cells

Relay mode

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

Requirements

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

---name: captcha-relaydescription: Human-in-the-loop CAPTCHA solving with two modes: screenshot (default, zero infrastructure) and token relay (requires network access). Screenshot mode captures the page with a grid overlay, sends it to the human, and injects clicks based on their reply. Token relay mode detects CAPTCHA type + sitekey, serves the real widget on a relay page for native solving, and injects the token via CDP.---# CAPTCHA Relay v2Solve CAPTCHAs by relaying them to a human. Two modes available.## Modes### Screenshot Mode (default) — No infrastructure neededGrid 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.```bashnode index.js # screenshot mode (default)node index.js --mode screenshot # explicitnode index.js --screenshot # legacy alias``````jsconst { solveCaptchaScreenshot } = require('./index');const capture = await solveCaptchaScreenshot({ cdpPort: 18800 });// capture.imagePath — annotated screenshot to send to human// capture.prompt — text prompt for the human```### Token Relay Mode — Requires network accessDetects 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.```bashnode index.js --mode relay # with localtunnelnode index.js --mode relay --no-tunnel # with Tailscale/LAN``````jsconst { solveCaptcha } = require('./index');const result = await solveCaptcha({ cdpPort: 18800, useTunnel: false });// result.relayUrl — URL to send to human// result.token — solved CAPTCHA token```## When to Use Each| Scenario | Mode ||----------|------|| Quick & easy, no setup | `screenshot` || 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 ||------|---------|-------------|| `--mode screenshot\|relay` | `screenshot` | Select solving mode || `--screenshot` | — | 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. Call `solveCaptchaScreenshot({ cdpPort })` 2. Send `capture.imagePath` to human via `message` tool with `capture.prompt`3. Human replies with cell numbers (e.g. "1,3,5,7")4. Call `injectGridClicks(cdpPort, capture, selectedCells)` to click those cells### Relay mode1. Call `solveCaptcha({ useTunnel: false })` (Tailscale) or `solveCaptcha()` (tunnel)2. Send `result.relayUrl` to human via `message` tool3. Wait — resolves when human completes the CAPTCHA4. Token is auto-injected; continue automation## Requirements- Chrome/Chromium with `--remote-debugging-port=18800`- Node.js 18+ and `npm install` (deps: ws, sharp)- **Relay mode only:** Tailscale or internet for tunnel

Frequently asked questions