Saltar al contenido

Desafíos

Los navegadores alojados se encargan por sí solos de los desafíos de deslizador, de casilla y de mantener pulsado. El servicio de resolución de desafíos, desactivado salvo que lo actives, atiende los que ellos no pueden.

Desafíos de deslizador

Algunos sitios responden con un desafío de tipo «desliza para verificar»: un control que hay que arrastrar hasta el final de una barra, o una pieza de rompecabezas que hay que arrastrar hasta su hueco. Un navegador alojado se encarga de ellos por ti, en cualquier pestaña y también dentro de frames. Está activado por defecto; pasa solveSliders: false cuando tu script se ocupe de ellos.

  • Qué hace. Un deslizador simple se arrastra hasta el final. Un rompecabezas se arrastra hasta que la pieza encaja en su hueco: el navegador encuentra el hueco en la imagen, comprueba dónde quedó realmente la pieza y corrige. El arrastre es un movimiento del ratón con el botón pulsado y a ritmo humano, no un salto.
  • Cuándo se contiene. Si no encuentra el hueco con seguridad, deja el rompecabezas sin tocar en lugar de adivinar, porque un arrastre equivocado puede contar en contra de la sesión. Lo intenta como máximo tres veces por página, y espera mientras alguien controla la sesión desde la vista en vivo o durante un traspaso.
  • Qué ves. Cada intento es un evento slider en la línea de tiempo de eventos de la sesión, que indica si el desafío desapareció después (passed) o no (failed), o por qué se dejó un rompecabezas sin tocar (skipped).
  • Solo se tocan desafíos: un deslizador cuenta como tal cuando la página o el widget que lo rodea lo indica (un captcha o una comprobación de verificación). Los inputs de rango, los carruseles y los filtros de precio no se tocan. La entrada de ratón de tu propio script y un arrastre en curso pueden mezclarse, así que pausa los clics mientras haya un desafío en pantalla, o desactiva la opción.

Desafíos de casilla

Algunos sitios piden primero marcar una casilla de «verifica que eres humano». Un navegador alojado la marca por ti, en cualquier pestaña y también dentro de frames, incluidos los widgets que ocultan la casilla a los scripts de la página. Es una opción aparte de la de los deslizadores, también activada por defecto; pasa solveCheckboxes: false para encargarte tú de estas casillas.

  • Qué casillas. Solo una casilla cuyo propio texto indica que es una comprobación humana (humano, robot, captcha, verifica que eres…). Una casilla de «recordarme» o «acepto los términos» nunca se marca, diga lo que diga el resto de la página.
  • El clic. Un movimiento del puntero a ritmo humano hasta la casilla, una breve pausa y una pulsación tan larga como la de una persona. Si la casilla abre después un deslizador, se trata como un deslizador.
  • Qué ves. Cada intento es un evento checkbox en la línea de tiempo de eventos de la sesión: passed cuando la casilla desapareció o quedó marcada, failed cuando seguía esperando. Como máximo tres intentos por página, y ninguno mientras alguien controla la sesión desde la vista en vivo o durante un traspaso.

Desafíos de mantener pulsado

Algunos sitios muestran un botón de verificación de «mantener pulsado»: la comprobación se supera cuando el botón ha estado pulsado el tiempo suficiente. Un navegador alojado lo pulsa y lo mantiene por ti, en cualquier pestaña y dentro de frames, incluidos frames de otro sitio y widgets que ocultan el botón a los scripts de la página. Es una opción propia, separada de los deslizadores y las casillas y también activada por defecto; pasa solvePressHold: false para dejar estos botones a tu script, por ejemplo con mantener pulsado. Un navegador que ejecutas tú mismo nunca lo hace por su cuenta.

  • La pulsación. Un movimiento del puntero a ritmo humano hasta el botón, una pausa breve y luego una pulsación que se mantiene hasta que el botón indica que ha terminado, y una liberación tras un retardo humano.
  • Qué ves. Cada intento es un evento pressHold en la línea de tiempo de eventos de la sesión: passed cuando el botón indicó que había terminado, failed cuando no (una pulsación que se quedó sin tiempo tiene el motivo timeout), o skipped con un motivo.
  • En qué orden. Primero los deslizadores, luego las casillas y después los botones de mantener pulsado. Cada uno tiene su propio interruptor, así que desactivar uno deja los demás activos.

Servicio de resolución de desafíos

