@zennolab_com/capmonstercloud-client

Zennolab CapMonsterCloud JS Client

Official JS client library for capmonster.cloud captcha recognition service

Installation

Via NPM:

npm i @zennolab_com/capmonstercloud-client

Usage with Node (with or without 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);
  });

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 captcha recognition requests:

• AmazonRequest
• BasiliskRequest
• BinanceRequest
• DataDomeRequest
• GeeTestRequest
• HcaptchaComplexImageTaskRequest
• ImageToTextRequest
• ImpervaRequest
• MTCaptcha
• ProsopoRequest
• RecaptchaComplexImageTaskRequest
• RecaptchaV2EnterpriseRequest
• RecaptchaV3EnterpriseRequest
• RecaptchaV2Request
• RecaptchaV3ProxylessRequest
• Temu
• TenDIRequest
• TurnstileRequest
• Yidun
• Altcha
• Castle
• TSPD
• Hunt