/install captcha-login-assistant
\r \r
CAPTCHA Login Assistant\r
\r
Overview\r
\r This skill automates the login process for web systems requiring CAPTCHA verification. It uses Chrome DevTools MCP to capture login page screenshots, employs AI vision to recognize CAPTCHA codes, automatically fills in account credentials and CAPTCHA, and completes the login operation.\r \r
Applicable Scenarios\r
\r
- Web system logins requiring CAPTCHA verification\r
- Login scenarios with short CAPTCHA validity periods\r
- Situations requiring rapid consecutive login operations\r \r
Core Workflow\r
\r
1. Preparation\r
\r Ensure the following tools are available:\r
- Chrome DevTools MCP service\r
- Target login page URL\r
- Valid account credentials (username and password)\r \r
2. Login Steps\r
\r
Step 1: Refresh Page to Get New CAPTCHA\r
// Navigate to login page and refresh\r
mcp_chrome-devtools-mcp_navigate_page({\r
"type": "reload"\r
})\r
```\r
\r
#### Step 2: Capture Login Page Screenshot\r
```javascript\r
// Capture current page viewport\r
mcp_chrome-devtools-mcp_take_screenshot({\r
"filePath": "path/to/login_screenshot.png"\r
})\r
```\r
\r
#### Step 3: Recognize CAPTCHA\r
- View the CAPTCHA image in the screenshot\r
- CAPTCHA is usually located to the right of the "Enter CAPTCHA" input field\r
- Carefully identify CAPTCHA characters (note case sensitivity)\r
\r
#### Step 4: Quickly Fill Form\r
```javascript\r
// Use JavaScript to fill all fields simultaneously\r
mcp_chrome-devtools-mcp_evaluate_script({\r
"function": "() => {\
const username = document.querySelector('input[name=\"username\"]');\
const password = document.querySelector('input[name=\"password\"]');\
const verifyCode = document.querySelector('input[name=\"verifyCode\"]');\
\
if (username) {\
username.value = 'your_username';\
username.dispatchEvent(new Event('input', { bubbles: true }));\
}\
if (password) {\
password.value = 'your_password';\
password.dispatchEvent(new Event('input', { bubbles: true }));\
}\
if (verifyCode) {\
verifyCode.value = 'recognized_captcha';\
verifyCode.dispatchEvent(new Event('input', { bubbles: true }));\
}\
return 'filled';\
}"\r
})\r
```\r
\r
#### Step 5: Click Login Button\r
```javascript\r
// Click login button\r
mcp_chrome-devtools-mcp_evaluate_script({\r
"function": "() => {\
const loginBtn = document.querySelector('button[type=\"submit\"]') || document.querySelector('button');\
if (loginBtn) {\
loginBtn.click();\
return 'login_clicked';\
}\
return 'button_not_found';\
}"\r
})\r
```\r
\r
#### Step 6: Verify Login Result\r
```javascript\r
// Wait for post-login page elements\r
mcp_chrome-devtools-mcp_wait_for({\r
"text": ["Home", "Dashboard", "System", "Logout"],\r
"timeout": 5000\r
})\r
```\r
\r
## Key Insights\r
\r
### CAPTCHA Recognition Tips\r
\r
1. **Clear Screenshot** - Ensure CAPTCHA image is clearly visible within screenshot bounds\r
2. **Time Sensitivity** - CAPTCHA typically has short validity (1-3 seconds), fill immediately after recognition\r
3. **Careful Identification** - Distinguish similar characters (e.g., 0 vs O, 1 vs l, 5 vs S)\r
4. **Case Sensitivity** - CAPTCHA is usually case-sensitive\r
\r
### Common Issues\r
\r
#### CAPTCHA Verification Failed\r
- **Cause**: CAPTCHA has expired\r
- **Solution**: Immediately recapture screenshot, recognize new CAPTCHA, and resubmit\r
\r
#### Page Element Not Found\r
- **Cause**: Page not fully loaded or element ID changed\r
- **Solution**: Get page snapshot first to confirm element existence\r
\r
#### Redirected Back to Login After Login\r
- **Cause**: Session expired or token invalid\r
- **Solution**: Re-execute complete login workflow\r
\r
## Best Practices\r
\r
1. **Parallel Processing** - Screenshot capture and form preparation can be done in parallel\r
2. **Quick Response** - Fill form immediately after CAPTCHA recognition to minimize expiration risk\r
3. **Use JavaScript** - Direct DOM manipulation is faster than fill tools\r
4. **Verify Results** - Check page content after login to confirm success\r
\r
## Examples\r
\r
### Example 1: Standard Login Workflow\r
\r
```\r
User: Help me login to this system http://example.com/login, username admin, password 123456\r
\r
Execution Steps:\r
1. Navigate to login page\r
2. Capture screenshot to get CAPTCHA\r
3. Recognize CAPTCHA as "Ab3d"\r
4. Use JavaScript to fill username, password, and CAPTCHA\r
5. Click login button\r
6. Verify successful login\r
```\r
\r
### Example 2: CAPTCHA Expiration Retry\r
\r
```\r
If login fails showing "CAPTCHA verification failed":\r
1. Immediately recapture screenshot\r
2. Recognize new CAPTCHA\r
3. Refill and submit\r
4. Retry multiple times if necessary\r
```\r
\r
## Important Notes\r
\r
1. **Security** - Do not log passwords in logs\r
2. **Privacy** - Handle screenshots containing sensitive information appropriately\r
3. **Rate Limiting** - Be aware of system login rate limits to avoid triggering security mechanisms\r
4. **CAPTCHA Complexity** - For complex CAPTCHAs (distorted, with interference lines), multiple attempts may be needed\r
\r
## Troubleshooting\r
\r
| Issue | Possible Cause | Solution |\r
|-------|---------------|----------|\r
| Empty CAPTCHA recognition | Screenshot doesn't include CAPTCHA | Adjust screenshot bounds |\r
| Login button not found | Page not fully loaded | Wait for page load before operation |\r
| Repeated verification failures | CAPTCHA expires too quickly | Manual login or contact administrator |\r
| Redirect to login after login | Session issue | Clear cookies and retry |\r
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install captcha-login-assistant - 安装完成后,直接呼叫该 Skill 的名称或使用
/captcha-login-assistant触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
captcha-login-assistant 是什么?
Assist with web login processes that require CAPTCHA verification. Uses Chrome DevTools MCP to capture screenshots, recognizes CAPTCHA codes using AI vision,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 286 次。
如何安装 captcha-login-assistant?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install captcha-login-assistant」即可一键安装,无需额外配置。
captcha-login-assistant 是免费的吗?
是的,captcha-login-assistant 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
captcha-login-assistant 支持哪些平台?
captcha-login-assistant 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 captcha-login-assistant?
由 leungBH(@leungbh)开发并维护,当前版本 v1.0.0。