Repository navigation
Feature Request 🚀 — Optional 10Captcha Integration for CAPTCHA Solving #41
Description
Hi @hyperbrowserai team,
Thank you for the great work on HyperAgent — it's an impressive project for AI-powered browser automation.
I’d like to suggest adding optional support for 10Captcha, a simple and affordable CAPTCHA-solving API. Many users working with browser automation face CAPTCHA challenges, and having a built-in option to solve them would make HyperAgent even more reliable and user-friendly for real-world automation tasks.
The API is easy to integrate and well-documented: https://10captcha.com/api-docs.php
I believe this would be a valuable addition for users dealing with protected websites.
Thanks for considering this!
Activity
Shraman123 commentedon Aug 26, 2026
I put together an implementation of this (10Captcha integration) as a
solveCaptchaagent action:Branch: https://github.com/Shraman123/HyperAgent/tree/feature/10captcha-integration
Diff: main...Shraman123:HyperAgent:feature/10captcha-integration
Summary:
src/agent/captcha/ten-captcha-client.ts— client for 10Captcha'sin.php/res.phpsubmit-and-poll API (image CAPTCHAs + reCAPTCHA v2), with per-type timeouts and defensive response parsing.src/agent/actions/solve-captcha.ts— thesolveCaptchaaction: screenshots + solves + optionally fills image CAPTCHAs, or solves + injects the token for reCAPTCHA v2.DEFAULT_ACTIONSonly whenTENCAPTCHA_API_KEYis set (same pattern asGEMINI_API_KEY→PDFActionDefinition), so it's fully opt-in with zero behavior change otherwise.tsc,eslint, andyarn build(run directly viatsc/tsc-alias) all pass clean on this branch. I also exercised the client against a mockedfetchcovering the happy path,CAPCHA_NOT_READYpolling, submission/poll errors, timeouts, and reCAPTCHA v2 request params.I can't open a PR directly — looks like this repo restricts PR creation to collaborators (same thing @RagavRida ran into on #90). Happy to have a maintainer open the PR from the branch above, or add me as a collaborator so I can open it myself. Let me know if you'd like anything changed first.