JavaScript captcha solver for bypassing captchas in browser automation, extensions, and scraping scripts. JavaScript package for seamless integration with the solvecaptcha API, enabling automated captcha solving for reCAPTCHA, Cloudflare Turnstile, FunCaptcha, GeeTest, and other captcha types.
Repo solvercaptcha/solvecaptcha-javascript, read from GitHub 1 min ago. solvercaptcha has not joined Take My Repo.
solvercaptcha/solvecaptcha-javascript is a public repo on GitHub by solvercaptcha. JavaScript captcha solver for bypassing captchas in browser automation, extensions, and scraping scripts. JavaScript package for seamless integration with the solvecaptcha API, enabling automated captcha solving for reCAPTCHA, Cloudflare Turnstile, FunCaptcha, GeeTest, and other captcha types. It declares the MIT license on GitHub. It is written mainly in TypeScript, has 60 stars and last changed on 2025-09-23. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-19.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Use the JavaScript captcha solver to automatically bypass any captcha - including reCAPTCHA v2, Invisible, v3, Enterprise, Cloudflare Turnstile, GeeTest sliders, Amazon WAF, FunCaptcha, and both image and text-based challenges.
To get started quickly, check out the Captcha Solver API documentation.
Need help integrating with your Node.js app or JS automation tools? Open an issue or fork this repo to contribute.
You can install this package using NPM:
npm install solvecaptcha-javascript
or Yarn:
yarn add solvecaptcha-javascript
To install directly from GitHub:
npm install github:solvercaptcha/solvecaptcha-javascript
You can create a SolveCaptcha instance as follows:
const SolveCaptcha = require("solvecaptcha-javascript") const solver = new SolveCaptcha.Solver("<Your solvecaptcha api key>")
Additionally, several configuration options are available:
const apiKey = 'YOUR_API_KEY' const pollingInterval = 10 const solver = new SolveCaptcha.Solver(apiKey, pollingInterval)
| Option | Default value | Description |
|---|---|---|
| apiKey | - | Your personal API key |
| pollingInterval | 5000 | The delay in milliseconds between each request to the res.php API endpoint. It's not recommended to set this value below 5000 milliseconds (5 seconds). |
When submitting an image-based captcha, you can include extra parameters to assist Solvecaptcha workers in solving it accurately.
| Option | Default Value | Description |
|---|---|---|
| numeric | 0 | Indicates whether the captcha includes only numbers, letters, or a mix see more info in the API docs |
| min_len | 0 | Minimum number of characters expected in the answer |
| max_len | 0 | Maximum number of characters allowed in the answer |
| phrase | 0 | Specifies whether the answer should consist of multiple words |
| regsense | 0 | Indicates if case sensitivity should be considered in the answer |
| calc | 0 | Specifies whether the captcha involves a mathematical expression to solve |
| lang | - | Sets the language of the captcha; refer to the list of supported languages |
| textinstructions | - | A hint or instruction shown to the workers along with the captcha image |
Below are simple examples for each captcha type — take a look at the code samples provided.
Description of the API method.
To solve a standard captcha (distorted text within an image), use the method below. It can also be applied for general text recognition in images.
const imageBase64 = fs.readFileSync("./examples/media/imageCaptcha_6e584.png", "base64") solver.imageCaptcha({ body: imageBase64, numeric: 4, min_len: 5, max_len: 5 }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve reCAPTCHA V2 and retrieve a token that allows you to bypass the verification.
solver.recaptcha({ pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2', googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
This method is used to solve reCAPTCHA V3 and returns a token for verification.
solver.recaptcha({ pageurl: 'https://solvecaptcha.com/demo/recaptcha-v3', googlekey: '6Lcyqq8oAAAAAJE7eVJ3aZp_hnJcI6LgGdYD8lge', version: "v3", min_score: "0.4", action: 'demo_action' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Method for solving FunCaptcha (Arkoselabs). Returns a verification token.
solver.funCaptcha({ pageurl: "https://funcaptcha.com/tile-game-lite-mode/fc/api/nojs/?pkey=804380F4-6844-FFA1-ED4E-5877CA1F1EA4&lang=en", publickey: "804380F4-6844-FFA1-ED4E-5877CA1F1EA4" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Method for solving GeeTest puzzle captcha. Returns a JSON object containing the required tokens.
// Read more about `challenge` on the page https://solvecaptcha.com/p/geetest solver.geetest({ pageurl: 'https://solvecaptcha.com/demo/geetest', gt: '81388ea1fc187e0c335c0a8907ff2625', challenge: '<you need to get a new challenge value each time>' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve GeeTest v4 captcha. The response is returned in JSON format.
solver.geetestV4({ pageurl: 'https://solvecaptcha.com/demo/geetest-v4', captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Use this method to solve Yandex Smart Captcha and receive a token that allows you to bypass the verification.
solver.yandexSmart({ pageurl: "https://captcha-api.yandex.ru/demo", sitekey: "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Lemin captcha and obtain a token to bypass the verification process..
solver.lemin({ pageurl:'https://solvecaptcha.com/demo/lemin', captcha_id: 'CROPPED_3dfdd5c_d1872b526b794d83ba3b365eb15a200b', div_id: 'lemin-cropped-captcha', api_server: 'api.leminnow.com' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Cloudflare Turnstile captcha. Returns a JSON response containing the token.
Turnstile captcha comes in two variants, one of which is the Cloudflare Turnstile Challenge page. For handling this type, we offer a demo. Check out this demo if you need to solve captchas on the Cloudflare Turnstile Challenge page.
solver.cloudflareTurnstile({ pageurl: "https://app.nodecraft.com/login", sitekey: "0x4AAAAAAAAkg0s3VIOD10y4" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Amazon WAF Captcha, also known as AWS WAF Captcha, which is part of Amazon AWS's intelligent threat mitigation system. Returns a JSON response containing the token.
//INFO: The `context` parameter is dynamic and must be retrieved from the page in real time for each request. solver.amazonWaf({ pageurl: "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest", sitekey: "AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AHMDLodoefdvyOnsHMRt...", context: "9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ...", iv: "CgAHbCe2GgAAAAAj", }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Token-based method for bypassing Capy puzzle captcha verification.
solver.capyPuzzle({ pageurl: "https://www.capy.me/account/register/", captchakey: "PUZZLE_Cme4hZLjuZRMYC3uh14C52D3uNms5w" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve DataDome captcha and get a token to bypass the protection.
Important
A proxy is required to solve the DataDome captcha. It is recommended to use residential proxies.
solver.dataDome({ pageurl: "https://rendezvousparis.hermes.com/client/register", captcha_url: "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMAEuQtkf4k1c0ABZhYZA%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=mY4z7GNmh7Nt1lAFwpbNHAOcWPhyPgjHD2K1Pm~Od1iEKYLUnK3t7N2ZGUj8OqDK65cnwJHtHwd~t902vlwpSBA5l4ZHbS1Qszv~jEuEUJNQ_jMAjar2Kj3kq20MRJYh&t=fe&referer=https%3A%2F%2Frendezvousparis.hermes.com%2Fclient%2Fregister&s=40119&e=67fef144ac1a54dbd7507776367d2f9d5e36ec3add17fa22f3cb881db8385838", userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36", proxy: "login:password@1.2.3.4:8888", // The (Username : Password @ Address : Port) of our chosen proxy proxytype: "http" // The 'Type' of proxy, http, https, socks, ect. }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve CyberSiARA captcha and receive a token to bypass the verification.
solver.cyberSiARA({ pageurl: "https://www.cybersiara.com/book-a-demo", master_url_id: "OXR2LVNvCuXykkZbB8KZIfh162sNT8S2", userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve MTCaptcha and get a token that allows you to bypass the verification.
solver.mtCaptcha({ pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html", sitekey: "MTPublic-DemoKey9M" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Friendly Captcha and retrieve a token to bypass the verification process.
Important
For the token to work correctly, the captcha widget must not be loaded on the page. You need to block the request to /friendlycaptcha/...module.min.js. If the widget has already been loaded, there is a high chance the obtained token will be invalid.
solver.friendlyCaptcha({ pageurl: "https://geizhals.de/?liftban=1&from=/455973138?fsean=5901747021356", sitekey: "FCMST5VUMCBOCGQ9" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
The ClickCaptcha method returns coordinates of specific points on the captcha image. It's useful when the task requires clicking on certain areas within the image.
const imageBase64 = fs.readFileSync("./tests/media/coordinates.jpg", "base64") solver.coordinates({ body: imageBase64, textinstructions: 'Select all photos containing the boat' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use the Bounding Box Method when you need to highlight specific objects in an image. To do this, provide both the image and the corresponding instructions for markup. Instructions can be submitted either as plain text or as a base64-encoded image.
Important
You must include either the imginstructions or textinstructions parameter.
solver.boundingBox({ image: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...", textinstructions: "Circle all the cars in the image.", }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
This method is suitable for solving captchas where the image can be split into equal-sized segments, such as reCAPTCHA V2. A grid is overlaid on the image, and the response contains the numbers of the selected boxes.
Important
You must include either the imginstructions or textinstructions parameter.
solver.grid({ body: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...", textinstructions: "Select cars in the image" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
This method is used to bypass captchas that present a question in plain text and require a text-based answer.
solver.textCaptcha({ textcaptcha: "If tomorrow is Saturday, what day is today?", lang: 'en' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
The canvas method is used when you need to outline an object on an image by drawing a line around it. It returns a set of coordinates for points that form a polygon.
solver.canvas({ body: 'iVBORw0KGgoAAAANSgAAAcIA...', imginstructions: '/9j/4AAQSkZJRgABAQEA...', textinstructions: 'Highlight the red CIRCLE' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
This method is intended for solving captchas that require rotating an object, commonly used in FunCaptcha. It returns the angle of rotation needed.
solver.rotate({ body: imageBase64, textinstructions: "Rotate the object to the correct position" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Token-based method for solving KeyCaptcha challenges.
solver.keyCaptcha({ pageurl: "https://solvecaptcha.com/demo/keycaptcha", userId: '184015', sessionId: '0917788cad24ad3a69813c4fcd556061', webServerSign: '02f7f9669f1269595c4c69bcd4a3c52e', webServerSign2: 'd888700f6f324ec0f32b44c32c50bde1' }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Cutcaptcha. The response is returned in JSON format.
solver.cutCaptcha({ pageurl: "https://mysite.com/page/with/cutcaptcha", misery_key: "098e6a849af406142e3150dbf4e6d0538db2b51f", api_key: "SAs61IAI", }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve Tencent captcha. The response is provided in JSON format.
solver.tencent({ pageurl: "https://mysite.com/page/with/tencent", appId: "189956587" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to solve the atbCAPTCHA challenge. It returns a token that allows you to bypass the captcha verification.
solver.atbCaptcha({ pageurl: "https://mysite.com/page/with/atbCAPTCHA", appId: "af25e409b33d722a95e56a230ff8771c", apiServer: "https://cap.aisecurius.com" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use the method below to bypass an audio captcha (only mp3 format is supported). You must specify the language using lang = 'en'. Supported languages include: "en", "ru", "de", "el", "pt", and "fr".
solver.audio({ body: "SUQzBAAAAAAAHFRTU0UAAAA...", lang: "en" }) .then((res) => { console.log(res); }) .catch((err) => { console.log(err); })
Description of the API method.
Use this method to report a correct captcha solution.
solver.goodReport('7031846604')
Description of the API method.
Use this method to report an incorrect captcha solution.
solver.badReport('7031854546')
Description of the API method.
Use this method to check the balance of your account.
solver.balance() .then((res) => { console.log(res) })
You can include your proxy as an additional parameter when using methods like: recaptcha, funcaptcha, geetest, geetest v4, keycaptcha, capy puzzle, lemin, turnstile, amazon waf, DataDome, CyberSiARA, MTCaptcha, Friendly Captcha, and others. The proxy will be passed to the API to assist in solving the captcha.
Example: Solving reCAPTCHA V2 with a proxy:
solver.recaptcha({ pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2', googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u', proxy: 'HTTPS', proxytype: 'login:password@123.123.123.123:3128' })
Examples for solving all supported captcha types can be found in the examples directory.
There are plenty of ways to get involved — development is just one of them! Discover your next opportunity. We're hiring AI specialists, scrapers, developers, tech support, and more! 😍
This repository’s code is distributed under the MIT License. For more information, see the LICENSE file.
Graphics and trademarks included in this repository are not licensed under the MIT License. For permission to use these assets, please contact our support team.
solvercaptcha/solvecaptcha-javascript is a public repo on GitHub by solvercaptcha. JavaScript captcha solver for bypassing captchas in browser automation, extensions, and scraping scripts. JavaScript package for seamless integration with the solvecaptcha API, enabling automated captcha solving for reCAPTCHA, Cloudflare Turnstile, FunCaptcha, GeeTest, and other captcha types.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2025-09-23. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/solvercaptcha/solvecaptcha-javascriptTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.