Skip to content

About

CapMonster Cloud Node.js SDK — TypeScript captcha solver & captcha bypass for reCAPTCHA v2/v3, Cloudflare Turnstile, DataDome & GeeTest. A 2captcha and capsolver alternative for Node.js web scraping and automation.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Latest commit

 

History

177 Commits

Folders and files

Repository files navigation

CapMonster Cloud Node.js SDK: TypeScript Captcha Solver & Captcha Bypass for reCAPTCHA, Cloudflare Turnstile and GeeTest

🔄 Migrating from 2Captcha or Capsolver? CapMonster Cloud is a fast, cost-effective 2captcha alternative and capsolver alternative for Node.js and TypeScript: reCAPTCHA v3 from $0.90 per 1,000 solves, which is up to 38% cheaper than 2Captcha and 10% cheaper than Capsolver, with an API response time of ≤ 2 s. Already have software built for 2Captcha? CapMonster Cloud supports the 2Captcha API format. Moving your Node.js code takes just a few lines: see the Migration examples below. Full comparison and disclaimer are in the comparison section below.

CapMonster Cloud Node.js SDK - captcha solver and captcha bypass API client

Official Node.js and TypeScript SDK for automated CAPTCHA solving in web scraping, browser automation, and testing workflows.

npm version npm downloads GitHub Stars GitHub Forks License: MIT


Official JavaScript and TypeScript client library for CapMonster Cloud. Add automated CAPTCHA-solving tasks to Node.js, TypeScript, Puppeteer, Playwright, Cypress, and HTTP-based workflows. As the official CapMonster SDK for Node.js, it is a cost-effective 2captcha alternative and capsolver alternative.

Use the SDK for captcha bypass with supported CAPTCHA and anti-bot task types, including reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, GeeTest, DataDome, Amazon WAF, Imperva, and image-to-text tasks.

👉 Get your Free API Key & Free Trial Balance on CapMonster Cloud


⚡ Highlights

  • ⚡ Fast solving: AI-based recognition, on average between 1 and 30 seconds depending on the captcha type.
  • 🤖 Zero human workers: 100% automated machine learning pipeline with no manual latencies.
  • 🛡️ Modern anti-bot bypass: Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, DataDome, Amazon WAF and Imperva.
  • ⚡ Node.js & TypeScript: Typed request models for supported task types.
  • 🌐 Automation-ready: Use with Playwright, Puppeteer, Cypress, scraping tools, and custom HTTP clients.
  • 🛠️ Dedicated or custom payloads: Use request classes or CommonCaptcha to submit a full task payload.
  • 💰 Cost-effective: Low-cost pricing structure based on pay-as-you-go balance.
  • 📉 Cheaper than alternatives: reCAPTCHA v3 from $0.90 per 1,000 solves, versus $1.45 at 2Captcha and $1.00 at Capsolver.
  • 🔄 Easy migration: replace your 2Captcha or Capsolver solver call and keep the rest of your scraper or bot unchanged.
  • 📖 Official docs: request types follow the CapMonster Cloud API documentation.

📊 CapMonster Cloud vs 2Captcha vs Capsolver

Looking for a 2captcha alternative or a capsolver alternative for Node.js web scraping and automation? Compare price, speed and success rate.

reCAPTCHA v3

Parameter CapMonster Cloud 2Captcha CapSolver DeathByCaptcha
Price per 1,000 solves (from) $0.90 $1.45 $1.00 $2.89
API response time ≤ 2 s ≤ 2 s < 3 s ≤ 3 s
Solving success rate up to 99% ~77–92% ~95–98% ~64–90%

Disclaimer: 2Captcha, CapSolver, and DeathByCaptcha are trademarks of their respective owners. CapMonster Cloud is not affiliated with these entities. Performance metrics and pricing comparisons are based on publicly available data and internal benchmarking conducted on 27.09.2026.

Cloudflare Turnstile

Parameter CapMonster Cloud 2Captcha Anti-Captcha DeathByCaptcha
Price per 1,000 solves (from) $1.30 $1.45 $2.00 $2.89
Time to solve 6.24 s* 16.9 s 20.33 s ~13 s
Solving success rate 99%* 96% 96% 96%

Disclaimer: 2Captcha, Anti-Captcha, and DeathByCaptcha are trademarks of their respective owners. CapMonster Cloud is not affiliated with these entities. Performance metrics and pricing comparisons are based on publicly available data and internal benchmarking as of 12.10.2026.

What this means in practice:

  • reCAPTCHA v3: $0.90 versus $1.45 at 2Captcha is up to 38% cheaper, and $0.90 versus $1.00 at Capsolver is 10% cheaper.
  • Cloudflare Turnstile: $1.30 versus $1.45 at 2Captcha is 10% cheaper, and a solving time of 6.24 s versus 16.9 s is more than 60% faster.

📦 Installation

Install the package from npm:

npm install @zennolab_com/capmonstercloud-client

The package published on npm already includes the compiled files and is ready to use after installation. Requires Node.js 18 or newer.

Build from this repository

