Pular para o conteúdo principal
Está tendo problemas para obter o token?
Entre em contato com o suporte

Hunt

Ver preço completo

Hunt CAPTCHA é um sistema anti-bot utilizado em plataformas de apostas para detectar atividade automatizada. Ele monitora o comportamento do usuário e, ao identificar ações suspeitas, inicia uma verificação interativa.

Atenção!

  • Para executar esta tarefa, utilize seus próprios proxies.

  • Nosso sistema de resolução possui dois modos de operação: geração de X-HD (fingerprint) e resolução de CAPTCHA. Se você deseja apenas gerar o X-HD, não envie o parâmetro data. Se precisar resolver o CAPTCHA, envie em data o token que o site de destino fornece durante determinadas ações (por exemplo, ao solicitar um SMS).

Parâmetros da solicitação​


IMPORTANTE: alguns valores de parâmetros são dinâmicos — eles mudam a cada renderização da página que contém Hunt.
Extraia-os imediatamente antes de criar a tarefa para evitar erros durante a resolução.
Veja exemplos de extração automática de parâmetros nas seções Como obter meta.token e Exemplo de resolução do Hunt CAPTCHA.
type<string>required

CustomTask

class<string>required

HUNT

websiteURL<string>required

Endereço da página onde o Hunt CAPTCHA está localizado.

apiGetLib (dentro de metadata)<string>required

Link completo para o arquivo api.js.

Exemplo:
https://www.example.com/hd-api/external/apps/<hash>/api.js

Envie no seguinte formato:
"apiGetLib":"https://example.com/hd-api/external/apps/a2157wab1045d68672a63557e0n2a77edbfd15ea/api.js"

Você pode encontrar esse link no DevTools (abas Network ou Elements) na página com o Hunt CAPTCHA.
Use a busca por palavras-chave como: hd-api ou api.js.

data (dentro de metadata)<string>optional

O parâmetro data deve ser especificado ao utilizar o modo de resolução de CAPTCHA (veja mais detalhes abaixo).

userAgent<string>optional

User-Agent do navegador.
Forneça apenas o UA do Windows atual: userAgentPlaceholder

proxyType<string>required

http - proxy HTTP/HTTPS normal;
https - use se http não funcionar (necessário para alguns proxies personalizados);
socks4 - proxy SOCKS4;
socks5 - proxy SOCKS5.

proxyAddress<string>required

Endereço IP do proxy (IPv4/IPv6). Não permitido:

  • Proxies transparentes
  • Proxies da máquina local

proxyPort<integer>required

Porta do proxy.

proxyLogin<string>required

Login do proxy.

proxyPassword<string>required

Senha do proxy.

A solução suporta dois modos de operação:

  1. Geração de X-HD (fingerprint)

    • Neste modo, você não envia o parâmetro data.
    • Após criar a tarefa, você receberá o X-HD — uma impressão digital única vinculada ao seu IP, que pode ser utilizada em requisições subsequentes ao site.

  2. Resolução de CAPTCHA

    • Neste modo, você deve enviar em data o token (valor de meta.token) que o site fornece durante determinadas ações (por exemplo, ao solicitar um SMS).
    • Após criar a tarefa, você receberá a solução do CAPTCHA na forma de um token pronto para ser utilizado no site.

Quando utilizar cada modo:

SituaçãoÉ necessário enviar data?
Inicialização primáriaNão
Precisa obter X-HDNão
O site retornou erro de CAPTCHASim
meta.token recebidoSim

Exemplo de fluxo completo:

  1. Criar uma tarefa sem data
  2. Receber o X-HD do nosso serviço
  3. Enviar uma requisição ao site utilizando o X-HD
  4. Receber meta.token
  5. Criar uma tarefa com data = meta.token
  6. Receber a solução
  7. Enviar a solução ao site
Importante

Ao trocar o proxy, é necessário obter um novo X-HD.

Modo 1. Geração de X-HD​

Utilizado para obter o token X-HD vinculado ao IP.

Método de criação de tarefa para geração de X-HD​

POST
https://api.capmonster.cloud/createTask

Requisição

