RecaptchaV2EnterpriseTask

Recaptcha Enterprise

/ 1000 токенов

97%

Recaptcha Enterprise (Spotify, Yahoo)

/ 1000 токенов

98%

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

Этот тип капчи не имеет визуальных отличий от ReCaptcha v.2, увидеть разницу можно с помощью кода капчи, например, в инструментах разработчика во вкладке “Сеть” в запросах:

URL Запроса (anchor): https://www.google.com/recaptcha/enterprise/anchor?ar=1&k=6Lf26sUnAAAAAIKLuWNYgRsFUfmI-3Lex3xT5N-s&co=aHR0cHM6Ly8yY2FwdGNoYS5jb206NDQz&hl=en&v=1kRDYC3bfA-o6-tsWzIBvp7k&size=normal&cb=43r1q2d3mx66

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

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

Внимание!

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

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

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

type<string>required

RecaptchaV2EnterpriseTaskProxyless

websiteURL<string>required

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

websiteKey<string>required

Ключ-идентификатор reCAPTCHA на целевой странице.
<div class="g-recaptcha" data-sitekey="THIS_ONE"></div>
или <iframe title="reCAPTCHA" src="...;k=6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH&... , где 6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH - websiteKey

enterprisePayload<string>optional

Некоторые реализации виджета reCAPTCHA Enterprise могут содержать дополнительное поле s в структуре, которая передаётся в метод grecaptcha.enterprise.render вместе с sitekey. Например: 2JvUXHNTnZl1Jb6WEvbDyB...ugQA из <pre lang="js" ><code>grecaptcha.enterprise.render("some-div-id", { sitekey: "6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16" theme: "dark" s: "2JvUXHNTnZl1Jb6WEvbDyB...ugQA" });</code></pre>

apiDomain<string>optional

Адрес домена с которого загружать reCAPTCHA Enterprise. Например:
- www.google.com
- www.recaptcha.net

Не используйте параметр, если не знаете зачем он нужен.

userAgent<string>optional

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

cookies<string>optional

Дополнительные cookies которые мы должны использовать во время взаимодействия с целевой страницей.
Формат: cookiename1=cookievalue1; cookiename2=cookievalue2

type<string>required

RecaptchaV2EnterpriseTask

websiteURL<string>required

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

websiteKey<string>required

enterprisePayload<string>optional

apiDomain<string>optional

Адрес домена с которого загружать reCAPTCHA Enterprise. Например:
- www.google.com
- www.recaptcha.net

Не используйте параметр, если не знаете зачем он нужен.

userAgent<string>optional

cookies<string>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

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

Для enterprisePayload - необходимо заменять функцию grecaptcha.enterprise.render перед её вызовом на свою и забирать значение из её параметров. Функция существует после загрузки скрипта, а рендерится капча обычно сразу или по событию страницы, если капча отрендерится с текущим полем s на клиенте, то токен с большой вероятностью принят не будет. Оригинальную функцию можно вызывать без поля s.

apiDomain – это домен, на котором размещается API-интерфейс для взаимодействия с reCAPTCHA, используется для верификации прохождения капчи пользователем.

Скрипт

var __test_grc = undefined;

var __test_enterprise = undefined;

var __test_render = undefined;

var __test_render_widget = undefined;

var __test_render_args = undefined; // здесь будет лежать объект, с которым вызывается render.

var __test_handler = {
  get: function(target, name, receiver) {
    if (name == 'enterprise') {
      return __test_enterprise ? __test_enterprise : (__test_enterprise = new Proxy(target[name], __test_handler));
    } else if (name == 'render') {
      __test_render = target[name];
      return (function(a, b) {
        __test_render_args = b;
        __test_render_widget = a;
        return __test_render(a, {sitekey: b.sitekey}); });
    } else {
      return target[name];
    }
  }
};

Object.defineProperty(window, 'grecaptcha', {
  enumerable: true,
  configurable: false,
  get: function() {
    return __test_grc;
  },
  set: function(value) {
    __test_grc = new Proxy(value, __test_handler);
  }
});

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

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

POST

https://api.capmonster.cloud/createTask

Запрос

