ComplexImageTask Recaptcha

O objeto contém dados sobre a tarefa para resolver o ReCaptcha2 do Google.

Parâmetros da solicitação

type<string>required

ComplexImageTask

class<string>required

recaptcha

imageUrls<array>required (se imagesBase64 não estiver preenchido)

Imagem única 4x4, 3x3 ou uma nova parte de captcha 1x1 (em um array). Exemplo: [“https://i.postimg.cc/yYjg75Kv/img1.jpg”]\

imagesBase64<array>required (se imageUrls não estiver preenchido)

Imagem única 4x4, 3x3 ou uma nova parte de captcha 1x1 no formato base64 (em um array). Exemplo: [ “/9j/4AAQSkZJRgABAQEAAAAAAAD…”]

Grid (dentro da metadata)<string>required

Tamanho da grade de imagem. Valores possíveis: 4x4, 3x3, 1x1

TaskDefinition (dentro da metadata)<string>required (se Task não estiver preenchido)

Valor técnico que define o tipo de tarefa

Como obter TaskDefinition

Os dados podem ser encontrados nas respostas das solicitações /recaptcha/{recaptchaApi}/reload ou /recaptcha/{recaptchaApi}/userverify, onde recaptchaApi é "enterprise" ou "api2" dependendo do tipo de Recaptcha. A resposta contém json, onde pode-se obter uma lista de TaskDefinitions para captchas carregados.

Task (dentro da metadata)<string>required (se TaskDefinition não estiver preenchido)

Valores possíveis: Click on traffic lights e outros
Nome da tarefa (em inglês).

userAgent<string>optional

O User-Agent do navegador a ser utilizado ao carregar imagens, se os links foram passados em imageUrls. É necessário usar uma assinatura de navegador moderna, caso contrário o Google retornará um erro pedindo para atualizar o navegador.

websiteURL<string>optional

URL da página onde o captcha está sendo resolvido.

Descrição dos parâmetros

imageUrls: links para imagens.

imagesBase64: imagens no formato Base64.

Grid (dentro da metadata): metadata adicionais relacionados aos tamanhos da grade de imagens.

TaskDefinition (dentro da metadata): identificador/tipo da descrição da tarefa, por exemplo: /m/015qff significa "Click on traffic lights".

Task (dentro da metadata): metadata adicionais relacionados à tarefa.

userAgent: informações sobre o agente do usuário. Atual userAgent: userAgentPlaceholder

websiteURL: endereço da página da web com o captcha.

Criar tarefa

POST

https://api.capmonster.cloud/createTask

Solicitação

{
  "clientKey":"API_KEY",
  "task": {
    "type": "ComplexImageTask",
    "class": "recaptcha",
    "imageUrls":[ "https://i.postimg.cc/yYjg75Kv/payloadtraffic.jpg" ],
    "metadata": {
      "Task": "Click on traffic lights",
      "Grid": "3x3",
      "TaskDefinition": "/m/015qff"
    },
    "userAgent": "userAgentPlaceholder",
    "websiteUrl": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=middle"
  }
}

Resposta

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

Obter resultado da tarefa

Use o método getTaskResult para obter a solução do captcha. Dependendo da carga do sistema, você receberá uma resposta em um intervalo de tempo de 300ms a 6s.

POST

https://api.capmonster.cloud/getTaskResult

Solicitação

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

Resposta

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "answer": [ false, false, false, false, true, false, false, false, false ]
  }
}

Propriedade	Tipo	Descrição
answer	Array	Lista com valores booleanos, "true" significa que você precisa clicar na imagem correspondente a essa posição.

Como Encontrar Todos os Parâmetros Necessários para a Criação da Tarefa

Manualmente

Abra seu site onde o captcha aparece no navegador.
Clique com o botão direito no elemento do captcha e selecione Inspecionar.

websitekey:

O processo é semelhante a encontrar o websitekey para ReCaptchaV2Task e ReCaptchaV2Enterprise.