{
  "type": "CustomTask",
  "class": "HUNT",
  "websiteURL": "https://example.com",
  "metadata": {
    "apiGetLib": "https://example.com/hd-api/external/apps/a2157wab1045d68672a63557e0n2a77edbfd15ea/api.js"
  },
  "userAgent": "userAgentPlaceholder",
  "proxyType": "http",
  "proxyAddress": "8.8.8.8",
  "proxyPort": 8080,
  "proxyLogin": "proxyLoginHere",
  "proxyPassword": "proxyPasswordHere"
}

Resposta

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

Modo 2. Resolução de CAPTCHA​

Utilizado após o site retornar um erro de captcha e fornecer meta.token.

Como obter meta.token​

  1. Faça uma requisição ao site (por exemplo, uma solicitação de SMS).
  2. Receba o X-HD.

  1. O site retorna:
{
  "errors": [{"code": "113", "title": "Captcha error"}],
  "meta": {
    "token": "SITE_META_TOKEN"
  }
}

Método de criação de tarefa para resolução de CAPTCHA​

O valor de meta.token deve ser enviado no parâmetro data.

POST
https://api.capmonster.cloud/createTask

Requisição

{
  "type": "CustomTask",
  "class": "HUNT",
  "websiteUrl": "https://example.com",
  "metadata": {
    "apiGetLib": "https://example.com/hd-api/external/apps/a2157wab1045d68672a63557e0n2a77edbfd15ea/api.js",
    "data": "kufyHK/s/jTNU...AfwIW", // valor de META_TOKEN
  },
  "userAgent": "userAgentPlaceholder",
  "proxyType": "http",
  "proxyAddress": "8.8.8.8",
  "proxyPort": 8080,
  "proxyLogin": "proxyLoginHere",
  "proxyPassword": "proxyPasswordHere"
}

Resposta

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

Método para obter o resultado da tarefa​

Use o método getTaskResult para obter o fingerprint X-HD ou a solução da CAPTCHA Hunt.

Atenção!

Valor de solution.data.token:

  • No modo de geração de X-HD — este é o token X-HD que deve ser utilizado nas requisições ao site de destino.

  • No modo de resolução da CAPTCHA — solution.data.token é o token de solução que deve ser enviado de volta ao site para confirmar a ação.

POST
https://api.capmonster.cloud/getTaskResult

Requisição

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

Resposta

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "data": {
      "token": "6IyDCCpDdSK...YGs1Wug/z/kLNSpjewI="
    }
  }
}

Trabalhando com cookies​

Atenção!

O site pode usar cookies especiais para gerenciar a sessão. Se estiverem ausentes ou não forem enviados com as requisições, o servidor pode rejeitar a solicitação ou exigir uma nova verificação.

Exemplo de cookies recebidos do site:

platform_type=desktop; typeBetNames=full; _glhf=1234567890; coefview=0; visit=1-123abc012345d1be726746568edc62d9; fast_coupon=true;
v3fr=1; lng=en; flaglng=en; SESSION=12a3aea8cdcfdbb9e7df8ee99b526a84; auid=ab0dW2mqlz1Tjo2AAwplAg==; ggru=195; che_g=12abcede-691f-c7b2-d1e8-8488bc557d98

Princípio geral de funcionamento dos cookies:

  1. Primeiro, é necessário abrir uma página do site ou enviar uma requisição GET para a página desejada. Isso permite que o servidor inicialize uma sessão de usuário e defina os cookies necessários.

  2. Na resposta, o servidor envia cookies através do cabeçalho Set-Cookie. Esses cookies podem conter um identificador de sessão, parâmetros de segurança e dados relacionados à proteção anti‑bot.

  3. Os cookies recebidos devem ser armazenados, pois são usados para identificar o cliente nas requisições seguintes.

  4. Ao enviar requisições posteriores para a API do site, os cookies devem ser enviados de volta ao servidor no cabeçalho Cookie, para que o servidor entenda que a requisição pertence à mesma sessão.

  5. Todas as requisições devem ser feitas dentro da mesma sessão usando o mesmo endereço IP (ou proxy) e User-Agent. Caso contrário, o servidor pode considerar a requisição suspeita e exigir uma nova verificação.

  6. Em alguns casos, parte dos cookies é criada no lado do cliente (por exemplo, por JavaScript na página). Durante automação ou testes, pode ser necessário extrair cookies diretamente do navegador ou gerá‑los de forma semelhante.

Exemplo de resolução do Hunt CAPTCHA​

