Solve hCaptcha in your stack.
Practical, copy-pasteable guides for getting a real hCaptcha token back into your pipeline. Read the sitekey, call the API, inject the token, then continue.
- Python hCaptcha solver:
pip install nonecap, with sync, asyncio, and plain-requests examples. - Solve hCaptcha in Selenium: the Python flow, token injection included.
- hCaptcha solving for web scraping: the full pipeline with a Python example.
- Solve hCaptcha in Playwright: Python & Node, with token injection included.
- Solve hCaptcha in Puppeteer: the Node.js flow, token injection included.
- hCaptcha solving for AI agents: call the solver as a tool inside an agent loop.
Every guide follows the same four steps
- Read the sitekey from the page (each guide shows the one-liner for its framework; the sitekey explainer covers the manual ways).
- Request a token with
POST /v1/solves, passing the sitekey and page URL. Block with?wait=Nor poll. - Inject the token into the form's hidden
h-captcha-responsefield and fire the widget callback if the site uses one. - Submit and move on. Tokens are single-use and expire in about two minutes, so guides mint them right before submission.
Picking a starting point
If you drive a browser, go straight to the
Selenium,
Playwright, or
Puppeteer guide for your stack. If you
make plain HTTP requests, the
web scraping guide covers detecting
the widget and submitting the token without a browser at all. The
Python guide is the shortest path if you
just want pip install nonecap and a working call, and the
AI agents guide wraps the same flow in
a tool schema your agent can call on demand.
Every guide targets hCaptcha (regular, invisible, and enterprise
rqdata). For the full endpoint and object reference, see the
API reference; for what a token actually is
and why injection works, the hCaptcha explainers
cover the mechanics.