auto-captcha-solverlisted
Install: claude install-skill interfluve-wav/auto-captcha-solver
# Auto-Captcha
Auto-detect and solve captchas during Playwright browser automation using the NopeCHA API.
## When to Use
- Browser automation hits a captcha wall
- Web scraping tasks need captcha bypass
- Automated testing against captcha-protected sites
- Any Playwright script that might encounter hCaptcha or reCAPTCHA v2
## Prerequisites
- `NOPECHA_API_KEY` env var set (get free credits at https://nopecha.com)
- Python `requests` and `playwright` installed
- Playwright browser installed (`python -m playwright install chromium`)
## Quick Start
```python
from auto_captcha_solver import CaptchaSolver
solver = CaptchaSolver(api_key="your-key")
# Auto-detect + solve + inject (one-liner)
results = solver.auto_solve(page)
```
## Full API
### Detect
```python
captchas = solver.detect(page)
# Returns: [{"type": "hcaptcha"|"recaptcha2", "sitekey": "...", "url": "...", "frame": ...}]
```
### Solve
```python
result = solver.solve("hcaptcha", sitekey, page_url)
# Returns: CaptchaResult(success=True, token="...", attempts=5, elapsed_sec=38.0)
```
### Inject
```python
solver.inject(page, "hcaptcha", token)
# Injects token into page's captcha callback
```
### Auto (detect + solve + inject)
```python
results = solver.auto_solve(page)
for r in results:
print(f"{r.captcha_type}: {'OK' if r.success else r.error}")
```
## SmartPage (transparent wrapper)
```python
from auto_captcha_solver import smart_page
with smart_page(api_key="your-key") as page:
page.goto("https://p