Para los sitios que siguen presentando desafíos después de las acciones gratuitas de deslizador y de casilla, un navegador alojado puede pasar los desafíos más difíciles a un servicio de resolución. Está desactivado salvo que lo pidas: pasa challengeService: true para que elija por sí solo, o un objeto para elegir qué puede hacer. Usa tu propia clave del servicio de resolución, o la nuestra (se cobra por desafío resuelto, consulta lo que cuesta).

Elegir de qué desafíos se encarga

Nunca le indicas qué widget ni qué proveedor usa un sitio. El navegador alojado reconoce por sí mismo cada desafío de la página, por su marcado, sus frames y su comportamiento, y lo clasifica en una de cinco categorías. Tú eliges categorías, no widgets.

CategoríaQué cuenta como talEn auto
tokenUn widget que le entrega un token a la página: una casilla de «No soy un robot» que se convierte en un rompecabezas de imágenes, un widget invisible cuyo rompecabezas aparece, una comprobación interactiva del tipo «verifica que eres humano» que sigue sin respuesta.Sí
clearanceUna espera de página completa del tipo «comprobando tu navegador» que no se resuelve sola.Sí
block-pageLa página de bloqueo de un sitio con un rompecabezas o una comprobación del dispositivo.Sí
imageUn código de texto distorsionado junto a un cuadro de texto, y un rompecabezas cuyo hueco el navegador no pudo ubicar por sí mismo.Sí
scoreUna comprobación de puntuación invisible que la propia página ejecuta.No: inclúyela tú en la lista
  • Selección automática. challengeService: true, o un objeto sin categories (o con categories: "auto"): se atiende cada desafío que reconozca en token, clearance, block-page e image, en todos los sitios. score queda fuera porque el navegador ya obtiene su propio token de puntuación: responderlo desde otro lugar cuesta una resolución en cada llamada, así que solo vale la pena para un sitio que rechace las puntuaciones de tus sesiones.
  • Elige categorías. categories: ["token", "image"] atiende solo esas. Un desafío de otra categoría se sigue reportando en la línea de tiempo (como category_off), pero nunca se paga.
  • Elige sitios. sites: ["shop.example"] lo limita a esos hosts y sus subdominios; en los demás no se reporta ni se pide nada. Combínalo con categories para «este tipo de desafío en ese sitio».
  • ¿No sabes qué usa un sitio? Ejecútalo una vez con mode: "report": no se pide ni se paga nada, y la línea de tiempo lista cada desafío que mostraron las páginas como challenge.detected, con su category y si se puede resolver. Luego activa exactamente esas categorías para ese sitio.
javascript
// In the body of POST /api/v1/browsers, or in the SDK's launch options (cloud: true)

// Auto-select: every challenge it recognises (all categories but score), on every site
challengeService: true

// Only widgets that hand out a token, only on one site, at most EUR 0.20 per session
challengeService: { categories: ["token"], sites: ["shop.example"], maxSpendEur: 0.2 }

// Only full-page waits and block pages, with your own solving-service key
challengeService: { categories: ["clearance", "block-page"], key: "own" }

// Auto-select plus the score check, on one site
challengeService: { categories: ["token", "clearance", "block-page", "image", "score"], sites: ["shop.example"] }

// First find out what a site uses: report only, nothing asked or paid for
challengeService: { mode: "report" }

Todos los campos

CampoTipoPor defectoSignificado
categories"auto" o una lista de token, score, clearance, block-page, image"auto"Qué tipos de desafío se pueden responder. auto incluye todos menos score.
siteslista de nombres de hosttodos los sitiosSolo en estos hosts y sus subdominios (como máximo 50).
key"own" o "managed"tu clave guardada si tienes una; si no, la nuestraDe quién es la clave del servicio de resolución: la tuya o la nuestra (se cobra por desafío resuelto).
apiKeystringningunoTu clave del servicio de resolución, solo para esta sesión (se guarda cifrada y nunca se vuelve a mostrar). Implica key: "own".
mode"solve" o "report""solve"report solo reconoce y reporta; no se pide ni se paga nada, y no hace falta ninguna clave.
maxSolvesnúmero entero, de 1 a 10010Solicitudes por sesión; las solicitudes se detienen al llegar a esta cantidad.
maxSpendEurnúmero, de 0.01 a 1000.50Lo que una sesión puede gastar en resoluciones (con nuestra clave, lo que pagas tú); las solicitudes se detienen ahí.