{
  "clientKey":"API_KEY",
  "task": {
	"type":"RecaptchaV2EnterpriseTaskProxyless",
	"websiteURL":"https://mydomain.com/page-with-recaptcha-enterprise",
	"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
	"enterprisePayload": {
	  "s": "SOME_ADDITIONAL_TOKEN"
	}
  }
}

Ответ

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

POST

https://api.capmonster.cloud/createTask

Запрос

{
  "clientKey":"API_KEY",
  "task": {
	"type":"RecaptchaV2EnterpriseTask",
	"websiteURL":"https://mydomain.com/page-with-recaptcha-enterprise",
	"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
	"enterprisePayload": {
	  "s": "SOME_ADDITIONAL_TOKEN"
	},
	"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	Хеш который необходимо подставить в форму с reCAPTCHA Enterprise в `<textarea id="g-recaptcha-response" ..></textarea>`. Имеет длину от 500 до 2190 байт.

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

JavaScript
Python
C#

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

import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2EnterpriseProxylessRequest, /*RecaptchaV2EnterpriseRequest*/ } 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 recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseProxylessRequest({
    websiteURL: 'https://mydomain.com/page-with-recaptcha-enterprise',
    websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
    enterprisePayload: {
      s: 'SOME_ADDITIONAL_TOKEN',
    },
  });

  // const recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest({
  //   websiteURL: 'https://mydomain.com/page-with-recaptcha-enterprise',
  //   websiteKey: '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd',
  //   enterprisePayload: {
  //     s: 'SOME_ADDITIONAL_TOKEN',
  //   },
  //   proxyType: 'http',
  //   proxyAddress: '8.8.8.8',
  //   proxyPort: 8080,
  //   proxyLogin: 'proxyLoginHere',
  //   proxyPassword: 'proxyPasswordHere',
  //   userAgent: 'userAgentPlaceholder',
  // });

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

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

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

# RecaptchaV2EnterpriseProxyless

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

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

recaptcha2request = RecaptchaV2EnterpriseProxylessRequest(
    websiteUrl="https://example.com",  # Website with the captcha
    websiteKey="6Lf26sUnAAAAAIKLuWNYgRsFUfmI-3Lex3xT5N-s",  # Replace with your websiteKey
    enterprisePayload={
        "s": "SOME_ADDITIONAL_TOKEN" 
    }
)

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

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

# ReCaptchaV2Enterprise:

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

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

recaptcha2request = RecaptchaV2EnterpriseRequest(
    websiteUrl="https://example.com",  # Website with the captcha
    websiteKey="6Lf26sUnAAAAAIKLuWNYgRsFUfmI-3Lex3xT5N-s",  # Replace with your websiteKey
    enterprisePayload={
        "s": "SOME_ADDITIONAL_TOKEN"  
    },
    proxy_type="http",  # Proxy type (http, https, socks5)
    proxy_address="8.8.8.8",  
    proxy_port=8080,  
    proxy_login="proxyLoginHere",  
    proxy_password="proxyPasswordHere"
)

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

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

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

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

// RecaptchaV2EnterpriseProxyless

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 recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseProxylessRequest
        {
            WebsiteUrl = "https://example.com", // Website with the captcha
            WebsiteKey = "6Lf26sUnAAAAAIKLuWNYgRsFUfmI-3Lex3xT5N-s", // Replace with your website key
            EnterprisePayload = "{\"s\":\"SOME_ADDITIONAL_TOKEN\"}"
        };

        var recaptchaV2EnterpriseResult = await cmCloudClient.SolveAsync(recaptchaV2EnterpriseRequest);

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

// ReCaptchaV2Enterprise:

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 recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest
        {
            WebsiteUrl = "https://example.com", // Website with the captcha
            WebsiteKey = "6Lf26sUnAAAAAIKLuWNYgRsFUfmI-3Lex3xT5N-s", // Replace with your website key
            EnterprisePayload = "{\"s\":\"SOME_ADDITIONAL_TOKEN\"}",
            ProxyType = ProxyType.Http,
            ProxyAddress = "8.8.8.8",
            ProxyPort = 8080,
            ProxyLogin = "proxyLoginHere",
            ProxyPassword = "proxyPasswordHere"
        };

        var recaptchaV2EnterpriseResult = await cmCloudClient.SolveAsync(recaptchaV2EnterpriseRequest);

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

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

RecaptchaV2EnterpriseTask

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

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

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

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

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

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

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

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