✅ CapMonster.Cloud — Fast, Reliable CAPTCHA Solving for Automation & Scraping

CapMonster Cloud JavaScript SDK

Official JavaScript and Node.js SDK for the CapMonster Cloud API. Use this package when you want to create tasks, poll for results, and integrate CapMonster Cloud from Node.js or browser-based apps.

Links

• Package: @zennolab_com/capmonstercloud-client
• Documentation: docs.capmonster.cloud
• Dashboard / API key: dash.capmonster.cloud

Installation

npm i @zennolab_com/capmonstercloud-client

Need to test before depositing? Contact support and we’ll add trial credits to your account.

Minimal example (Node.js / TypeScript)

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

async function run() {
  const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: '<your capmonster.cloud API key>' }));
  console.log(await cmcClient.getBalance());

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

  console.log(await cmcClient.Solve(recaptchaV2Request));
}

run()
  .then(() => {
    console.log('DONE');
    process.exit(0);
  })
  .catch((err) => {
    console.error(err);
    process.exit(1);
  });

Supported task families include reCAPTCHA, GeeTest, Turnstile, image-to-text, and additional task types documented in the public docs.

Usage with Browser (with or without Typescript)

Browser implementation use fetch instead of http(s). For browser usage you need some Module Bundler (e.g. Webpack).

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

document.addEventListener('DOMContentLoaded', async () => {
  const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: '<your capmonster.cloud API key>' }));
  console.log(await cmcClient.getBalance());

  const recaptchaV2Request = new RecaptchaV2Request({
    websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
    websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
    proxy: {
      proxyType: 'http',
      proxyAddress: '8.8.8.8',
      proxyPort: 8080,
      proxyLogin: 'proxyLoginHere',
      proxyPassword: 'proxyPasswordHere',
    },
    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.132 Safari/537.36',
  });

  console.log(await cmcClient.Solve(recaptchaV2Request));
});

Debug

For debugging set DEBUG environmental variable to one of possible values (see debug module)

DEBUG=cmc-* node app.js

Supported request classes

• AltchaRequest
• AmazonRequest
• BasiliskRequest
• BinanceRequest
• CastleRequest
• ComplexImageFunCaptchaRequest
• ComplexImageRecaptchaRequest
• ComplexImageTaskRecognitionRequest
• DataDomeRequest
• FunCaptchaRequest
• GeeTestRequest
• HuntRequest
• ImageToTextRequest
• ImpervaRequest
• MTCaptchaRequest
• ProsopoRequest
• RecaptchaV2EnterpriseRequest
• RecaptchaV2Request
• RecaptchaV3EnterpriseRequest
• RecaptchaV3ProxylessRequest
• TSPDRequest
• TemuRequest
• TenDIRequest
• TurnstileRequest
• YidunRequest

⭐️ If you find this project useful, please give it a star on GitHub!