Menu

El nuevo desafío de código QR de Recaptcha es compatible de forma nativa con Anti-Captcha

El equipo de Anti-Captcha ha confirmado que el nuevo Desafío de Recaptcha con un código QR tiene soporte nativo en nuestro servicio. No es necesario realizar cambios en tu integración: dado que cada captcha en Anti-Captcha lo resuelven personas reales, nuestros trabajadores manejan este nuevo desafío de la misma forma que lo haría un visitante habitual de un sitio web.

El nuevo desafío de código QR de Recaptcha es compatible de forma nativa con Anti-Captcha

Qué es el desafío de código QR de Recaptcha

Google presentó el nuevo desafío en el verano de 2026. Por el momento se está probando en modo cerrado en un conjunto limitado de sitios web, antes de lanzarse a todos los clientes de Recaptcha. En lugar de seleccionar imágenes o marcar una casilla, se muestra al usuario un código QR y se le pide que complete la verificación en su teléfono móvil. El desafío de código QR no está vinculado a una sola versión de Recaptcha: aparece en sitios web que usan tanto Recaptcha V2 como Recaptcha V3.

La idea detrás de esto es sencilla: es relativamente barato que un bot emule un navegador de escritorio, pero es mucho más difícil emular un smartphone físico real con una cámara, un sistema operativo genuino y acceso a las tiendas de aplicaciones oficiales.

Características técnicas

  • Centrado en dispositivos móviles. El desafío no se puede completar dentro del navegador donde se muestra. La verificación se traslada a un dispositivo separado — el smartphone del usuario — y el navegador solo espera la confirmación.
  • Escaneado con la cámara del teléfono. El código QR se escanea con la aplicación de cámara habitual del teléfono. No se necesita ningún escáner de QR de terceros: la cámara reconoce el código y ofrece abrir la verificación.
  • Resuelto por miniaplicaciones de Google Play y la App Store. Escanear el código inicia una miniaplicación ligera distribuida a través de Google Play (Android con Google Play Services 25.41.30) o de la App Store (iOS 15/16+). La miniaplicación se abre al instante sin una instalación completa y realiza la verificación en el dispositivo.
  • Verificación vinculada al dispositivo. El resultado está vinculado a un dispositivo físico real, lo que hace que el desafío sea muy difícil de automatizar con navegadores headless, emuladores o solucionadores basados en IA.

Cómo lo manejan los trabajadores de Anti-Captcha

Realizamos una prueba interna entre los trabajadores de Anti-Captcha: alrededor del 50% de ellos pudo resolver el nuevo desafío de inmediato usando sus propios teléfonos, sin ninguna instrucción o preparación adicional. El resto en su mayoría solo necesitan actualizar su sistema operativo o cambiar a un dispositivo compatible, lo cual es cuestión de tiempo más que un obstáculo real.

Aquí es exactamente donde un servicio impulsado por humanos tiene ventaja sobre los solucionadores automatizados. Una persona con un smartphone común completa el desafío en segundos, mientras que un bot tendría que operar una granja de dispositivos reales para lograr lo mismo.

Qué significa para nuestros clientes

Sigues enviando las tareas de Recaptcha V2 o V3 de la misma manera que lo haces ahora. Cuando un sitio web muestra el desafío de código QR, nuestros trabajadores lo resuelven desde sus teléfonos y tú recibes un token g-recaptcha-response normal en el resultado de la tarea.

Cómo averiguar qué versión de Recaptcha usa un sitio web

Abre la página con el captcha en Chrome, abre la consola de desarrollador (F12, luego la pestaña Console), pega el script de abajo y presiona Enter. Ejecútalo después de que el captcha haya aparecido en la página, por ejemplo, después de hacer clic en el botón de envío del formulario.