Os exemplos abaixo demonstram um fluxo típico de interação com um site que utiliza Hunt CAPTCHA. O código mostra como:

  • obter cookies iniciais ao abrir uma página do site;
  • gerar cookies adicionais que normalmente podem ser criados no lado do cliente;
  • criar um fingerprint (X‑HD) através do CapMonster Cloud usado pelo site para verificar requisições;
  • enviar uma requisição à API do site para iniciar uma ação (por exemplo, envio de SMS);
  • enviar os dados recebidos para o serviço de resolução de captcha;
  • após receber a solução, enviar uma requisição final para a API com os parâmetros necessários.

Também é importante utilizar cabeçalhos HTTP atualizados e um User-Agent correto.

Mostrar código (Node.js)
import { gotScraping } from "got-scraping";
import crypto from "crypto";

/* ================= CONFIG (recomendado armazenar em .env) ================= */
// Configurações da API do CapMonster Cloud, do site e dados do usuário

const API_KEY = "YOUR_API_KEY"; // Sua chave de API do CapMonster Cloud
const SOLVER_URL = "https://api.capmonster.cloud";

const BASE_URL = "https://example.com"; // URL base do site
const API_GET_LIB =
  "https://example.com/hd-api/external/apps/a1047eab1035d58682a53557e0b2a75edbfd15fd/api.js"; // api.js do site

const PHONE = "91123456789"; // Telefone para registro (sem código do país)
const COUNTRY_CODE = "54"; // Código do país

const UA = "userAgentPlaceholder"; // User-Agent para as requisições

/* ================= Configurações de proxy ================= */

const PROXY_HOST = "proxyAddress";
const PROXY_PORT = 8080;
const PROXY_USER = "proxyLogin";
const PROXY_PASS = "proxyPassword";

const PROXY = `http://${PROXY_USER}:${PROXY_PASS}@${PROXY_HOST}:${PROXY_PORT}`;

/* ================= HEADERS ================= */
// Cabeçalhos para requisições HTTP
// htmlHeaders — para requisições GET de páginas
// apiHeaders — para requisições da API do site

const htmlHeaders = {
  accept:
    "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
  "accept-encoding": "gzip, deflate, br, zstd",
  "accept-language": "en-US,en;q=0.9,ru;q=0.8",
  "cache-control": "no-cache",
  pragma: "no-cache",
  priority: "u=0, i",
  "sec-ch-ua": `"Not:A-Brand";v="99", "Google Chrome";v="145", "Chromium";v="145"`,
  "sec-ch-ua-mobile": "?0",
  "sec-ch-ua-platform": `"Windows"`,
  "sec-fetch-dest": "document",
  "sec-fetch-mode": "navigate",
  "sec-fetch-site": "none",
  "sec-fetch-user": "?1",
  "upgrade-insecure-requests": "1",
  "user-agent": UA,
};

const apiHeaders = {
  accept: "application/vnd.api+json",
  "accept-encoding": "gzip, deflate, br, zstd",
  "accept-language": "en-US,en;q=0.9,ru;q=0.8",
  "cache-control": "no-cache",
  pragma: "no-cache",
  priority: "u=1, i",
  "content-type": "application/vnd.api+json",
  origin: BASE_URL,
  referer: BASE_URL + "/", // Referer atual do site
  "sec-ch-ua": `"Not:A-Brand";v="99", "Google Chrome";v="145", "Chromium";v="145"`,
  "sec-ch-ua-mobile": "?0",
  "sec-ch-ua-platform": `"Windows"`,
  "sec-fetch-dest": "empty",
  "sec-fetch-mode": "cors",
  "sec-fetch-site": "same-origin",
  "user-agent": UA,
  "x-requested-with": "XMLHttpRequest",
};

/* ================= UTILS ================= */
// Funções auxiliares

const delay = (ms) => new Promise((r) => setTimeout(r, ms));

function randomString(len = 20) {
  const chars =
    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
  let result = "";
  for (let i = 0; i < len; i++) {
    result += chars[Math.floor(Math.random() * chars.length)];
  }
  return result;
}

/* ================= CAPMONSTER CLOUD ================= */
// Criação da tarefa e espera pela solução da captcha

async function createTask(task) {
  const { body } = await gotScraping.post(`${SOLVER_URL}/createTask`, {
    json: { clientKey: API_KEY, task },
    responseType: "json",
  });

  if (body.errorId !== 0)
    throw new Error("createTask error: " + JSON.stringify(body));

  return body.taskId;
}