imageUrls:

Encontre a URL nos atributos do elemento:

imgUrl

Você também pode obter a URL completa da imagem clicando com o botão direito na imagem e selecionando Abrir imagem em uma nova guia. Em seguida, copie a URL diretamente da barra de endereços do navegador.

imgUrl1

Task (dentro da metadata)

Descrição da tarefa. Clique com o botão direito no texto da tarefa e, nas Ferramentas do Desenvolvedor, encontre o elemento correspondente na estrutura da página:

metadata

Automaticamente

Uma forma conveniente de automatizar a busca por todos os parâmetros necessários.
Alguns parâmetros são regenerados a cada carregamento da página, então você precisará extraí-los através de um navegador — seja normal ou headless (por exemplo, usando Playwright).
Como os valores dos parâmetros dinâmicos são de curta duração, o captcha deve ser resolvido imediatamente após a captura deles.

Importante!

Os trechos de código fornecidos são exemplos básicos para familiarização com a extração dos parâmetros necessários. A implementação exata dependerá da sua página de captcha, sua estrutura e dos elementos/seletores HTML que ela utiliza.

JavaScript
Python
C#

Mostrar código (para navegador)

const img = document.querySelector('img.rc-image-tile-33') || document.querySelector('img.rc-image-tile-44');
const src = img ? img.src : null;
console.log(src);

// Descrição da tarefa
const descEl =
  document.querySelector('.rc-imageselect-desc-no-canonical') ||
  document.querySelector('.rc-imageselect-desc');

const taskDescription = descEl
  ? descEl.textContent.trim()
  : 'Descrição da tarefa não encontrada';

console.log(taskDescription);

// Número de blocos visíveis
const tiles = document.querySelectorAll('.rc-imageselect-tile');
const visibleTiles = Array.from(tiles).filter(tile => tile.offsetParent !== null);

const tileCount = visibleTiles.length;

let gridSize;
if (tileCount === 9) {
  gridSize = '3x3';
} else if (tileCount === 16) {
  gridSize = '4x4';
} else if (tileCount === 25) {
  gridSize = '5x5';
} else {
  gridSize = 'Desconhecido';
}

console.log(`Tamanho da grade: ${gridSize}`);

Mostrar código (Node.js)

import { chromium } from "playwright";

async function extractCaptchaInfo() {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();

  const url =
    "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high";
  await page.goto(url);

  const frames = page.frames();
  const checkboxFrame = frames.find((f) => f.url().includes("api2/anchor"));

  if (!checkboxFrame) {
    console.error("Iframe de checkbox para reCAPTCHA não encontrado");
    await browser.close();
    return;
  }

  const checkbox = await checkboxFrame.waitForSelector("#recaptcha-anchor", {
    timeout: 5000,
  });
  await checkbox.click();

  await page.waitForTimeout(1000);
  const updatedFrames = page.frames();
  const challengeFrame = updatedFrames.find((f) =>
    f.url().includes("api2/bframe")
  );

  if (!challengeFrame) {
    console.error("Iframe de desafio para reCAPTCHA não encontrado");
    await browser.close();
    return;
  }

  // Imagem
  const img =
    (await challengeFrame.$("img.rc-image-tile-33")) ||
    (await challengeFrame.$("img.rc-image-tile-44"));
  const src = img ? await img.getAttribute("src") : null;
  console.log("Imagem:", src);

  // Tarefa
  try {
    await challengeFrame.waitForSelector(
      ".rc-imageselect-desc-no-canonical, .rc-imageselect-desc",
      {
        timeout: 5000,
      }
    );
    const taskDescription = await challengeFrame.$eval(
      ".rc-imageselect-desc-no-canonical, .rc-imageselect-desc",
      (el) => {
        const strong = el.querySelector("strong");
        const text = strong ? strong.textContent.trim() : "Não encontrado";
        return text;
      }
    );
    console.log("Tarefa: selecione todas as imagens com:", taskDescription);
  } catch (error) {
    console.log("Descrição da tarefa não encontrada.");
  }

  // Tamanho da grade
  const tiles = await challengeFrame.$$(".rc-imageselect-tile");
  const visibleTiles = await Promise.all(tiles.map((tile) => tile.isVisible()));
  const tileCount = visibleTiles.filter(Boolean).length;

  let gridSize;
  if (tileCount === 9) {
    gridSize = "3x3";
  } else if (tileCount === 16) {
    gridSize = "4x4";
  } else if (tileCount === 25) {
    gridSize = "5x5";
  } else {
    gridSize = "Desconhecido";
  }

  console.log(`Tamanho da grade: ${gridSize}`);

  await browser.close();
}