Cómo funciona

  • Primero lo gratuito. Las acciones de deslizador y de casilla siempre van primero. Solo se recurre al servicio cuando un desafío sigue ahí después de haber tenido una oportunidad razonable: apareció un rompecabezas de imágenes, un widget invisible abrió su rompecabezas, un widget quedó sin responder durante unos 15 a 25 segundos, una espera de página completa no se resolvió en unos 20 segundos, o la página es una página de bloqueo o un código de texto.
  • Cómo se introduce la respuesta. Como la página lo espera: un token en el campo de respuesta del widget y su callback, una cookie para el sitio y una recarga, un código escrito en su cuadro, una pieza de rompecabezas arrastrada a su lugar. Después comprueba que el desafío desapareció, igual que las acciones gratuitas.
  • La misma IP. Las esperas de página completa y las páginas de bloqueo deben resolverse desde la IP que usa la respuesta: el servicio las resuelve a través de la propia IP de salida de tu sesión, mediante una conexión de corta duración y de un solo uso. Si un sitio rechaza un token, se pide una vez más de la misma forma.
  • Tu clave o la nuestra. key: "own" usa tu clave del servicio de resolución: guárdala una vez en el panel (Settings), o pasa apiKey con la solicitud. Se guarda cifrada, nunca se vuelve a mostrar y nunca llega al navegador; le pagas al servicio directamente. key: "managed" usa la nuestra: cada desafío resuelto se cobra de tu saldo de navegadores alojados al precio propio del servicio × 1.5; los intentos fallidos son gratis (consulta lo que cuesta). Omite key para usar tu clave guardada si tienes una, o la nuestra si no.
  • Límites. Como máximo 2 solicitudes por desafío y por página. Por sesión, maxSolves (10 por defecto, como máximo 100) y maxSpendEur (€0.50 por defecto): las solicitudes se detienen al llegar a cualquiera de los dos. Con nuestra clave, además, un tope mensual por cuenta (configúralo en el panel, como máximo €25). Una clave incorrecta o un saldo vacío en el servicio detiene las solicitudes para esa sesión.
  • Qué ves. challenge.detected una vez por desafío y por página, y challenge.service por cada solicitud (solved, failed o skipped, con el motivo y el costo del servicio) en la línea de tiempo de eventos; challenges (qué clave, cuántas solicitudes, cuánto costaron las resoluciones con nuestra clave) en la sesión. En una ejecución de agente, el agente espera mientras el servicio trabaja en una página.
  • Algunos widgets se detectan pero no se resuelven: su respuesta no se puede devolver a una página de forma general. Se reportan con solvable: false y nunca se cobran. La dirección de la página y los detalles del desafío se envían al servicio de resolución.

Lo que cuesta

  • Con tu propia clave: nada de nuestra parte. Le pagas directamente al servicio de resolución, a su precio; tu saldo de navegadores alojados solo se cobra por el tráfico, como en cualquier sesión.
  • Con nuestra clave: por desafío resuelto, de tu saldo de navegadores alojados. El precio del servicio de resolución para ese desafío (en USD), convertido a 0.92 € por $ y × 1.5. Los intentos fallidos, los desafíos omitidos y mode: "report" no cuestan nada. No hay cuota mensual ni nada a lo que suscribirse.
  • El precio exacto solo se conoce una vez resuelto el desafío. Depende del tipo de desafío, y el servicio envía cada uno al más barato de varios solvers que pueden atenderlo. Abajo está nuestra mejor estimación por tipo, tal como se cobra con nuestra clave. Normalmente es el precio del solver más barato, que es lo que han costado nuestras resoluciones hasta ahora. Como máximo es el solver más caro que el servicio lista para ese tipo, para cuando el más barato no puede atenderlo.
