RecaptchaV2Task

/ 1000 токенов

99%

Объект содержит данные о задаче на решение ReCaptcha2 от Google. Для обеспечения универсальности решения этого вида капчи нам необходимо использовать все данные, которые вы используете во время автоматизации заполнения формы на целевом сайте, включая прокси, user-agent браузера и cookies. Это позволит избежать любых проблем при изменении Google кода своей капчи.

Капча может решаться довольно долго по сравнению с обычной капчей, но это компенсируется тем, что полученный g-captcha-response действует еще 60 секунд после решения капчи.

Ещё больше по теме в нашем блоге

Внимание!

Если прокси с авторизацией по IP, то необходимо обязательно добавить 116.203.55.208 в белый список.

Параметры запроса

RecaptchaV2TaskProxyless (без прокси)
RecaptchaV2Task (при использовании прокси)

type<string>required

RecaptchaV2TaskProxyless

websiteURL<string>required

Адрес страницы, на которой решается капча.

websiteKey<string>required

Ключ-идентификатор ReCaptcha2 на целевой странице.
<div class="g-recaptcha" data-sitekey="THIS_ONE"></div>

recaptchaDataSValue<string>optional

Некоторые реализации виджета ReCaptcha2 могут содержать дополнительный параметр "data-s" в div'е ReCaptcha2, который является одноразовым токеном и должен собираться каждый раз при решении ReCaptcha2.
<div class="g-recaptcha" data-sitekey="some sitekey" data-s="THIS_ONE"></div>

userAgent<string>optional

User-Agent браузера, используемый в эмуляции. Необходимо использовать подпись современного браузера, иначе Google будет возвращать ошибку, требуя обновить браузер.

cookies<string>optional

Дополнительные cookies, которые мы должны использовать во время взаимодействия с целевой страницей.

Формат: cookiename1=cookievalue1; cookiename2=cookievalue2

isInvisible<bool>optional

true, если капча невидимая, т.е. имеет скрытое поле для подтверждения, чекбокс отсутствует. При подозрении на бота вызывается дополнительная проверка.

type<string>required

RecaptchaV2Task

websiteURL<string>required

Адрес страницы, на которой решается капча

websiteKey<string>required

Ключ-идентификатор ReCaptcha2 на целевой странице.
<div class="g-recaptcha" data-sitekey="THIS_ONE"></div>

recaptchaDataSValue<string>optional

userAgent<string>optional

cookies<string>optional

Дополнительные cookies, которые мы должны использовать во время взаимодействия с целевой страницей.

Формат: cookiename1=cookievalue1; cookiename2=cookievalue2

isInvisible<bool>optional

proxyType<string>required

http - обычный http/https прокси;
https - попробуйте эту опцию только если "http" не работает (требуется для некоторых кастомных прокси);
socks4 - socks4 прокси;
socks5 - socks5 прокси.

proxyAddress<string>required

IP адрес прокси IPv4/IPv6. Не допускается:

использование имен хостов;
использование прозрачных прокси (там где можно видеть IP клиента);
использование прокси на локальных машинах.

proxyPort<integer>required

Порт прокси.

proxyLogin<string>optional

Логин прокси-сервера.

proxyPassword<string>optional

Пароль прокси-сервера.

Метод создания задачи

RecaptchaV2TaskProxyless (без прокси)
RecaptchaV2Task (при использовании прокси)

POST

https://api.capmonster.cloud/createTask

Запрос