extractCaptchaInfo();

Mostrar código

import asyncio
from playwright.async_api import async_playwright

async def extract_captcha_info():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        page = await browser.new_page()

        await page.goto("https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high")

        # Encontrar o iframe do checkbox
        checkbox_frame = next((f for f in page.frames if "api2/anchor" in f.url), None)
        if not checkbox_frame:
            print("Iframe de checkbox para reCAPTCHA não encontrado")
            await browser.close()
            return

        checkbox = await checkbox_frame.wait_for_selector("#recaptcha-anchor", timeout=5000)
        await checkbox.click()

        await page.wait_for_timeout(1000)

        # Encontrar o iframe de desafio
        challenge_frame = next((f for f in page.frames if "api2/bframe" in f.url), None)
        if not challenge_frame:
            print("Iframe de desafio para reCAPTCHA não encontrado")
            await browser.close()
            return

        # Imagem: procurar por classes rc-image-tile-33 ou rc-image-tile-44
        img = await challenge_frame.query_selector("img.rc-image-tile-33") or await challenge_frame.query_selector("img.rc-image-tile-44")
        src = await img.get_attribute("src") if img else None
        print("Imagem:", src)

        # Tarefa
        try:
            await challenge_frame.wait_for_selector(".rc-imageselect-desc-no-canonical, .rc-imageselect-desc", timeout=5000)
            task_text = await challenge_frame.eval_on_selector(
                ".rc-imageselect-desc-no-canonical, .rc-imageselect-desc",
                "el => el.querySelector('strong')?.textContent?.trim() || 'Não encontrado'"
            )
            print("Tarefa: selecione todas as imagens com:", task_text)
        except:
            print("Descrição da tarefa não encontrada.")

        # Tamanho da grade
        tiles = await challenge_frame.query_selector_all(".rc-imageselect-tile")
        visible_count = 0
        for tile in tiles:
            if await tile.is_visible():
                visible_count += 1

        if visible_count == 9:
            grid = "3x3"
        elif visible_count == 16:
            grid = "4x4"
        elif visible_count == 25:
            grid = "5x5"
        else:
            grid = "Desconhecido"

        print("Tamanho da grade:", grid)
        await browser.close()

asyncio.run(extract_captcha_info())

Mostrar código

using System;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.Playwright;