En la páginaCategoríaNormalmente, por 1,000Normalmente, por resoluciónComo máximo, por 1,000
“I’m not a robot” box with a picture puzzle (the most common widget)token€0.18€0.00018€4.13
The same widget’s enterprise editiontoken€0.18€0.00018€6.90
Interactive “verify you are human” checktoken€0.14€0.00014€2.76
Other picture-puzzle widgets, visible or invisibletoken€0.95€0.00095€9.66
Their enterprise editionstoken€2.76€0.0028€13.80
Smaller token widgets (proof-of-work, puzzle and regional widgets)token€1.10€0.0011€4.14
Invisible score check, standard or enterprisescore€0.72€0.00072€6.90
Full-page “checking your browser” waitclearance€0.28€0.00028€1.79
Block page with a slider or a device checkblock-page€0.83€0.00083€3.81
Block page with a puzzle from a cloud firewallblock-page€0.69€0.00069€2.76
Distorted-text codeimage€0.14€0.00014€0.55
Jigsaw whose gap the browser could not placeimage€1.66€0.0017€2.76
  • En la práctica. 1,000 resoluciones del widget más común suelen salir en unos €0.18; la misma cantidad de esperas de página completa, en unos €0.28. Un token que un sitio rechaza se vuelve a pedir una vez a través de la IP de tu sesión, así que un desafío se puede cobrar dos veces, nunca más.
  • Los precios son la lista del servicio al 2026-10-13 y cambian cuando el servicio los cambia. Algunos de sus solvers cobran según lo difícil que fue el desafío; como máximo usa el tope de su rango.
  • El costo exacto de cada resolución está en su evento challenge.service(costUsd, el precio del servicio antes de la conversión y del margen), y challenges.costEur de la sesión (en GET /api/v1/browsers/<id>) es lo que se te cobró por ellas en total.
  • Lo máximo que puede gastar una sesión. Los valores por defecto detienen una sesión después de 10 solicitudes o €0.50, lo que llegue primero: 10 resoluciones suelen costar menos de €0.03, e incluso al precio más caro de arriba, unos €0.14. Súbelos o bájalos con maxSolves y maxSpendEur; el tope mensual por cuenta (como máximo €25) cubre todas las sesiones juntas.

Qué pasa con cada tipo

En la páginaCategoríaQué se le pide al servicioCómo se introduce la respuesta
Una casilla de «No soy un robot» cuyo clic abrió un rompecabezas de imágenestokenUn token para ese widgetEn el campo de respuesta del widget, y se llama al callback de la página con él
Un widget invisible cuyo rompecabezas de imágenes apareciótokenUn token para ese widgetIgual
Una comprobación interactiva del tipo «verifica que eres humano» que sigue sin respuestatokenUn token para ese widgetIgual
Un código de texto distorsionado junto a un cuadro de textoimageEl texto de la imagenSe escribe en el cuadro, tecla por tecla, después de hacer clic en él
Un deslizador de rompecabezas que el navegador no puede ubicar por sí mismo (por ejemplo, uno con un hueco señuelo)imageDónde está el huecoEl navegador arrastra la pieza hasta ahí y comprueba dónde quedó realmente
Una espera de página completa del tipo «comprobando tu navegador» que no se resuelveclearanceUna cookie de clearance, resuelta a través de la IP de salida de tu sesiónSe establece para el sitio y luego la página se recarga
Una página de bloqueo con un rompecabezas o una comprobación del dispositivoblock-pageUna cookie, resuelta a través de la IP de salida de tu sesiónSe establece para el sitio y luego la página se recarga
Una comprobación de puntuación invisible que la propia página ejecuta (solo con score en la lista)scoreUn token de puntuación para la acción propia de la páginaSe entrega a la llamada con la que la propia página pide un token

Las acciones gratuitas siguen yendo primero: un deslizador simple se arrastra, un rompecabezas cuyo hueco el navegador puede encontrar se coloca, y una casilla que se marca con un clic se pulsa, todo sin consultar al servicio. En el widget, la casilla en sí puede quedar sin marcar después de introducir un token: la página lee el campo de respuesta y el callback, no la casilla.

Desde los SDK

El SDK 0.38.0 o posterior acepta la opción al iniciar en la nube (Python: challenge_service, que también acepta max_solves, max_spend_eur y api_key). La línea de tiempo indica qué pasó; sus últimos eventos llegan unos segundos después de que termina la sesión.

typescript
import { Cloud, launch } from "clearcote";

const browser = await launch({
  cloud: true,
  challengeService: { categories: ["token", "image"], sites: ["shop.example"], maxSpendEur: 0.2 },
});
const page = await browser.newPage();
await page.goto("https://shop.example/signup");
// ... your script: challenges the free actions cannot clear are answered for you
const id = browser.cloudSession.id;
await browser.close();

const { events } = await new Cloud().browsers.events(id);
for (const e of events) if (e.type.startsWith("challenge.")) console.log(e.type, e.data);
// challenge.detected { category: "token", solvable: true }
// challenge.service  { category: "token", outcome: "solved", applied: "callback", attempt: 1, ms: 12725, costUsd: 0.00013 }
python
from clearcote import Cloud, launch

browser = launch(cloud=True, challenge_service={"categories": ["token", "image"], "sites": ["shop.example"], "max_spend_eur": 0.2})
page = browser.new_page()
page.goto("https://shop.example/signup")
session_id = browser.cloud_session["id"]
browser.close()

for e in Cloud().browsers.events(session_id)["events"]:
    if e["type"].startswith("challenge."):
        print(e["type"], e["data"])