@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, RecaptchaV2ProxylessRequest } = 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 recaptchaV2ProxylessRequest = new RecaptchaV2ProxylessRequest({
    websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high',
    websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
  });

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

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',
    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:

• GeeTestProxylessRequest
• GeeTestRequest
• HCaptchaProxylessRequest
• HCaptchaRequest
• ImageToTextRequest
• RecaptchaV2ProxylessRequest
• RecaptchaV2Request
• RecaptchaV3ProxylessRequest
• RecaptchaV2EnterpriseProxylessRequest
• RecaptchaV2EnterpriseRequest
• TurnstileProxylessRequest
• TurnstileRequest
• RecaptchaComplexImageTaskRequest
• HcaptchaComplexImageTaskRequest
• DataDome