2Captcha 验证码求解

要解决什么问题

浏览器自动化、爬虫或 AI Agent 在登录、提交表单、抓取受保护页面时，常会撞上 图片验证码、reCAPTCHA v2/v3、hCaptcha、Cloudflare Turnstile、FunCaptcha、GeeTest 或文本问答。这些挑战无法靠简单 HTTP 重放绕过，需要在页面里注入有效 token，且 token 往往只有几分钟有效期。

技能如何工作

本技能封装 2Captcha 人工打码 API，通过 CLI 把验证码任务（图片、页面 URL、sitekey、challenge 等元数据）提交给 2Captcha，等待人工或配套流程返回结果，再在自动化脚本里写回响应字段（例如 g-recaptcha-response 或站点回调）。

典型浏览器自动化流程可以概括为：

1. 检测页面上是否存在验证码组件
2. 提取参数：从 HTML 的 data-sitekey、iframe URL 的 k=、或网络请求里定位 reCAPTCHA / hCaptcha / Turnstile 的 sitekey
3. 调用求解：按类型传入对应参数执行 solve
4. 注入 token：把返回结果写入表单或触发站点回调

支持的类型在 SKILL 速查里覆盖图片、reCAPTCHA v2/v3、hCaptcha、Turnstile、FunCaptcha、GeeTest 与文本题。求解耗时通常 10～60 秒；按量计费，图片约 $0.001/次，常见交互式验证码约 $0.003/次，大批量前应先查余额。

边界与注意点

• 仅用于已获授权的自动化；会向 2Captcha 及其打码方发送验证码图片、URL、sitekey 等，不要提交敏感、受监管或未经同意的用户数据。
• API Key 通过 --api-key、TWOCAPTCHA_API_KEY 或 ~/.config/2captcha/api-key 等途径配置。
• 常见错误：ERROR_ZERO_BALANCE 需充值；ERROR_NO_SLOT_AVAILABLE 可稍后重试；ERROR_CAPTCHA_UNSOLVABLE 多为图片或任务无效；ERROR_WRONG_CAPTCHA_ID 表示任务 ID 错误。
• reCAPTCHA v3 高分场景可能需要多次尝试；部分站点会检测自动化行为；token 须在约 2～5 分钟内使用。

上游实现与反馈见 2captcha-cli。