Como resolver o reCAPTCHA v2 Enterprise com Node.js

reCAPTCHA v2 Enterprise adiciona pontuação de risco de nível empresarial à caixa de seleção padrão “Não sou um robô”. O widget tem a mesma aparência do padrão v2, mas os tokens são verificados por meio do back-end empresarial do Google com validação mais rigorosa. Para resolver isso com CaptchaAI, adicione enterprise=1 à sua solicitação v2.

Este guia cobre a implementação completa do Node.js – detectando o Enterprise v2, enviando para CaptchaAI, pesquisando o resultado e injetando o token.

O que você precisa

Etapa 1: Identificar reCAPTCHA v2 Enterprise

Abra o DevTools e procure a solicitação de âncora corporativa na guia Rede:

https://www.google.com/recaptcha/enterprise/anchor?ar=1&k=6LdxxXXxAAAAAAcX...&sa=LOGIN&...

Indicadores principais:

• A fonte do script inclui /recaptcha/enterprise.js ou /enterprise/anchor
• O parâmetro k= é sitekey
• O parâmetro sa= (se presente) é a ação

O padrão v2 usa /recaptcha/api2/anchor — não adicione enterprise=1 para o padrão v2.

Etapa 2: envie a tarefa para CaptchaAI

const API_KEY = "YOUR_API_KEY";

async function submitTask(sitekey, pageurl, action) {
  const params = new URLSearchParams({
    key: API_KEY,
    method: "userrecaptcha",
    googlekey: sitekey,
    pageurl: pageurl,
    enterprise: "1",
    json: "1",
  });

  if (action) {
    params.set("action", action);
  }

  const response = await fetch(
    `https://ocr.captchaai.com/in.php?${params}`
  );
  const data = await response.json();

  if (data.status !== 1) {
    throw new Error(`Submit failed: ${data.request}`);
  }

  console.log(`Task submitted. ID: ${data.request}`);
  return data.request;
}

Etapa 3: enquete para o resultado

Aguarde 20 segundos antes da primeira enquete e verifique a cada 5 segundos:

function delay(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

async function pollResult(taskId) {
  await delay(20000);

  for (let attempt = 0; attempt < 30; attempt++) {
    const params = new URLSearchParams({
      key: API_KEY,
      action: "get",
      id: taskId,
      json: "1",
    });

    const response = await fetch(
      `https://ocr.captchaai.com/res.php?${params}`
    );
    const data = await response.json();

    if (data.status === 1) {
      console.log(`Solved. Token: ${data.request.substring(0, 60)}...`);
      return {
        token: data.request,
        userAgent: data.user_agent || "",
      };
    }

    if (data.request !== "CAPCHA_NOT_READY") {
      throw new Error(`Solve failed: ${data.request}`);
    }

    console.log(`Attempt ${attempt + 1}: not ready, waiting 5s...`);
    await delay(5000);
  }

  throw new Error("Solve timed out");
}

Etapa 4: injetar o token

Envie o token resolvido como g-recaptcha-response. Se a API retornou um user_agent, use-o nos cabeçalhos da sua solicitação:

async function submitForm(token, userAgent) {
  const headers = { "Content-Type": "application/x-www-form-urlencoded" };

  if (userAgent) {
    headers["User-Agent"] = userAgent;
  }

  const response = await fetch("https://example.com/api/login", {
    method: "POST",
    headers,
    body: new URLSearchParams({
      username: "user",
      password: "pass",
      "g-recaptcha-response": token,
    }),
  });

  console.log(`Response status: ${response.status}`);
  return response;
}

Roteiro de trabalho completo

const API_KEY = "YOUR_API_KEY";
const SITE_KEY = "6LdxxXXxAAAAAAcXxxXxxX91xxxxxxxx8xxOx7A";
const PAGE_URL = "https://staging.example.com/qa-login";
const ACTION = "LOGIN"; // optional — omit if not in anchor URL

function delay(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

async function solveRecaptchaV2Enterprise() {
  // Submit task
  const submitParams = new URLSearchParams({
    key: API_KEY,
    method: "userrecaptcha",
    googlekey: SITE_KEY,
    pageurl: PAGE_URL,
    enterprise: "1",
    action: ACTION,
    json: "1",
  });

  const submitRes = await fetch(
    `https://ocr.captchaai.com/in.php?${submitParams}`
  );
  const submitData = await submitRes.json();

  if (submitData.status !== 1) {
    throw new Error(`Submit error: ${submitData.request}`);
  }

  const taskId = submitData.request;
  console.log(`Task ID: ${taskId}`);

  // Poll for result
  await delay(20000);

  for (let i = 0; i < 30; i++) {
    const pollParams = new URLSearchParams({
      key: API_KEY,
      action: "get",
      id: taskId,
      json: "1",
    });

    const pollRes = await fetch(
      `https://ocr.captchaai.com/res.php?${pollParams}`
    );
    const pollData = await pollRes.json();

    if (pollData.status === 1) {
      return {
        token: pollData.request,
        userAgent: pollData.user_agent || "",
      };
    }

    if (pollData.request !== "CAPCHA_NOT_READY") {
      throw new Error(`Solve error: ${pollData.request}`);
    }

    await delay(5000);
  }

  throw new Error("Solve timed out");
}

(async () => {
  const { token, userAgent } = await solveRecaptchaV2Enterprise();
  console.log(`Token: ${token.substring(0, 60)}...`);
  if (userAgent) console.log(`User-Agent: ${userAgent}`);
})();

Saída esperada:

Task ID: 73849562810
Token: 03AGdBq24PBCqLmOx2V4pGHJjkR2xZ1r...
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)...

Solução de problemas

Perguntas frequentes

Como posso detectar o Enterprise v2 versus o Standard v2?

O Enterprise v2 é carregado de /recaptcha/enterprise/ no script ou URL âncora. O padrão v2 usa /recaptcha/api2/.

O parâmetro de ação é obrigatório?

Somente se o URL âncora incluir sa=. Se estiver ausente, omita-o da sua solicitação CaptchaAI.

Por que o site de destino rejeita meu token?

Mais comumente: incompatibilidade entre usuário e agente. Os tokens Enterprise v2 estão vinculados ao User-Agent do solucionador. Sempre use o valor user_agent retornado na resposta da enquete.

Posso usar isso com Puppeteer ou Playwright?

Sim. Extraia a chave do site da página, resolva por meio da API e injete o token em document.getElementById('g-recaptcha-response').innerHTML.

Qual é o tempo de resolução típico?

15–30 segundos dependendo da carga do servidor.

Comece a resolver reCAPTCHA v2 Enterprise

Obtenha sua chave API emcaptchaai.come adicione enterprise=1 às suas solicitações v2.

Guias relacionados

• Como resolver reCAPTCHA v2 Enterprise usando API
• Resolva reCAPTCHA v2 Enterprise com Python
• Erros e correções comuns de reCAPTCHA v2 Enterprise
• Como identificar a implementação empresarial do reCAPTCHA