Git does not contain the compiled dist output. The examples below import @zennolab_com/capmonstercloud-client, and inside this repository that name points at dist. After cloning, install dependencies and build before running an example or a test:

npm install
npm run build

Run npm run build again after changing the source.


🚀 Quick Start: Solve and Bypass Captchas in Node.js

1. Solve reCAPTCHA v2 (TypeScript)

import {
  CapMonsterCloudClientFactory,
  ClientOptions,
  RecaptchaV2Request,
} from '@zennolab_com/capmonstercloud-client';

const client = CapMonsterCloudClientFactory.Create(
  new ClientOptions({ clientKey: 'YOUR_API_KEY' }),
);

const result = await client.Solve(
  new RecaptchaV2Request({
    websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
    websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
  }),
);

console.log(result.solution);

2. Solve Cloudflare Turnstile (TypeScript)

import {
  CapMonsterCloudClientFactory,
  ClientOptions,
  TurnstileRequest,
} from '@zennolab_com/capmonstercloud-client';

const client = CapMonsterCloudClientFactory.Create(
  new ClientOptions({ clientKey: 'YOUR_API_KEY' }),
);

const result = await client.Solve(
  new TurnstileRequest({
    websiteURL: 'https://tsinvisble.zlsupport.com',
    websiteKey: '0x4AAAAAAABUY0VLtOUMAHxE',
  }),
);

console.log(result.solution);

3. CommonJS Example and Balance Check

const {
  CapMonsterCloudClientFactory,
  ClientOptions,
  RecaptchaV2Request,
} = require('@zennolab_com/capmonstercloud-client');

async function run() {
  const client = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: 'YOUR_API_KEY' }),
  );

  console.log('Balance:', await client.getBalance());

  const task = new RecaptchaV2Request({
    websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
    websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
  });

  const result = await client.Solve(task);
  console.log(result.solution);
}

run().catch(console.error);

4. Submit a Custom Payload with CommonCaptcha

Use CommonCaptcha when you need to provide a complete task payload directly.

const {
  CapMonsterCloudClientFactory,
  ClientOptions,
  CommonCaptcha,
} = require('@zennolab_com/capmonstercloud-client');

async function run() {
  const client = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: 'YOUR_API_KEY' }),
  );

  const task = new CommonCaptcha({
    task: {
      type: 'RecaptchaV2Task',
      websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
      websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
    },
  });

  console.log(await client.Solve(task));
}

run().catch(console.error);

🔄 Migrating from 2Captcha or Capsolver

Already use 2Captcha or Capsolver in your Node.js scraper or bot? Replace only the solver call and keep the rest of your code unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.

Before: 2Captcha (@2captcha/captcha-solver)

// Before: 2Captcha
const TwoCaptcha = require('@2captcha/captcha-solver');
const solver = new TwoCaptcha.Solver('YOUR_2CAPTCHA_API_KEY');

const res = await solver.recaptcha({
  pageurl: 'https://target-website.com/page-with-recaptcha',
  googlekey: 'YOUR_SITE_KEY',
});
const token = res.data;

Migrating from Capsolver

CapMonster Cloud uses the same createTask / getTaskResult flow, so if you call the Capsolver HTTP API directly from Node.js, you can switch to the CapMonster Cloud Node.js SDK or follow the API Methods Reference.

After: CapMonster Cloud

// After: CapMonster Cloud
import {
  CapMonsterCloudClientFactory,
  ClientOptions,
  RecaptchaV2Request,
} from '@zennolab_com/capmonstercloud-client';

const client = CapMonsterCloudClientFactory.Create(
  new ClientOptions({ clientKey: 'YOUR_CAPMONSTER_API_KEY' }),
);

const result = await client.Solve(
  new RecaptchaV2Request({
    websiteURL: 'https://target-website.com/page-with-recaptcha',
    websiteKey: 'YOUR_SITE_KEY',
  }),
);

const token = result.solution?.gRecaptchaResponse;

Only the client, the API key and the request class change: the token is used exactly as before, so the rest of your scraper stays the same.

Keep existing 2Captcha-based software

Software that already speaks the 2Captcha API can work with CapMonster Cloud without code changes. See the guide for connecting other services' APIs.


🛡️ Supported CAPTCHA Types: Bypass reCAPTCHA, Cloudflare Turnstile, GeeTest and More

Use this Node.js captcha solver for captcha bypass in web scraping and automation: reCAPTCHA bypass (v2, v2 Enterprise, v3), Cloudflare Turnstile solver, DataDome solver, GeeTest solver, Amazon WAF bypass, Imperva and image-to-text recognition.

All task types follow the official CapMonster Cloud API documentation:

Task family Example request classes in this SDK
reCAPTCHA RecaptchaV2Request, RecaptchaV2EnterpriseRequest, RecaptchaV3ProxylessRequest
Cloudflare Turnstile TurnstileRequest
GeeTest GeeTestRequest
Amazon WAF AmazonRequest, AmazonProxylessRequest
Image-to-Text ImageToTextRequest
Complex image tasks ComplexImageRecaptchaRequest, ComplexImageTaskRecognitionRequest
Custom anti-bot tasks DataDomeRequest, ImpervaRequest, TenDIRequest, ProsopoRequest, BasiliskRequest