class Program
{
    public static async Task Main()
    {
        using var playwright = await Playwright.CreateAsync();
        var browser = await playwright.Chromium.LaunchAsync(new() { Headless = false });
        var page = await browser.NewPageAsync();

        await page.GotoAsync("https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high");

        var checkboxFrame = page.Frames.FirstOrDefault(f => f.Url.Contains("api2/anchor"));
        if (checkboxFrame == null)
        {
            Console.WriteLine("Iframe de checkbox para reCAPTCHA não encontrado");
            await browser.CloseAsync();
            return;
        }

        var checkbox = await checkboxFrame.WaitForSelectorAsync("#recaptcha-anchor");
        await checkbox.ClickAsync();

        await page.WaitForTimeoutAsync(1000);

        var challengeFrame = page.Frames.FirstOrDefault(f => f.Url.Contains("api2/bframe"));
        if (challengeFrame == null)
        {
            Console.WriteLine("Iframe de desafio para reCAPTCHA não encontrado");
            await browser.CloseAsync();
            return;
        }

        // Procurar imagem com classes rc-image-tile-33 ou rc-image-tile-44
        var img = await challengeFrame.QuerySelectorAsync("img.rc-image-tile-33") ?? await challengeFrame.QuerySelectorAsync("img.rc-image-tile-44");
        var src = img != null ? await img.GetAttributeAsync("src") : null;
        Console.WriteLine("Imagem: " + src);

        try
        {
            await challengeFrame.WaitForSelectorAsync(".rc-imageselect-desc-no-canonical, .rc-imageselect-desc");
            var taskText = await challengeFrame.EvalOnSelectorAsync<string>(
                ".rc-imageselect-desc-no-canonical, .rc-imageselect-desc",
                @"el => {
                    const strong = el.querySelector('strong');
                    return strong ? strong.textContent.trim() : 'Não encontrado';
                }");
            Console.WriteLine("Tarefa: selecione todas as imagens com: " + taskText);
        }
        catch
        {
            Console.WriteLine("Descrição da tarefa não encontrada.");
        }

        var tiles = await challengeFrame.QuerySelectorAllAsync(".rc-imageselect-tile");
        int visibleCount = 0;
        foreach (var tile in tiles)
        {
            if (await tile.IsVisibleAsync())
                visibleCount++;
        }

        string gridSize = visibleCount switch
        {
            9 => "3x3",
            16 => "4x4",
            25 => "5x5",
            _ => "Desconhecido"
        };

        Console.WriteLine("Tamanho da grade: " + gridSize);
        await browser.CloseAsync();
    }
}

Usar biblioteca SDK

JavaScript
Python
C#

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

import { CapMonsterCloudClientFactory, ClientOptions, ComplexImageRecaptchaRequest } 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 complexImageRecaptchaRequest = new ComplexImageRecaptchaRequest({
    imageUrls: ['https://i.postimg.cc/yYjg75Kv/payloadtraffic.jpg'],
    metaData: {
      Grid: '3x3',
      Task: 'Please click each image containing a mountain',
      TaskDefinition: '/m/015qff',
    },
    websiteURL: 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=middle',
  });

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

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

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

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

complex_image_recaptcha_request = RecaptchaComplexImageTaskRequest(
    imagesUrls=["https://i.postimg.cc/yYjg75Kv/payloadtraffic.jpg"],  # Replace with your values
    metadata={
        "Task": "Click on traffic lights",
        "Grid": "3x3",
        "TaskDefinition": "/m/015qff",
        "websiteUrl": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=middle",  # Website with the captcha
    }
)

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

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

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

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 complexImageRecaptchaRequest = new RecaptchaComplexImageTaskRequest
        {
            ImageUrls = new[] { "https://i.postimg.cc/yYjg75Kv/payloadtraffic.jpg" }, // Replace with your image URL
            Metadata = new RecaptchaComplexImageTaskRequest.RecaptchaMetadata
            {
                Task = "Click on traffic lights", // Task description
                Grid = RecaptchaComplexImageTaskRequest.RecaptchaMetadata.GridSize.Grid3x3, // Set the grid size
                TaskDefinition = "/m/015qff", // Task definition
            }
        };

        var complexImageRecaptchaResult = await cmCloudClient.SolveAsync(complexImageRecaptchaRequest);

        Console.WriteLine("Captcha Solution: " + string.Join(", ", complexImageRecaptchaResult.Solution.Answer));
    }
}

ComplexImageTask Recaptcha

Parâmetros da solicitação​

Descrição dos parâmetros​

Criar tarefa​

Obter resultado da tarefa​

Como Encontrar Todos os Parâmetros Necessários para a Criação da Tarefa​

Manualmente​

websitekey:​

imageUrls:​

Task (dentro da metadata)​

Automaticamente​

Usar biblioteca SDK​