(() => {
  const out = { scripts: [], iframes: [], clients: [], verdict: [] };

  // 1. Loaded Recaptcha scripts
  document.querySelectorAll('script[src*="recaptcha"]').forEach(s => {
    const u = new URL(s.src, location.href);
    out.scripts.push({
      src: u.pathname,
      enterprise: u.pathname.includes('enterprise'),
      render: u.searchParams.get('render'),
    });
  });

  // 2. Anchor-iframe
  document.querySelectorAll('iframe[src*="/anchor"]').forEach(f => {
    const u = new URL(f.src);
    out.iframes.push({
      enterprise: u.pathname.includes('/enterprise/'),
      sitekey: u.searchParams.get('k'),
      size: u.searchParams.get('size'),
      action: u.searchParams.get('sa'),
      s: u.searchParams.has('s'),
    });
  });

  // 3. Internal config: look for objects with a sitekey
  const seen = new WeakSet();
  const walk = (o, depth = 0) => {
    if (!o || typeof o !== 'object' || seen.has(o) || depth > 6) return;
    seen.add(o);
    if (typeof o.sitekey === 'string') {
      out.clients.push({
        sitekey: o.sitekey,
        size: o.size,
        action: o.action,
        callback: typeof o.callback === 'function' ? o.callback.name || 'fn'
                 : o.callback || null,
        badge: o.badge,
      });
    }
    for (const k in o) { try { walk(o[k], depth + 1); } catch {} }
  };
  try { walk(window.___grecaptcha_cfg?.clients); } catch {}

  // 4. Verdict
  const renderKey = out.scripts.find(s => s.render && s.render !== 'explicit' && s.render !== 'onload');
  const ent = out.scripts.some(s => s.enterprise) || !!window.grecaptcha?.enterprise;
  if (renderKey) out.verdict.push(`v3/score (render=${renderKey.render})`);
  out.iframes.forEach(i => {
    if (i.size === 'normal' || i.size === 'compact') out.verdict.push(`v2 checkbox (${i.sitekey})`);
    else if (i.size === 'invisible' && (!renderKey || renderKey.render !== i.sitekey))
      out.verdict.push(`v2 invisible (${i.sitekey})`);
  });
  if (ent) out.verdict.push('Enterprise');

  console.table(out.scripts);
  console.table(out.iframes);
  console.table(out.clients);
  console.log('VERDICT:', out.verdict.length ? out.verdict.join(' | ') : 'not found (the captcha may not be loaded yet)');
  return out;
})();

El script muestra los scripts, widgets y sus configuraciones de Recaptcha (sitekey, size, action) como tablas, seguido de una línea VERDICT:

  • v3/score — Recaptcha V3: la sitekey se pasa en el parámetro render del script de Recaptcha.
  • v2 checkbox / v2 invisible — Recaptcha V2 con una casilla de verificación o un widget invisible.
  • Enterprise — el sitio web usa Recaptcha Enterprise (el script enterprise.js).

Usa la sitekey del resultado como la clave del sitio web y el valor de action, si existe, como la acción de la página en los ejemplos de código de abajo.

Ejemplos de código

Elige la versión de Recaptcha encontrada en el sitio web:

Python
Node.js
Go
PHP
Java
Kotlin
C#
C++
Rust
Ruby
bash

Cómo resolver Recaptcha QR en Python

#pip3 install anticaptchaofficial

from anticaptchaofficial.recaptchav2enterpriseproxyless import *

solver = recaptchaV2EnterpriseProxyless()
solver.set_verbose(1)
solver.set_key("YOUR_API_KEY_HERE")
solver.set_website_url("https://website.com")
solver.set_website_key("YOUR_API_KEY_HERE")
# set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
solver.set_is_invisible(True)
# Set page action value:
solver.set_enterprise_payload({"action": "form_submit"})

g_response = solver.solve_and_return_solution()
if g_response != 0:
    print("g-response: "+g_response)
    # user-agent in case you need it:
    print("user-agent: "+solver.get_user_agent())
else:
    print("task finished with error "+solver.error_code)

Cómo resolver Recaptcha QR en Node.js

//npm install @antiadmin/anticaptchaofficial
//https://github.com/anti-captcha/anticaptcha-npm

const ac = require("@antiadmin/anticaptchaofficial");

ac.setAPIKey('YOUR_API_KEY_HERE');

ac.solveRecaptchaV2EnterpriseProxyless(
    'http://DOMAIN.COM',
    'WEBSITE_KEY',
    {
        "action": "form_submit" // set page action value here
    },
    true)  // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
    .then(gresponse => {
        console.log('g-response: '+gresponse);
    })
    .catch(error => console.log('test received error '+error));

// in case you need it
console.log("worker's user-agent:");
console.log(ac.getUserAgent());

Cómo resolver Recaptcha QR en Go

// Install with:
// go get github.com/anti-captcha/anticaptcha-go
package main

import (
    "fmt"
    "github.com/anti-captcha/anticaptcha-go"
    "log"
)