🛠️ How It Works

[ Node.js Script / Browser Automation ]
         │
         ▼
[ Extract sitekey & website URL ]
         │
         ▼
[ CapMonster Cloud Node.js SDK ] ──► createTask API request
         │
         ▼
[ Neural Network Processing ] ──► Poll getTaskResult until the task is ready
         │
         ▼
[ Receive Token & Autosubmit ] ──► Complete bypass

⚙️ Best Practices

  • Use tokens promptly: CAPTCHA tokens expire quickly (a reCAPTCHA v2 token is valid for 60 seconds after solving), so submit or inject the solution immediately after receiving the response.
  • Keep session context consistent: When a task uses a proxy, use the same proxy in your scraping or browser session and in the CapMonster task.
  • Use the right task type: Choose the request type that matches the target protection and follow the required parameters in the documentation.
  • Monitor your balance: Keep your account balance positive in the Dashboard and handle API errors in your code.

💡 Use Cases

  • Web scraping and data collection from websites you are authorized to access, without manual captcha solving.
  • Browser automation: get the solution token in Node.js and inject it into the page with your automation tool.
  • Automated testing (QA) of your own website and its captcha-protected forms.
  • Backend services that need a captcha solving API inside a Node.js application.

🌐 Browser Use

The package can also be bundled for browser use. Browser implementations use native fetch, so use a compatible module bundler such as Webpack when integrating it into a frontend build.

Keep API keys private. Do not expose production CapMonster Cloud API keys in public frontend code.


🐛 Debugging

Set the DEBUG environment variable to enable the package logger:

DEBUG=cmc-* node app.js

❓ FAQ

Is CapMonster Cloud a 2Captcha alternative for Node.js? Yes. It is a captcha solving service with an official Node.js SDK. For reCAPTCHA v3 it starts at $0.90 per 1,000 solves versus $1.45 at 2Captcha, which is up to 38% cheaper. For Cloudflare Turnstile it starts at $1.30 versus $1.45, which is 10% cheaper.

Is CapMonster Cloud a Capsolver alternative for Node.js? Yes. For reCAPTCHA v3 it is 10% cheaper than Capsolver ($0.90 versus $1.00 per 1,000 solves) and shows an API response time of ≤ 2 s versus < 3 s. See the comparison table above and its disclaimer.

How do I migrate from 2Captcha or Capsolver to CapMonster Cloud in Node.js? Create a client with CapMonsterCloudClientFactory.Create, build the matching request class and call client.Solve(). See the migration examples above. Software that already supports the 2Captcha API can also be connected through the CapMonster Cloud guide.

Is there an official Node.js captcha solver from CapMonster Cloud? Yes. This repository is the official Node.js client library for the CapMonster Cloud captcha solving service.

How do I bypass reCAPTCHA v2 in Node.js? Create a client with your API key, pass a RecaptchaV2Request with the page URL and sitekey to client.Solve() and use result.solution.gRecaptchaResponse on the page. See the reCAPTCHA v2 documentation.

How do I bypass Cloudflare Turnstile in Node.js? Use TurnstileRequest with the page URL and sitekey, as in example 2 above. According to the Turnstile documentation, all Turnstile subtypes are supported automatically: manual, non-interactive and invisible.

Which captcha types does the Node.js SDK solve? reCAPTCHA v2, v3 and Enterprise, Cloudflare Turnstile, GeeTest, Amazon WAF, DataDome, Imperva, image-to-text and complex image tasks, and other custom anti-bot task types. See the supported types table above and the Supported Captchas Overview.

How do I get an API key? Register on CapMonster Cloud, top up your balance and copy your API key. The Getting Started Guide describes each step.

Which Node.js version is required? Node.js 18 or newer (see engines in package.json).

How fast are captchas solved? On average between 1 and 30 seconds, depending on the captcha type. More details are in the CapMonster Cloud FAQ.

How long is a reCAPTCHA v2 solution valid? According to the reCAPTCHA v2 documentation, the returned token is valid for 60 seconds after the captcha is solved, so use it right away.

Where is the full API reference? See the API Methods Reference.


⚖️ Responsible Use

CapMonster Cloud is intended for legitimate business purposes only, such as testing your own website or a website you are authorized to test, and recognizing images you provide. Read more about ethical and transparent captcha automation.


📚 Documentation & Support

Other official SDKs & integrations


📄 License

MIT © CapMonster Cloud

Maintainer verification before QA

Run npm run self-verify to build and check README examples, CommonJS/ESM, public type contracts and SDK requests against a local mock API. Read the self-verification guide for configuration, the AI-agent review prompt, coverage limits and report interpretation. The generated report is evidence for the agent's documentation review; a passing mock run alone does not establish QA readiness.

About

CapMonster Cloud Node.js SDK — TypeScript captcha solver & captcha bypass for reCAPTCHA v2/v3, Cloudflare Turnstile, DataDome & GeeTest. A 2captcha and capsolver alternative for Node.js web scraping and automation.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages