/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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install captcha-login-assistant - After installation, invoke the skill by name or use
/captcha-login-assistant - Provide required inputs per the skill's parameter spec and get structured output
What is 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,... It is an AI Agent Skill for Claude Code / OpenClaw, with 286 downloads so far.
How do I install captcha-login-assistant?
Run "/install captcha-login-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is captcha-login-assistant free?
Yes, captcha-login-assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does captcha-login-assistant support?
captcha-login-assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created captcha-login-assistant?
It is built and maintained by leungBH (@leungbh); the current version is v1.0.0.