2Captcha_AI Agent skill-PHP中文网

2Captcha

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用 2Captcha 在命令行解决浏览器自动化中的 CAPTCHA。

2Captcha Skill.

功能概述

2Captcha Skill.是一项面向实际任务的技能，主要用于Polyfe CAPTCHAs 方案使用 2Captcha 人力服务. 来源和反馈: https://github.com/adinvadim/2captcha-cli.；Privacy and labor use. .。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

2Captcha 技能

使用 2Captcha 人工驱动服务以编程方式求解 CAPTCHA。

源码与反馈：https://github.com/adinvadim/2captcha-cli

隐私与授权使用

该技能会将 CAPTCHA 图像、页面 URL、sitekey、挑战 ID 及任务元数据发送至 2Captcha，由其服务及人工解答者进行处理。请仅将其用于已获授权的自动化场景；除非获得明确批准，否则不得提交敏感信息、受监管数据、内部数据或第三方用户数据。

安装

# 使用 skills.sh 安装此 agent 技能
npx skills add adinvadim/2captcha-cli

# 或使用 ClawHub/OpenClaw 安装
openclaw skills install 2captcha

# 审阅源码后安装 CLI
git clone https://github.com/adinvadim/2captcha-cli.git
cd 2captcha-cli
python3 solve-captcha --version
mkdir -p ~/.local/bin
ln -sf "$PWD/solve-captcha" ~/.local/bin/solve-captcha

# 验证安装
solve-captcha --version

配置

# 保存您的 2Captcha API 密钥
mkdir -p ~/.config/2captcha
echo "YOUR_API_KEY" > ~/.config/2captcha/api-key

# 或使用环境变量
export TWOCAPTCHA_API_KEY="your-key"

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

CLI 仅从以下任一位置读取凭据：--api-key 参数、TWOCAPTCHA_API_KEY 环境变量、~/.config/2captcha/api-key 文件或 ~/.2captcha-api-key 文件。

快速参考

首先检查余额

solve-captcha balance

图像型 CAPTCHA

# 从本地文件读取
solve-captcha image /path/to/captcha.png

# 从 URL 加载
solve-captcha image "https://site.com/captcha.jpg"

# 指定选项
solve-captcha image captcha.png --numeric 1 --math
solve-captcha image captcha.png --comment "仅输入红色字母"

reCAPTCHA v2

solve-captcha recaptcha2 --sitekey "6Le-wvk..." --url "https://example.com"

reCAPTCHA v3

solve-captcha recaptcha3 --sitekey "KEY" --url "URL" --action "submit" --min-score 0.7

hCaptcha

solve-captcha hcaptcha --sitekey "KEY" --url "URL"

Cloudflare Turnstile

solve-captcha turnstile --sitekey "0x4AAA..." --url "URL"

FunCaptcha（Arkose）

solve-captcha funcaptcha --public-key "KEY" --url "URL"

GeeTest

# v3
solve-captcha geetest --gt "GT" --challenge "CHALLENGE" --url "URL"

# v4
solve-captcha geetest4 --captcha-id "ID" --url "URL"

文本问答型 CAPTCHA

solve-captcha text "天空是什么颜色？" --lang en

CAPTCHA 参数获取方法

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 类名的元素

浏览器自动化工作流

检测 CAPTCHA —— 检查页面是否包含 CAPTCHA 元素
提取参数 —— 从页面源码中获取 sitekey / challenge
调用 CLI 求解 —— 使用参数执行 solve-captcha
注入 token —— 设置 g-recaptcha-response 字段值或调用对应回调函数

示例：注入 reCAPTCHA token

// 在通过 solve-captcha 获取 token 后
document.getElementById('g-recaptcha-response').value = token;
// 若已定义回调函数，则调用之
___grecaptcha_cfg.clients[0].callback(token);