async function waitResult(taskId) {
  while (true) {
    const { body } = await gotScraping.post(`${SOLVER_URL}/getTaskResult`, {
      json: { clientKey: API_KEY, taskId },
      responseType: "json",
    });

    if (body.status === "ready")
      return body.solution?.token || body.solution?.data?.token;

    await delay(3000);
  }
}

/* ================= MAIN FLOW ================= */
// Processo principal de registro automático com captcha

(async () => {
  try {
    // ---------------- STEP 1: Obter cookies ----------------
    console.log("STEP 1 — Getting cookies...");

    const base = await gotScraping.get(
      BASE_URL + "/registration?type=phone_reg", // Substitua pela página de registro atual do site
      {
        headers: htmlHeaders,
        proxyUrl: PROXY,
      },
    );

    // Salvamos os cookies recebidos do servidor
    let cookies = (base.headers["set-cookie"] || [])
      .map((c) => c.split(";")[0])
      .join("; ");

    // Geramos cookies adicionais criados no lado do cliente
    const che_g = crypto.randomUUID();
    const ggru = randomString();

    cookies += `; che_g=${che_g}`;
    cookies += `; ggru=${ggru}`;

    console.log("Cookies:", cookies);

    // ---------------- STEP 2: Criar fingerprint ----------------
    console.log("\nSTEP 2 — Creating fingerprint...");

    const fingerprintTaskId = await createTask({
      type: "CustomTask",
      class: "HUNT",
      websiteURL: BASE_URL + "/",
      userAgent: UA,
      metadata: { apiGetLib: API_GET_LIB },
      proxyType: "http",
      proxyAddress: PROXY_HOST,
      proxyPort: PROXY_PORT,
      proxyLogin: PROXY_USER,
      proxyPassword: PROXY_PASS,
    });

    const xhd = await waitResult(fingerprintTaskId);
    console.log("X-HD:", xhd);

    // ---------------- STEP 3: Enviar requisição para SMS ----------------
    console.log("\nSTEP 3 — Trigger SMS...");

    const smsResp = await gotScraping.post(
      BASE_URL + "/web-api/api/web/registration/v2/sms", // Substitua pelo endpoint atual da API do site
      {
        headers: { ...apiHeaders, cookie: cookies, "x-hd": xhd },
        json: {
          data: { attributes: { phone: PHONE, country_code: COUNTRY_CODE } },
        },
        proxyUrl: PROXY,
        responseType: "json",
      },
    );

    const metaToken = smsResp.body?.meta?.token;
    if (!metaToken) {
      console.log("SMS response:", smsResp.body);
      throw new Error("meta.token not received");
    }

    console.log("meta.token:", metaToken);

    // ---------------- STEP 4: Resolver captcha ----------------
    console.log("\nSTEP 4 — Solving Hunt captcha...");

    const solveTaskId = await createTask({
      type: "CustomTask",
      class: "HUNT",
      websiteURL: BASE_URL + "/",
      userAgent: UA,
      metadata: { apiGetLib: API_GET_LIB, data: metaToken },
      proxyType: "http",
      proxyAddress: PROXY_HOST,
      proxyPort: PROXY_PORT,
      proxyLogin: PROXY_USER,
      proxyPassword: PROXY_PASS,
    });

    const captchaToken = await waitResult(solveTaskId);
    console.log("Captcha token:", captchaToken);

    // ---------------- STEP 5: Requisição final ----------------
    console.log("\nSTEP 5 — Sending final request...");

    const finalResp = await gotScraping.post(
      BASE_URL + "/api/web/registration/v2/sms", // Substitua pelo endpoint atual da API do site
      {
        headers: { ...apiHeaders, cookie: cookies, "x-hd": xhd },
        body: JSON.stringify({
          data: {
            attributes: {
              phone: PHONE,
              country_code: parseInt(COUNTRY_CODE),
              captcha: captchaToken,
            },
          },
        }),
        proxyUrl: PROXY,
      },
    );

    console.log("\nFINAL RESPONSE HEADERS:", finalResp.headers);
    console.log("\nFINAL RESPONSE BODY:", finalResp.body);
  } catch (err) {
    console.error("\nFATAL ERROR:");
    console.error(err);
  }
})();
O artigo foi útil?
Confira os preços do solucionador de CAPTCHA com IA