func main() {
    // Create API client and set the API Key
    ac := anticaptcha.NewClient("API_KEY_HERE")

    // set to 'false' to turn off debug output
    ac.IsVerbose = true

    // Make sure the API key funds balance is positive
    balance, err := ac.GetBalance()
    if err != nil {
        log.Fatal(err)
        // Exit program to make sure you don't DDoS API with requests, while having empty balance
        return
    }
    fmt.Println("Balance:", balance)

    // Solve Recaptcha V2 Enterprise without proxy
    solution, err := ac.SolveRecaptchaV2Enterprise(anticaptcha.RecaptchaV2{
        WebsiteURL:  "https://huev.com/",
        WebsiteKey:  "6Lcyu8UZAAAAACwSh6Xf58WrNXTu0LLu4F85xf20",
        IsInvisible: true, // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
        EnterprisePayload:  map[string]interface{}{
            "action": "form_submit", // set page action here
        },
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("Recaptcha Enterprise g-response token:", solution)
}

Cómo resolver Recaptcha QR en PHP

//git clone https://github.com/anti-captcha/anticaptcha-php.git

include("anticaptcha.php");
include("recaptchaV2Enterpriseproxyless.php");

$api = new Recaptchav2enterpriseProxyless();
$api->setVerboseMode(true);

//your anti-captcha.com account key
$api->setKey("YOUR_API_KEY_HERE");

//target website address
$api->setWebsiteURL("http://enteprisedomain.com/recaptcha/test.php");

//recaptcha key from target website
$api->setWebsiteKey("ENTERPRISE_SITEKEY_HERE");

//set page action here
$api->setEnterprisePayload(["action" => "form_submit"]);

//set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
$api->setIsInvisible();

//create task in API
if (!$api->createTask()) {
    $api->debout("API v2 send failed - ".$api->getErrorMessage(), "red");
    return false;
}

$taskId = $api->getTaskId();

//wait in a loop for max 300 seconds till task is solved
if (!$api->waitForResult(300)) {
    echo "could not solve captcha\n";
    echo $api->getErrorMessage()."\n";
} else {

    $gResponse    =   $api->getTaskSolution();
    echo "\your recaptcha token: $gResponse\n\n";
    echo "worker's user-agent in case you need it:\n";
    echo $api->getWorkersUserAgent()."\n";

}

Cómo resolver Recaptcha QR en Java

// GitHub: https://github.com/anti-captcha/anticaptcha-java
//
// Maven, add to pom.xml:
//   <dependency>
//     <groupId>com.anti-captcha</groupId>
//     <artifactId>anticaptcha</artifactId>
//     <version>1.0.0</version>
//   </dependency>
//
// Gradle, add to build.gradle:
//   implementation "com.anti-captcha:anticaptcha:1.0.0"

import com.anti_captcha.Api.RecaptchaV2EnterpriseProxyless;
import com.anti_captcha.Helper.DebugHelper;
import org.json.JSONObject;

public class Main {

    public static void main(String[] args) throws InterruptedException {
        // Set to false to turn the debug output off
        DebugHelper.setVerboseMode(true);

        RecaptchaV2EnterpriseProxyless api = new RecaptchaV2EnterpriseProxyless();
        api.setClientKey("YOUR_API_KEY_HERE");

        api.setWebsiteUrl("http://makeawebsitehub.com/recaptcha/test.php");
        api.setWebsiteKey("6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ");

        // Set page action here:
        api.setEnterprisePayload(new JSONObject()
                .put("action", "form_submit"));

        // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
        api.setIsInvisible(true);

        // Make sure the API key funds balance is positive
        Double balance = api.getBalance();
        if (balance == null || balance <= 0) {
            // Stop here to make sure you don't DDoS the API while having empty balance
            DebugHelper.out("Balance error: " + api.getErrorMessage(), DebugHelper.Type.ERROR);
            return;
        }
        DebugHelper.out("Balance: " + balance, DebugHelper.Type.SUCCESS);

        if (!api.createTask()) {
            DebugHelper.out("API v2 send failed. " + api.getErrorMessage(), DebugHelper.Type.ERROR);
        } else if (!api.waitForResult()) {
            DebugHelper.out("Could not solve the captcha.", DebugHelper.Type.ERROR);
        } else {
            DebugHelper.out("Recaptcha g-response token: " + api.getTaskSolution().getGRecaptchaResponse(), DebugHelper.Type.SUCCESS);
            DebugHelper.out("Worker's user-agent in case you need it: " + api.getTaskSolution().getUserAgent(), DebugHelper.Type.SUCCESS);
        }
    }
}

Cómo resolver Recaptcha QR en Kotlin

// GitHub: https://github.com/anti-captcha/anticaptcha-kotlin
//
// Gradle, add to build.gradle.kts:
//   implementation("com.anti-captcha:anticaptcha-kotlin:1.0.0")

import com.anticaptcha.AnticaptchaClient
import com.anticaptcha.AnticaptchaException
import com.anticaptcha.ApiException
import com.anticaptcha.RecaptchaV2
import kotlinx.coroutines.runBlocking

fun main(): Unit = runBlocking {
    // Create the API client and set the API key
    val ac = AnticaptchaClient(
        apiKey = "YOUR_API_KEY_HERE",
        // Specify softId to earn 10% commission with your app.
        // Get your softId here: https://anti-captcha.com/clients/tools/devcenter
        softId = 0,
        // Set to false to turn the debug output off
        verbose = true,
    )

    try {
        // Make sure the API key funds balance is positive
        val balance = ac.getBalance()
        if (balance <= 0) {
            // Stop here to make sure you don't DDoS the API while having empty balance
            System.err.println("Empty balance")
            return@runBlocking
        }
        println("Balance: $balance")

        val solution = ac.solveRecaptchaV2(
            RecaptchaV2(
                websiteUrl = "http://makeawebsitehub.com/recaptcha/test.php",
                websiteKey = "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ",
                isEnterprise = true,
                // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
                isInvisible = true,
                // Set page action here
                enterprisePayload = mapOf(
                    "action" to "form_submit",
                ),
            ),
        )

        println("Recaptcha g-response token: ${solution.gRecaptchaResponse}")
        println("Worker's user-agent in case you need it: ${solution.userAgent}")
    } catch (error: ApiException) {
        // https://anti-captcha.com/apidoc/errors
        System.err.println("API error: ${error.errorCode} ${error.description}")
    } catch (error: AnticaptchaException) {
        System.err.println("Failed: ${error.message}")
    }
}

Cómo resolver Recaptcha QR en C#

// GitHub: https://github.com/anti-captcha/anticaptcha-csharp.git
// install:  dotnet add package AntiCaptchaOfficial
// or, in the Package Manager Console:
// Install-Package AntiCaptchaOfficial

using System;
using AntiCaptcha.Api;
using AntiCaptcha.Helper;


class Program
{
    static void Main()
    {
        // Set to 'false' to turn off debug output
        DebugHelper.VerboseMode = true;

        var api = new RecaptchaV2EnterpriseProxyless
        {
            ClientKey = "YOUR_API_KEY_HERE",
            WebsiteUrl = new Uri("http://makeawebsitehub.com/recaptcha/test.php"),
            WebsiteKey = "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ",
            IsInvisible = true  // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
        };

        // set page action here
        api.EnterprisePayload.Add("action", "form_submit");

        // Make sure the API key funds balance is positive
        var balance = api.GetBalance();
        if (balance == null || balance <= 0)
        {
            // Exit the program to make sure you don't DDoS the API with requests while having empty balance
            Console.WriteLine("Balance error: " + api.ErrorMessage);
            return;
        }
        Console.WriteLine("Balance: " + balance);

        var solution = api.Solve();
        Console.WriteLine("Recaptcha g-response token: " + solution?.GRecaptchaResponse);
        Console.WriteLine("Worker's user-agent in case you need it: " + solution?.UserAgent);
    }
}

Cómo resolver Recaptcha QR en C++

// GitHub: https://github.com/anti-captcha/anticaptcha-cplus.git
// Add it to your CMake project:
//   include(FetchContent)
//   FetchContent_Declare(anticaptcha
//           GIT_REPOSITORY https://github.com/anti-captcha/anticaptcha-cplus.git
//           GIT_TAG v1.1.0)
//   FetchContent_MakeAvailable(anticaptcha)
//   target_link_libraries(your_app PRIVATE anticaptcha::anticaptcha)

#include <iostream>
#include <anticaptcha/anticaptcha.hpp>

int main() {
    // Create the API client and set the API key
    anticaptcha::Client ac("YOUR_API_KEY_HERE");

    // Debug output is on by default, turn it off with:
    // ac.shut_up();

    // Specify softId to earn 10% commission with your app.
    // Get your softId here: https://anti-captcha.com/clients/tools/devcenter
    ac.set_soft_id(0);

    try {
        // Make sure the API key funds balance is positive
        const double balance = ac.get_balance();
        if (balance <= 0) {
            // Stop here to make sure you don't DDoS the API while having empty balance
            std::cerr << "Empty balance" << std::endl;
            return 1;
        }
        std::cout << "Balance: " << balance << std::endl;

        anticaptcha::RecaptchaV2 params;
        params.website_url = "http://makeawebsitehub.com/recaptcha/test.php";
        params.website_key = "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ";
        params.is_enterprise = true;
        // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
        params.is_invisible = true;
        // Set page action here
        params.enterprise_payload = { {"action", "form_submit"} };
        // params.api_domain = "recaptcha.net"; // only for a non-google.com script domain

        const anticaptcha::Solution solution = ac.solve_recaptcha_v2(params);
        std::cout << "Recaptcha g-response token: " << solution.g_recaptcha_response() << std::endl;
        std::cout << "Worker's user-agent in case you need it: " << solution.user_agent() << std::endl;
    } catch (const anticaptcha::ApiError& error) {
        // https://anti-captcha.com/apidoc/errors
        std::cerr << "API error: " << error.error_code() << " " << error.description() << std::endl;
        return 1;
    } catch (const anticaptcha::Error& error) {
        std::cerr << "Failed: " << error.what() << std::endl;
        return 1;
    }

    return 0;
}

Cómo resolver Recaptcha QR en Rust

// GitHub: https://github.com/anti-captcha/anticaptcha-rust
// Install with:
//   cargo add anticaptchaofficial
// or add it to Cargo.toml:
//   [dependencies]
//   anticaptchaofficial = "1"

use std::collections::BTreeMap;
use anticaptcha::{Client, RecaptchaV2};

#[tokio::main]
async fn main() -> anticaptcha::Result<()> {
    // Create the API client and set the API key
    let ac = Client::new("YOUR_API_KEY_HERE")
        // Specify softId to earn 10% commission with your app.
        // Get your softId here: https://anti-captcha.com/clients/tools/devcenter
        .with_soft_id(0);
    // .quiet() turns the debug output off

    // Make sure the API key funds balance is positive
    let balance = ac.get_balance().await?;
    if balance <= 0.0 {
        // Stop here to make sure you don't DDoS the API while having empty balance
        eprintln!("Empty balance");
        return Ok(());
    }
    println!("Balance: {balance}");

    // set page action here
    let mut enterprise_payload = BTreeMap::new();
    enterprise_payload.insert("action".to_owned(), "form_submit".to_owned());

    let solution = ac
        .solve_recaptcha_v2(&RecaptchaV2 {
            website_url: "http://makeawebsitehub.com/recaptcha/test.php".into(),
            website_key: "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ".into(),
            is_enterprise: true,
            is_invisible: true, // set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
            // Additional parameters passed to the grecaptcha.enterprise.render call
            enterprise_payload,
            // api_domain: "recaptcha.net".into(), // only for a non-google.com script domain
            ..Default::default()
        })
        .await?;

    println!("Recaptcha g-response token: {}", solution.g_recaptcha_response());
    println!("Worker's user-agent in case you need it: {}", solution.user_agent());

    Ok(())
}

Cómo resolver Recaptcha QR en Ruby

# GitHub: https://github.com/anti-captcha/anticaptcha-ruby
# Install with:
#   gem install anticaptchaofficial
# or add it to your Gemfile:
#   gem "anticaptchaofficial"

require "anticaptcha"

# Create the API client and set the API key
ac = Anticaptcha.new("YOUR_API_KEY_HERE")

# Specify softId to earn 10% commission with your app.
# Get your softId here: https://anti-captcha.com/clients/tools/devcenter
ac.soft_id = 0

# Set to false to turn the debug output off
ac.verbose = true

begin
  # Make sure the API key funds balance is positive
  balance = ac.balance
  # Stop here to make sure you don't DDoS the API while having empty balance
  abort "Empty balance" if balance <= 0
  puts "Balance: #{balance}"

  solution = ac.solve_recaptcha_v2(
    website_url: "http://makeawebsitehub.com/recaptcha/test.php",
    website_key: "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ",
    is_enterprise: true,
    # set to "true" if there's "size":"invisible" option in "grecaptcha.enterprise.render" function
    # is_invisible: true,
    # Set page action here
    enterprise_payload: { "action" => "form_submit" }
    # api_domain: "recaptcha.net", # only for a non-google.com script domain
  )

  puts "Recaptcha g-response token: #{solution.g_recaptcha_response}"
  puts "Worker's user-agent in case you need it: #{solution.user_agent}"
rescue Anticaptcha::ApiError => e
  # https://anti-captcha.com/apidoc/errors
  warn "API error: #{e.error_code} #{e.description}"
rescue Anticaptcha::Error => e
  warn "Failed: #{e.message}"
end

Cómo resolver Recaptcha QR en bash

curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY_HERE",
    "task":
        {
            "type":"RecaptchaV2EnterpriseTaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "enterprisePayload": {
                "action": "form_submit"
            },
            "isInvisible": true
        },
    "softId": 0
}' https://api.anti-captcha.com/createTask