Перейти к основному содержимому
Возникают проблемы с получением токена?
Свяжитесь с поддержкой

reCAPTCHA v2 Enterprise

Посмотреть полный прайс

Внимание!

CapMonster Cloud по умолчанию работает через встроенные прокси — они уже включены в стоимость. Указывать собственные прокси требуется только в тех случаях, когда сайт не принимает токен или доступ к встроенным сервисам ограничен.

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

Объект содержит данные о задаче на решение ReCaptcha2 от Google версии Enterprise. Для обеспечения универсальности решения этого вида капчи нам необходимо использовать все данные, которые вы используете во время автоматизации заполнения формы на целевом сайте, включая прокси, UserAgent браузера и 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-recaptcha-response действует еще 60 секунд после решения капчи.

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

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

type<string>required

RecaptchaV2EnterpriseTask

websiteURL<string>required

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

websiteKey<string>required

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

pageAction<string>optional

Значение параметра action, которое передаётся виджетом ReCaptcha в Google и который при последующей верификации на сервере виден владельцу сайта. Указывайте этот параметр, если значение отличается от значения по умолчанию: verify

Пример в html:
grecaptcha.execute('site_key', {action:'login_test'}).

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

proxyType<string>optional

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

proxyAddress<string>optional

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

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

proxyPort<integer>optional

Порт прокси.

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);
  }
});

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

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"
	}
  }
}

Ответ

{
  "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"
  }
}

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

Как найти все нужные параметры для создания задачи на решение​

Вручную​

  1. Откройте ваш сайт, где отображается капча, в браузере.
  2. Правой кнопкой кликните по элементу капчи и выберите Inspect.

websiteKey​

Публичный ключ сайта (sitekey). Найти websiteKey можно в Элементах:

sitekeyEntpr

Или в Запросах:

sitekeyEntpr1

Автоматически​

Для автоматизации поиска параметров их можно извлекать через браузер (обычный или headless, например, с Playwright) или напрямую из HTTP-запросов. Поскольку значения динамических параметров действуют недолго, их рекомендуется использовать сразу после получения.

Важно!

Приведённые фрагменты кода являются базовыми примерами для ознакомления в извлечении необходимых параметров. Точная реализация будет зависеть от вашего сайта с капчей, его структуры и используемых HTML-элементов и селекторов.