{
  "clientKey":"API_KEY",
  "task": {
	"type":"RecaptchaV2TaskProxyless",
	"websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
	"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Ответ

{
  "errorId":0,
  "taskId":407533072
}

POST

https://api.capmonster.cloud/createTask

Запрос

{
  "clientKey":"API_KEY",
  "task": {
	"type":"RecaptchaV2Task",
	"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":"userAgentPlaceholder"
  }
}

Ответ

{
  "errorId":0,
  "taskId":407533072
}

Метод получения результата задачи

Используйте метод getTaskResult чтобы получить решение ReCaptcha2. В зависимости от загрузки системы вы получите ответ через время в диапазоне от 10 с до 80 с.

POST

https://api.capmonster.cloud/getTaskResult

Запрос

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Ответ

{
  "errorId":0,
  "status":"ready",
  "solution": {
	"gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}

Свойство	Тип	Описание
gRecaptchaResponse	String	Хеш, который необходимо подставить в форму с ReCaptcha2 в `<textarea id="g-recaptcha-response" ..></textarea>`. Имеет длину от 500 до 2190 байт.

Используйте библиотеку SDK

JavaScript
Python
C#

// https://github.com/ZennoLab/capmonstercloud-client-js

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

  // 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: 'userAgentPlaceholder',
  // });

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

Ещё больше по теме в нашем блоге

# https://github.com/ZennoLab/capmonstercloud-client-python

# ReСaptchaV2Proxyless:

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV2ProxylessRequest

client_options = ClientOptions(api_key="your_api_key")  # Replace with your CapMonster Cloud API key
cap_monster_client = CapMonsterClient(options=client_options)

recaptcha2request = RecaptchaV2ProxylessRequest(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",  # URL with captcha
    websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"  # Replace with the correct website key
)

async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha2request)

responses = asyncio.run(solve_captcha())
print(responses)

# ReСaptchaV2:

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV2Request

client_options = ClientOptions(api_key="your_api_key")  # Replace with your CapMonster Cloud API key
cap_monster_client = CapMonsterClient(options=client_options)

recaptcha2_request = RecaptchaV2Request(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",  # URL with captcha
    websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",  # ReCaptcha v2 site key
    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/130.0.0.0 Safari/537.36"  # Use the current userAgent
)

async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha2_request)

response = asyncio.run(solve_captcha())
print(response)

Ещё больше по теме в нашем блоге

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

// ReСaptchaV2Proxyless:

using Zennolab.CapMonsterCloud.Requests;
using Zennolab.CapMonsterCloud;

class Program
{
    static async Task Main(string[] args)
    {
        var clientOptions = new ClientOptions
        {
            ClientKey = "your_api_key" // Replace with your CapMonster Cloud API key
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        var recaptchaV2Request = new RecaptchaV2ProxylessRequest
        {
            WebsiteUrl = "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",  // URL with captcha
            WebsiteKey = "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",  // Replace with the correct website key
        };

        var recaptchaV2Result = await cmCloudClient.SolveAsync(recaptchaV2Request);

        Console.WriteLine("Captcha Solution: " + recaptchaV2Result.Solution.Value);
    }
}

// ReСaptchaV2:

using Zennolab.CapMonsterCloud.Requests;
using Zennolab.CapMonsterCloud;

class Program
{
    static async Task Main(string[] args)
    {
        var clientOptions = new ClientOptions
        {
            ClientKey = "your_api_key" // Replace with your CapMonster Cloud API key
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        var recaptchaV2Request = new RecaptchaV2Request
        {
            WebsiteUrl = "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",  // URL with captcha
            WebsiteKey = "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",  // Replace with the correct website key
            ProxyType = ProxyType.Http,
            ProxyAddress = "8.8.8.8",
            ProxyPort = 8080,
            ProxyLogin = "proxyLoginHere",
            ProxyPassword = "proxyPasswordHere"
        };

        var recaptchaV2Result = await cmCloudClient.SolveAsync(recaptchaV2Request);

        Console.WriteLine("Captcha Solution: " + recaptchaV2Result.Solution.Value);
    }
}

Ещё больше по теме в нашем блоге

RecaptchaV2Task

Параметры запроса​

Метод создания задачи​

Метод получения результата задачи​

Используйте библиотеку SDK​

Параметры запроса

Метод создания задачи

Метод получения результата задачи

Используйте библиотеку SDK