技能详情（站内镜像，无评论）
许可证：MIT-0
MIT-0 ·免费使用、修改和重新分发。无需归因。
版本：v1.0.1
统计：⭐ 1 · 66 · 0 current installs · 0 all-time installs
⭐ 1
安装量（当前） 0
🛡 VirusTotal ：良性 · OpenClaw ：可疑
Package：capsolver/capsolver-captcha-solver
安全扫描（ClawHub）
- VirusTotal ：良性
- OpenClaw ：可疑
OpenClaw 评估
The skill is largely coherent with its stated purpose (it contacts api.capsolver.com and expects an API key), but there are inconsistencies between the declared registry metadata and the runtime instructions / code (notably the API_KEY requirement), so you should verify provenance and configuration before installing.
目的
The skill's name/description (captcha solving) matches the included code and runtime instructions: the script uses requests to call https://api.capsolver.com and implements many captcha task types. Requiring an API key and optional proxy parameters is expected for this functionality. However, the registry metadata earlier claimed 'Required env vars: none' while SKILL.md and scripts clearly require API_KEY — a manifest inconsistency.
说明范围
SKILL.md and the included scripts keep scope to creating captcha-solving tasks and polling results from the CapSolver API. The instructions tell the agent to run scripts/solver.py with task-specific args (images, websiteURL, proxy, etc.). The skill does not instruct the agent to read unrelated system files or other environment variables beyond API_KEY, nor to send data to unexpected endpoints (only api.capsolver.com).
安装机制
There is no download/install step in the manifest; the package contains a Python script and a requirements.txt (requests, python-dotenv). No external or obscure URLs are downloaded at install time. This is lower risk from an install-mechanism perspective.
证书
The runtime requires an API_KEY (and the code loads .env) which is proportionate to contacting the CapSolver service. But the registry metadata claims no required env vars while SKILL.md and the code require API_KEY — this mismatch is a red flag (manifest/instruction inconsistency). The tool also accepts sensitive values as command-line args (proxies, awsKey/awsIv/awsApiKey, awsExistingToken) which are plausible for certain captcha types but m…
持久
The skill does not request 'always: true' and is user-invocable; it can be invoked autonomously (default), which is normal for skills. Combined with network access and an external API key, autonomous invocation increases blast radius, but this is expected for a networked service and not by itself a disqualifying privilege.
安装（复制给龙虾 AI）
将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。
请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「CapSolver」。简介：Use capsolver to automatically resolve Geetest, reCAPTCHA v2, reCAPTCHA v3, MTC…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/capsolver/capsolver-captcha-solver/SKILL.md
（来源：yingzhi8.cn 技能库）SKILL.md
---
name: capsolver
description: Use capsolver to automatically resolve Geetest, reCAPTCHA v2, reCAPTCHA v3, MTCaptcha, DataDome, AWS WAF, Cloudflare Turnstile, and Cloudflare Challenge, etc.
homepage: https://capsolver.com/
credentials:
- API_KEY
env:
required:
- API_KEY
---
# CapSolver Skill
Use this skill to automatically resolve various CAPTCHA challenges using the CapSolver API service. The skill supports Geetest, reCAPTCHA v2/v3, MTCaptcha, DataDome, AWS WAF, Cloudflare Turnstile, Cloudflare Challenge, and more.
**Authentication:** Set `API_KEY` in your environment or in a `.env` file in the repo root.
**Errors:** If it fails, the script will exit with code 1.
---
# Solver
## Task(Recognition)
### ImageToTextTask
Solve text-based captcha.
**Command:**
```bash
python3 ./scripts/solver.py ImageToTextTask --body "base64_image_data"
python3 ./scripts/solver.py ImageToTextTask --body "base64_image_data" --module "module_001"
```
Optional:
- `--websiteURL`: Page source url to improve accuracy.
- `--body`: Base64 encoded content of the image (no newlines, no data:image/***;charset=utf-8;base64,).
- `--module`: Specify the module. All supported module references: https://docs.capsolver.com/en/guide/recognition/ImageToTextTask/#independent-module-support.
- `--images`: Only for `number` module, Support up to 9 base64 encoded images each time.
- `--max-retries`: Maximum number of retries (default: 60).
---
### ReCaptchaV2Classification
Classify reCAPTCHA v2 images.
**Command:**
```bash
python3 ./scripts/solver.py ReCaptchaV2Classification --question "question" --image "base64_image_data"
```
Optional:
- `--websiteURL`: Page source url to improve accuracy.
- `--websiteKey`: Website key to improve accuracy.
- `--question`: Please refer to: https://docs.capsolver.com/guide/recognition/ReCaptchaClassification/.
- `--image`: Base64 image string.
- `--max-retries`: Maximum number of retries (default: 60).
---
### AwsWafClassification
Classify AWS WAF images.
**Command:**
```bash
python3 ./scripts/solver.py AwsWafClassification --question "question" --images "base64_image_data1" "base64_image_data2" "base64_image_data3"
```
Too many images may exceed the command line length limit. You can try writing the base64 values of the images line by line to a file (such as aws_images.txt) and then using the xargs command to pass them to the --images parameter:
```bash
cat aws_images.txt | xargs python3 ./scripts/solver.py AwsWafClassification --question "question" --images
```
Optional:
- `--websiteURL`: Page source url to improve accuracy.
- `--question`: Please refer to: https://docs.capsolver.com/guide/recognition/AwsWafClassification/.
- `--images`: Base64 image string, `aws:grid` supports 9 images each time, other types support 1 image each time.
- `--max-retries`: Maximum number of retries (default: 60).
---
### VisionEngine
Advanced AI vision-based captcha solving.
**Command:**
```bash
python3 ./scripts/solver.py VisionEngine --module "module" --image "base64_image_data" --imageBackground "base64_image_background_data"
```
Optional:
- `--websiteURL`: Page source url to improve accuracy.
- `--module`: Please refer to: https://docs.capsolver.com/guide/recognition/VisionEngine/.
- `--question`: Only the `shein` model requires, please refer to: https://docs.capsolver.com/en/guide/recognition/VisionEngine/.
- `--image`: Base64 encoded content of the image (no newlines, no data:image/***;charset=utf-8;base64,).
- `--imageBackground`: Base64 encoded content of the background image (no newlines, no data:image/***;charset=utf-8;base64,).
- `--max-retries`: Maximum number of retries (default: 60).
---
## Task(Token)
### GeeTest
Solve GeeTest captcha (v3/v4).
**Command:**
```bash
python3 ./scripts/solver.py GeeTestTaskProxyLess --websiteURL "https://example.com/" --captchaId "captcha_id"
```
Optional:
- `--websiteURL`: Web address of the website using geetest (Ex: https://geetest.com).
- `--gt`: Only Geetest V3 is required.
- `--challenge`: Only Geetest V3 is required.
- `--captchaId`: Only Geetest V4 is required.
- `--geetestApiServerSubdomain`: Special api subdomain, example: api.geetest.com.
- `--max-retries`: Maximum number of retries (default: 60).
---
### reCAPTCHA v2
Solve Google reCAPTCHA v2 (checkbox/invisible).
**Command:**
```bash
python3 ./scripts/solver.py ReCaptchaV2TaskProxyLess --websiteURL "https://example.com" --websiteKey "site_key"
python3 ./scripts/solver.py ReCaptchaV2Task --websiteURL "https://example.com" --websiteKey "site_key" --proxy "host:port:username:password"
```
Optional:
- `--websiteURL`: The URL of the target webpage that loads the captcha, It’s best to submit the full URL instead of just the host.
- `--websiteKey`: Recaptcha website key.
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--pageAction`: For ReCaptcha v2, if there is an sa parameter in the payload of the /anchor endpoint, please submit its value.
- `--enterprisePayload`: For ReCaptchaV2 enterprise version, if there is an s parameter in the payload of the /anchor endpoint, please submit its value.
- `--isInvisible`: Pass true if there is no “I’m not a robot” checkbox but the challenge will still appear, usually required in v2 invisible mode.
- `--isSession`: Session mode, when enabled, will return a recaptcha-ca-t value, which is used as a cookie. It usually appears in v3. Note: Some websites require a recaptcha-ca-e value, which usually appears in v2. If this value is present, it will be automatically returned without any additional parameter settings.
- `--max-retries`: Maximum number of retries (default: 60).
---
### reCAPTCHA v3
Solve Google reCAPTCHA v3.
**Command:**
```bash
python3 ./scripts/solver.py ReCaptchaV3TaskProxyLess --websiteURL "https://example.com" --websiteKey "site_key"
python3 ./scripts/solver.py ReCaptchaV3Task --websiteURL "https://example.com" --websiteKey "site_key" --proxy "host:port:username:password"
```
Optional:
- `--websiteURL`: The URL of the target webpage that loads the captcha, It’s best to submit the full URL instead of just the host.
- `--websiteKey`: Recaptcha website key.
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--pageAction`: For ReCaptcha v3, You can find the value of the action parameter by searching for grecaptcha.execute.
- `--enterprisePayload`: For the enterprise version, search for grecaptcha.enterprise.render and pass the s parameter.
- `--isSession`: Session mode, when enabled, will return a `recaptcha-ca-t` value, which is used as a cookie. It usually appears in v3. Note: Some websites require a `recaptcha-ca-e` value, which usually appears in v2. If this value is present, it will be automatically returned without any additional parameter settings.
- `--max-retries`: Maximum number of retries (default: 60).
---
### MTCaptcha
Solve MTCaptcha.
**Command:**
```bash
python3 ./scripts/solver.py MtCaptchaTaskProxyLess --websiteURL "https://example.com" --websiteKey "site_key"
python3 ./scripts/solver.py MtCaptchaTask --websiteURL "https://example.com" --websiteKey "site_key" --proxy "host:port:username:password"
```
Optional:
- `--websiteURL`: Web address of the website using generally it’s fixed value. (Ex: https://google.com).
- `--websiteKey`: The domain public key, rarely updated. (Ex: sk=MTPublic-xxx public key).
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--max-retries`: Maximum number of retries (default: 60).
---
### DataDome
Solve DataDome.
**Command:**
```bash
python3 ./scripts/solver.py DatadomeSliderTask --captchaUrl "https://geo.captcha-delivery.com/xxxxxxxxx" --userAgent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36" --proxy "host:port:username:password"
```
Optional:
- `--captchaUrl`: If the url contains t=bv that means that your ip must be banned, t should be t=fe.
- `--userAgent`: It needs to be the same as the userAgent you use to request the website. Currently we only support the following userAgent.
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--max-retries`: Maximum number of retries (default: 60).
---
### AWS WAF
Solve AWS WAF.
**Command:**
```bash
python3 ./scripts/solver.py AntiAwsWafTask --websiteURL "https://example.com" --awsChallengeJS "https://path/to/challenge.js" --proxy "host:port:username:password"
python3 ./scripts/solver.py AntiAwsWafTaskProxyLess --websiteURL "https://example.com" --awsChallengeJS "https://path/to/challenge.js"
python3 ./scripts/solver.py AntiAwsWafTaskProxyLess --websiteURL "https://example.com"
```
Optional:
- `--websiteURL`: If the url contains t=bv that means that your ip must be banned, t should be t=fe.
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--awsKey`: The key value returned by the captcha page.
- `--awsIv`: The iv value returned by the captcha page.
- `--awsContext`: The context value returned by the captcha page.
- `--awsChallengeJS`: The challenge.js link returned by the captcha page.
- `--awsApiJs`: The jsapi.js link returned by the captcha page.
- `--awsProblemUrl`: The problem endpoint url containing keywords like problem, num_solutions_required, etc..
- `--awsApiKey`: The api_key value of the problem endpoint.
- `--awsExistingToken`: The aws-waf-token used for the last verification.
- `--max-retries`: Maximum number of retries (default: 60).
---
### Cloudflare Turnstile
Solve Cloudflare Turnstile.
**Command:**
```bash
python3 ./scripts/solver.py AntiTurnstileTaskProxyLess --websiteURL "https://example.com" --websiteKey "site_key"
```
Optional:
- `--websiteURL`: The address of the target page.
- `--websiteKey`: Turnstile website key.
- `--action`: The value of the data-action attribute of the Turnstile element if it exists.
- `--cdata`: The value of the data-cdata attribute of the Turnstile element if it exists.
- `--max-retries`: Maximum number of retries (default: 60).
---
### Cloudflare Challenge
Solve Cloudflare Challenge (5-second shield).
**Command:**
```bash
python3 ./scripts/solver.py AntiCloudflareTask --websiteURL "https://example.com" --proxy "host:port:username:password"
```
Optional:
- `--websiteURL`: The address of the target page.
- `--proxy`: Learn Using proxies: https://docs.capsolver.com/guide/api-how-to-use-proxy/.
- `--userAgent`: The user-agent you used to request the target website. Only Chrome’s userAgent is supported.
- `--html`: The response of requesting the target website, it usually contains "Just a moment…" and status code is 403. we need this html for some websites, please be sure to use your sticky proxy to dynamically scrape the HTML every time.
- `--max-retries`: Maximum number of retries (default: 60).
---
## Response example
**Output:** All commands return JSON objects with task-specific solution fields.
### ImageToTextTask
```json
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"status": "ready",
"solution": {
"text": "44795sds",
// number module:
"answers": ["100", "1330", "147", "248", "303", "439", "752", "752", "752"],
},
"taskId": "..."
}
```
### ReCaptchaV2Classification
multi objects:
```json
{
"errorId": 0,
"status": "ready",
"solution": {
"type": "multi",
"objects": [
0,
1,
2,
3
],
"size": 4,
// 3 or 4
},
"taskId": "cbb1c730-e569-4ba6-b5fc-e06377694aa7"
}
```
single object:
```json
{
"errorId": 0,
"status": "ready",
"solution": {
"type": "single",
"hasObject": true,
"size": 1,
},
"taskId": "cbb1c730-e569-4ba6-b5fc-e06377694aa7"
}
```
### AwsWafClassification
```json
{
"errorId": 0,
"status": "ready",
"solution": {
//carcity point
"box": [
116.7,
164.1
],
// grid type, objects means the image index that matches the question
"objects": [0, 1, 3, 4, 6],
//if question include `bifurcatedzoo`
"distance": 500
},
"taskId": "cbb1c730-e569-4ba6-b5fc-e06377694aa7"
}
```
### VisionEngine
```json
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"status": "ready",
"solution": {
"distance": 213,
},
"taskId": "cbb1c730-e569-4ba6-b5fc-e06377694aa7"
}
```
### GeeTest
Geetest v3:
```json
{
"errorId": 0,
"taskId": "e0ecaaa8-06f6-41fd-a02e-a0c79b957b15",
"status": "ready",
"solution": {
"challenge": "...",
"validate": "...",
"seccode": "...",
"userAgent": "..."
},
}
```
Geetest v4:
```json
{
"errorId": 0,
"taskId": "e0ecaaa8-06f6-41fd-a02e-a0c79b957b15",
"status": "ready",
"solution": {
"captcha_id": "",
"captcha_output": "",
"gen_time": "",
"lot_number": "",
"pass_token": "",
"risk_type": "slide"
}
}
```
### reCAPTCHA
reCAPTCHA v2/v3:
```json
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"userAgent": "xxx", // User-Agent
"secChUa": "xxx", // Sec-Ch-Ua
"createTime": 1671615324290, // The creation time of the token
"gRecaptchaResponse": "3AHJ......", // token
"recaptcha-ca-t": "AbEM......", // Some v3 websites have session mode. After enabling isSession, this parameter will be returned and used as a cookie.
"recaptcha-ca-e": "Abp_......" // Some v2 websites have this parameter, which is used as a cookie. If there is such a value, it will be automatically returned.
},
"status": "ready"
}
```
### MTCaptcha
```json
{
"errorId": 0,
"taskId": "646825ef-9547-4a29-9a05-50a6265f9d8a",
"status": "ready",
"solution": {
"token": ""
}
}
```
### DataDome
```json
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"cookie": "datadome=yzj_BK...S0; Max-Age=31536000; Domain=; Path=/; Secure; SameSite=Lax"
},
"status": "ready"
}
```
### AWS WAF
```json
{
"errorId": 0,
"taskId": "646825ef-9547-4a29-9a05-50a6265f9d8a",
"status": "ready",
"solution": {
"cookie": "223d1f60-0e9f-4238-ac0a-e766b15a778e:EQoAf0APpGIKAAAA:AJam3OWpff1VgKIJxH4lGMMHxPVQ0q0R3CNtgcMbR4VvnIBSpgt1Otbax4kuqrgkEp0nFKanO5oPtwt9+Butf7lt0JNe4rZQwZ5IrEnkXvyeZQPaCFshHOISAFLTX7AWHldEXFlZEg7DjIc="
}
}
```
### Cloudflare Turnstile
```json
{
"errorId": 0,
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006",
"status": "ready",
"errorCode": null,
"errorDescription": null,
"solution": {
"token": "0.mF74FV8wEufAWOdvOak_xFaVy3lqIDel7SwNhw3GgpICSWwTjYfrQB8mRT1dAJJBEoP7N1sESdp6WH9cTS1T0catWLecG3ayNcjwxVtr3hWfS-dmcBGRTx4xYwI64sAVboYGpIyuDBeMIRC3W8dK35v1nDism9xa595Da5VlXKM7hk7pIXg69lodfiftasIkyD_KUGkxBwxvrmz7dBo10-Y5zvro9hD4QKRjOx7DYj9sumnkyYCDx0m4ImDIIkNswfVTWI2V22wlnpHdvMgdtKYgOIIAU28y9gtdrdDkpkH0GHcDyd15sxQGd9VjwhGZA_mpusUKMsEoGgst2rJ3zA.UWfZupqLlGvlATkPo3wdaw.38d55cd0163610d8ce8c42fcff7b62d8981495cc1afacbb2f14e5a23682a4e13",
"type": "turnstile",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36"
}
}
```
### Cloudflare Challenge
```json
{
"errorId": 0,
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"status": "ready",
"errorCode": "",
"errorDescription": "",
"solution": {
"cookies": {
"cf_clearance": "Bcg6jNLzTVaa3IsFhtDI.e4_LX8p7q7zFYHF7wiHPo...uya1bbdfwBEi3tNNQpc"
},
"token": "Bcg6jNLzTVaa3IsFhtDI.e4_LX8p7q7zFYHF7wiHPo...uya1bbdfwBEi3tNNQpc",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
}
}
```