Показать код (в браузере)
(() => {
  const payload = {};
  let sitekey = null;

  document.querySelectorAll('.g-recaptcha').forEach(div => {
    if (div.dataset.sitekey) sitekey = div.dataset.sitekey;

    for (const [key, value] of Object.entries(div.dataset)) {
      if (key !== 'sitekey') {
        payload[key] = value;
      }
    }
  });

  const scriptTags = Array.from(document.querySelectorAll("script:not([src])"));
  const regex = /grecaptcha\.enterprise\.render\([^,]+,\s*\{(.*?)\}/s;

  scriptTags.forEach(tag => {
    const match = regex.exec(tag.textContent);
    if (match) {
      const obj = match[1];
      const paramRegex = /(\w+)\s*:\s*['"]([^'"]+)['"]/g;
      let p;
      while ((p = paramRegex.exec(obj)) !== null) {
        const key = p[1];
        const val = p[2];
        if (key === "sitekey") sitekey = val;
        else payload[key] = val;
      }
    }
  });

  console.log("sitekey:", sitekey);
  console.log("enterprisePayload:", payload);
})();
Показать код (Node.js)
import { chromium } from 'playwright';

(async () => {
  const browser = await chromium.launch({ headless: false });
  const context = await browser.newContext();
  const page = await context.newPage();

  let sitekey = null;
  const enterprisePayload = {};

  const targetUrl = 'https://example.com';
  await page.goto(targetUrl, { timeout: 60000 });
  await page.waitForTimeout(3000);

  const recaptchaDivs = await page.$$('.g-recaptcha');
  for (const div of recaptchaDivs) {
    const attrs = ['data-sitekey', 'data-s', 'data-cdata', 'data-type', 'data-context'];
    for (const attr of attrs) {
      const val = await div.getAttribute(attr);
      if (val) {
        const key = attr.replace('data-', '');
        if (key === 'sitekey') {
          sitekey = val;
        } else {
          enterprisePayload[key] = val;
        }
      }
    }
  }

  const inlineScripts = await page.$$eval("script:not([src])", (scripts) =>
    scripts.map((s) => s.textContent)
  );

  const pattern = /grecaptcha\.enterprise\.render\([^,]+,\s*\{(.*?)\}/s;

  for (const script of inlineScripts) {
    const match = script.match(pattern);
    if (match) {
      const obj = match[1];
      const keyValuePattern = /(\w+)\s*:\s*['"]([^'"]+)['"]/g;
      let keyValueMatch;
      while ((keyValueMatch = keyValuePattern.exec(obj)) !== null) {
        const key = keyValueMatch[1];
        const val = keyValueMatch[2];
        if (key === 'sitekey') {
          sitekey = val;
        } else {
          enterprisePayload[key] = val;
        }
      }
      break;
    }
  }

  console.log(`sitekey: ${sitekey}`);
  console.log("enterprisePayload:");
  for (const [key, value] of Object.entries(enterprisePayload)) {
    console.log(`  ${key}: ${value}`);
  }

  await browser.close();
})();

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

Показать код (для браузера)
// https://github.com/ZennoLab/capmonstercloud-client-js

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

document.addEventListener('DOMContentLoaded', async () => {

  const API_KEY = "YOUR_API_KEY";  // Укажите ваш API-ключ CapMonster Cloud

  const client = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: API_KEY })
  );

  // Базовый пример без прокси
  // CapMonster Cloud автоматически использует свои прокси
  let recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest({
    websiteURL: "https://mydomain.com/page-with-recaptcha-enterprise", // URL страницы с капчей
    websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",             // Замените на корректное значение
    enterprisePayload: {
      s: "SOME_ADDITIONAL_TOKEN",   // Опциональный enterprise параметр
    }
  });

  // Пример использования вашего собственного прокси
  // Раскомментируйте данный блок, если вы хотите использовать собственный прокси

  /*
  const proxy = {
    proxyType: "http",
    proxyAddress: "123.45.67.89",
    proxyPort: 8080,
    proxyLogin: "username",
    proxyPassword: "password"
  };

  recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest({
    websiteURL: "https://mydomain.com/page-with-recaptcha-enterprise",
    websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
    enterprisePayload: { s: "SOME_ADDITIONAL_TOKEN" },
    proxy,
    userAgent: "userAgentPlaceholder"
  });
  */

  // При необходимости можно проверить баланс 
  const balance = await client.getBalance();
  console.log("Balance:", balance);

  const result = await client.Solve(recaptchaV2EnterpriseRequest);
  console.log("Solution:", result);
});
Показать код (Node.js)
// https://github.com/ZennoLab/capmonstercloud-client-js

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

const API_KEY = "YOUR_API_KEY";  // Укажите ваш API-ключ CapMonster Cloud

async function solveRecaptchaV2Enterprise() {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // Базовый пример без прокси
    // CapMonster Cloud автоматически использует свои прокси
    let recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest({
        websiteURL: "https://mydomain.com/page-with-recaptcha-enterprise", // URL страницы с капчей
        websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd", // Замените на корректное значение
        enterprisePayload: {
            s: "SOME_ADDITIONAL_TOKEN", // Опциональный enterprise параметр
        }
    });

    // Пример использования вашего собственного прокси
    // Раскомментируйте данный блок, если вы хотите использовать собственный прокси

    /*
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    recaptchaV2EnterpriseRequest = new RecaptchaV2EnterpriseRequest({
        websiteURL: "https://mydomain.com/page-with-recaptcha-enterprise",
        websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
        enterprisePayload: { s: "SOME_ADDITIONAL_TOKEN" },
        proxy,
        userAgent: "userAgentPlaceholder"
    });
    */

    // При необходимости можно проверить баланс 
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(recaptchaV2EnterpriseRequest);
    console.log("Solution:", result);
}

solveRecaptchaV2Enterprise().catch(console.error);
Ещё больше по теме в нашем блоге
Статья была полезной?
Узнайте стоимость AI решения КАПЧ