Cómo resolver desafíos CAPTCHA para agentes de IA: Extracción de datos con n8n, CapSolver y OpenClaw

Habilite a su asistente de IA para activar la extracción de datos automatizada del lado del servidor — sin inyección de navegador, sin código.

El desafío: Los CAPTCHAs bloquean la eficiencia de su agente de IA

Cuando su agente de IA navega por la web, los CAPTCHAs son el obstáculo principal. Las páginas protegidas bloquean al agente, los formularios no se pueden enviar y las tareas se detienen, esperando la intervención humana. Esto limita significativamente la eficiencia y autonomía de los agentes de IA en la extracción automatizada de datos y procesamiento de información.

Para abordar este problema fundamental, ofrecemos dos soluciones poderosas que combinan OpenClaw y CapSolver:

Enfoque 1 — Integración con extensión de navegador

Cargue la extensión CapSolver de Chrome en el entorno de navegador de OpenClaw. La extensión detecta y resuelve los CAPTCHAs de forma invisible en el lado del cliente, sin involucrar a n8n, permitiendo que el agente de IA evite la verificación de forma fluida mientras navega por las páginas. (Consulte nuestro guía completa sobre el enfoque de la extensión)

Enfoque 2 — Pipeline de automatización del lado del servidor de n8n (Enfoque de esta guía)

OpenClaw activa una solicitud de webhook única, y n8n resuelve el CAPTCHA mediante la API de CapSolver, envía el formulario y devuelve el contenido de la página limpio a su agente de IA. En este proceso, el agente de IA nunca maneja directamente la verificación de CAPTCHA.

Lo que construirá:

Un pipeline de automatización de CAPTCHA del lado del servidor que OpenClaw activa mediante un webhook. n8n utilizará CapSolver para resolver el CAPTCHA, enviar el formulario y devolver el contenido de la página procesado a su agente de IA, asegurando la ejecución fluida de las tareas de extracción de datos.

Requisitos previos

Antes de comenzar, asegúrese de tener el siguiente entorno y herramientas:

1. OpenClaw instalado y la puerta de enlace en ejecución (openclaw gateway start)
2. n8n en ejecución local — guía de instalación
3. Cuenta de CapSolver con clave de API — regístrese aquí
4. Nodo de CapSolver disponible en n8n (integración oficial — ya está integrado)

Configuración de CapSolver en n8n

CapSolver está disponible como integración oficial en n8n, sin necesidad de instalar nodos adicionales de la comunidad. Puede encontrarlo directamente en el panel de nodos al crear sus flujos de trabajo. Para habilitar el nodo de CapSolver y que autentique con su cuenta, debe crear una credencial en n8n.

Abra su lienzo de n8n, haga clic en + para agregar un nodo y busque CapSolver. Este nodo maneja la creación de tareas, la consulta y la recuperación del token en un solo componente.

Pasos para agregar sus credenciales:

1. En n8n, vaya a Credenciales → Nueva credencial
2. Busque CapSolver
3. Pegue su clave de API desde el dashboard de CapSolver
4. Guarde

Importante: Cada nodo de CapSolver en sus flujos de trabajo hará referencia a esta credencial. Solo necesita crearla una vez — todos sus flujos de trabajo para resolver CAPTCHAs compartirán la misma credencial. Además, CapSolver ofrece oficialmente un repositorio GitHub de habilidades, donde puede explorar más integraciones y casos de uso relacionados con CapSolver, ampliando aún más las capacidades de su agente de IA.

Flujo de trabajo: Pipeline de automatización de CAPTCHA de OpenClaw

Todo lo siguiente es un ejemplo. Las URLs, los nombres de campo, los tipos de CAPTCHA, las condiciones de éxito, la estructura de la respuesta — todo es específico del sitio de demostración utilizado aquí. Su sitio real será diferente. Trate cada configuración de nodo como un punto de partida, no como una configuración terminada.

Cómo funciona

1. Nodo Webhook — Recibe una solicitud POST de OpenClaw (o cualquier cliente HTTP).
2. Nodo de disparo por programación — Se activa automáticamente según un programa cron (por ejemplo, diariamente a las 09:00).
3. Nodo CapSolver — Resuelve el CAPTCHA utilizando el tipo de tarea configurado.
4. Nodo HTTP Request — Envía el token resuelto al sitio objetivo.
5. Nodo If — Verifica si la respuesta indica éxito o fallo.
6. Nodo Edit Fields — Extrae pageText de la respuesta.
7. Nodo Save Result — Almacena el resultado en un almacenamiento (opcional).
8. Nodo Respond to Webhook — Devuelve el resultado al llamador.

Webhook ──┐
           ├──► Scrape site ──► HTTP Request ──► If ──► Edit Fields ──► Save Result ──► Respond to Webhook
Schedule ──┘                                           Edit Fields1 ─┘

Detalles de configuración de los nodos

Cree un nuevo flujo de trabajo llamado "OpenClaw/Capsolver/n8n Scraper" con los siguientes nodos:

1. Nodo Webhook

• Tipo: Webhook
• Método HTTP: POST
• Ruta: openclaw/scrape
• Responder: Nodo de respuesta (hace que la llamada sea sincrónica — el llamador espera el resultado)

2. Nodo de disparo por programación

• Tipo: Nodo de disparo por programación
• Cron: 0 9 * * * (diariamente a las 09:00)
• Conectar a: Scrape site (mismo que Webhook)

Tener dos nodos de disparo en un mismo flujo es válido en n8n. Ambos alimentan la misma ruta de procesamiento.

3. Nodo CapSolver

• Tipo: CapSolver
• Tipo de tarea: ReCaptchaV2TaskProxyless
• URL del sitio web: https://example.com/pagina-protegida
• Clave del sitio: YOUR_SITE_KEY (bújela en el código fuente de la página — busque data-sitekey)
• Credenciales: su clave de API de CapSolver

¿Usa reCAPTCHA v3? Cambie el tipo de tarea a ReCaptchaV3TaskProxyless y agregue un campo Page Action (por ejemplo, login, submit, homepage). Esto es necesario para v3 — es el nombre de la acción que el sitio registra con Google. Lo encontrará en el código fuente cerca de la llamada grecaptcha.execute(...).

Tenga en cuenta que cada tipo de CAPTCHA tiene su propio conjunto de parámetros — algunos campos que son opcionales en v2 se vuelven obligatorios en v3, y v3 puede mostrar campos que no existen en v2 en absoluto (como minScore). Siempre consulte las documentaciones de CapSolver para conocer los parámetros exactos requeridos por su tipo de tarea.

Este nodo llama a la API de CapSolver, espera la resolución (normalmente 5-20 segundos) y devuelve el token en $json.data.solution.gRecaptchaResponse.

4. Nodo HTTP Request

• Método: POST
• URL: https://example.com/pagina-protegida
• Cuerpo: form-urlencoded
  • g-recaptcha-response = ={{ $json.data.solution.gRecaptchaResponse }}
• Encabezados: encabezados estándar de navegador (User-Agent, Accept, Referer, Origin, etc.)

Esto envía el formulario con el token resuelto, exactamente como lo haría un navegador.

Alerta: Cómo se envía el token varía según el sitio. La mayoría de los formularios lo esperan en el cuerpo de la solicitud como g-recaptcha-response, pero algunos sitios lo envían como un campo JSON, un encabezado personalizado, o incluso como una cookie o un nombre diferente. Utilice las herramientas de desarrollo de su navegador (pestaña de red) para inspeccionar cómo se ve un envío real y replicarlo en su nodo HTTP Request.

5. Nodo If (verificación de éxito)

• Condición: $json.data contiene "recaptcha-success"
• Rama verdadera → Edit Fields (éxito)
• Rama falsa → Edit Fields1 (falla)

6. Nodos Edit Fields / Edit Fields1

Ambas ramas establecen un solo campo:

• pageText = {{ $json.data }}

Las ramas de éxito y fallo pasan pageText — el llamador puede inspeccionar el HTML para determinar el resultado.

Adapte esto a su página: cómo analiza y utiliza los datos de respuesta depende completamente de lo que desee y de lo que devuelva el sitio objetivo. Algunas páginas devuelven JSON, otras devuelven HTML, algunas redirigen al éxito. Podría querer extraer un campo específico, analizar una tabla, verificar una cookie de sesión o eliminar por completo el HTML. La condición de éxito ("recaptcha-success") también es solo un ejemplo — su sitio tendrá su propio indicador. Estos nodos son un punto de partida; espere personalizarlos según su caso de uso.

7. Nodo Save Result

Este nodo pasa { pageText, savedAt } a la respuesta del webhook y opcionalmente persiste el resultado en almacenamiento.

Nota: El nodo Code de n8n se ejecuta en un VM aislado que bloquea built-ins de Node.js como require('fs'). Use un nodo Execute Command en su lugar para escribir en disco, o reemplace este nodo completamente con cualquier integración de n8n que se ajuste a su stack.

Opción A — Archivo JSON local (nodo Execute Command):

Use dos nodos conectados:

Nodo 7a — Preparar datos (nodo Code):

const item = $input.first().json;
const now = new Date();
const savedAt = now.toISOString();
const data = { pageText: item.pageText || '', savedAt };
const encoded = Buffer.from(JSON.stringify(data)).toString('base64');
const cmd = 'python3 /ruta/a/save-result.py ' + encoded;
return [{ json: { cmd, pageText: data.pageText, savedAt } }];

Nodo 7b — Guardar resultado (nodo Execute Command):

• Comando: ={{ $json.cmd }}

Donde save-result.py lee el argumento en base64 y lo agrega a un archivo JSON local.

Opción B — Almacenamiento compatible con n8n:

n8n tiene nodos nativos para casi cualquier sistema de almacenamiento. Reemplace el Nodo 7 con cualquiera de estos:

Simplemente conecte el nodo entre Edit Fields y Respond to Webhook, y configure para que almacene $json.pageText y una marca de tiempo.

8. Nodo Respond to Webhook

• Responder con: JSON
• Cuerpo de la respuesta: ={{ JSON.stringify($json) }}
• Continuar en caso de fallo: activado (necesario — cuando se dispara desde Schedule, no hay un webhook activo al que responder)

Active el flujo de trabajo una vez que lo haya construido. La ruta del webhook estará activa en:

POST http://127.0.0.1:3005/webhook/openclaw/scrape

Integración con OpenClaw

Para conectar OpenClaw con este flujo de trabajo, cree un script de disparo y regístrelo.

Cree el script de disparo:

cat > ~/.openclaw/scripts/extraer-datos << 'EOF'
#!/usr/bin/env bash
curl -s -X POST http://127.0.0.1:3005/webhook/openclaw/scrape
EOF
chmod +x ~/.openclaw/scripts/extraer-datos

Este es el único comando que ejecuta OpenClaw. Sin argumentos, sin clave de sitio, sin URL — el flujo de trabajo sabe qué extraer.

Cómo OpenClaw obtiene los datos: El script espera a que n8n termine (resolución de CAPTCHA + envío del formulario), luego recibe { pageText, savedAt } directamente en la respuesta del webhook. No se involucra la lectura de archivos — los datos regresan sincrónicamente a través de HTTP. La forma de la respuesta es solo lo que devuelve este flujo de trabajo — si necesita campos diferentes (por ejemplo, un precio analizado, un estado de inicio de sesión, un objeto JSON estructurado), modifique los nodos Edit Fields y Save Result para devolver lo que su caso de uso requiera.

Registre el comando en TOOLS.md:

Abra ~/.openclaw/workspace/TOOLS.md y agregue la siguiente entrada para que OpenClaw conozca el comando:

### extraer-datos

Ejecutar: `/root/.openclaw/scripts/extraer-datos`
Devuelve `{ pageText, savedAt }` actualizados desde el pipeline en vivo. Devuelva el campo `pageText` de la respuesta JSON.

Pruebe su flujo de automatización de agente de IA

Dispare desde OpenClaw — envíe este comando a su agente de IA (a través de Discord, Telegram, WhatsApp, o cualquier canal):

extraer datos

OpenClaw ejecuta el script extraer-datos, que activa el webhook y espera. n8n resuelve el CAPTCHA, envía el formulario y devuelve { pageText, savedAt } directamente en la respuesta HTTP. OpenClaw recibe y resume el resultado — normalmente en 10-40 segundos.

Pruebe desde la terminal:

curl -s -X POST http://127.0.0.1:3005/webhook/openclaw/scrape

Ejecuciones programadas — el flujo de trabajo también se ejecuta automáticamente cada día a las 09:00 mediante el nodo de disparo por programación.

Adaptar el flujo a su sitio objetivo

El flujo de esta guía está construido para un sitio de demostración específico. Para su sitio real, cada parte del pipeline podría requerir ajustes. Estos son los aspectos a considerar:

1. Tipo de CAPTCHA

No todos los sitios usan reCAPTCHA v2. Cambie el tipo de tarea del nodo CapSolver para que coincida con lo que utiliza el sitio objetivo:

También actualice la URL del sitio y la clave del sitio para que coincidan con su objetivo. Puede encontrar la clave del sitio en el código fuente de la página (busque el atributo data-sitekey, o la extensión de navegador de CapSolver la detecta automáticamente).

2. Cómo se envía el token

Este es el aspecto que varía más entre sitios. El sitio de demostración usa un POST de formulario simple con el token en un campo del cuerpo. Su objetivo podría ser diferente:

Como campo de formulario (más común)

POST /enviar
Content-Type: application/x-www-form-urlencoded

g-recaptcha-response=TOKEN&otro_campo=valor

En un cuerpo JSON

POST /api/iniciar_sesión
Content-Type: application/json

{ "usuario": "...", "contraseña": "...", "tokenCAPTCHA": "TOKEN" }

En un encabezado

POST /api/acción
X-CAPTCHA-TOKEN: TOKEN

Como cookie

POST /enviar
Cookie: cf_clearance=TOKEN

En la URL como parámetro de consulta

GET /buscar?q=consulta&token=TOKEN

Inspeccione la pestaña de red en las herramientas de desarrollo de su navegador al resolver manualmente el CAPTCHA en su sitio objetivo. Busque la solicitud que se dispara inmediatamente después de resolverlo — esto le mostrará exactamente dónde va el token.

3. Nodo HTTP Request

Una vez que sepa cómo se envía el token, configure el nodo HTTP Request en consecuencia:

• Método: coincida con el sitio (POST, GET, PUT)
• URL: el punto final exacto que recibe el formulario o la llamada de API
• Encabezados: copie los encabezados del navegador desde su pestaña de red — User-Agent, Referer, Origin, Accept, Content-Type suelen ser necesarios
• Cuerpo: use form-urlencoded, JSON o multipart según el punto final
• Cookies: si el sitio usa cookies de sesión, páselas como encabezados o use un nodo HTTP Request previo para obtenerlas mediante un paso de inicio de sesión

4. Extracción de los datos que necesita

El flujo actual pasa el HTML completo de la respuesta como pageText. Según su caso de uso, podría querer procesarlo posteriormente:

• Agregue un nodo Code después del nodo HTTP Request para analizar el HTML y extraer campos específicos (nombre del producto, precio, estado)
• Use el nodo de extracción de HTML de n8n para extraer datos de selectores CSS específicos sin escribir código
• Almacene campos estructurados en lugar de HTML sin procesar — más fácil de consultar y comparar entre ejecuciones

5. Flujos de múltiples pasos

Algunos objetivos requieren más de una solicitud:

1. GET la página para obtener un token CSRF o una cookie de sesión
2. Resolver el CAPTCHA
3. POST el formulario con el token CSRF + token de CAPTCHA + credenciales
   Cadena múltiples nodos de solicitud HTTP en n8n para manejar esto. Pasar valores entre nodos usando expresiones $json.

Solución de problemas

"No se pudo alcanzar al raspador de n8n"

{"success": false, "error": "No se pudo alcanzar al raspador de n8n. ¿Está activa la tarea del raspador de OpenClaw?"}

Verifique: ¿Está n8n en ejecución? ¿Está activa la tarea? Abra n8n y verifique que la tarea esté activa (interruptor verde).

Tiempo de espera de CapSolver / Sin token

Causas posibles:

• Clave de API inválida — verifique ~/.n8n/credenciales
• Saldo insuficiente — recargue en capsolver.com/dashboard
• Problema de red entre el servidor de n8n y la API de CapSolver

pageText está vacío o contiene una página de error

• La URL de solicitud HTTP o el nombre del campo de formulario podría estar incorrecto para su objetivo
• Verifique el nombre del campo g-recaptcha-response — algunas páginas usan un nombre de campo diferente
• Habilite fullResponse: true en el nodo de solicitud HTTP para ver el código de estado

Ejecución programada falla en "Responder al webhook"

Esto es esperado y seguro. Cuando se activa con un programa, no hay contexto de webhook activo. Asegúrese de que Continue on Fail esté habilitado en el nodo "Responder al webhook".

Referencia de configuración completa

Resumen de nodos de flujo de trabajo de n8n

Tipos de tareas de CAPTCHA

Conclusión

La canalización OpenClaw + n8n + CapSolver proporciona un entorno de extracción de datos de producción que:

• Se ejecuta a demanda cuando su Agente de IA lo solicita.
• Se ejecuta automáticamente en un horario sin ninguna entrada humana.
• Nunca requiere un navegador o pantalla.
• Mantiene el manejo de CAPTCHA completamente invisible — para usted y para el Agente de IA.

El Agente de IA simplemente emite un comando de "extraer datos" y recibe contenido de página limpio. CapSolver maneja la parte difícil, n8n orquesta el flujo y OpenClaw sirve como interfaz.

¿Listo para comenzar? Regístrese en CapSolver y use el código de bonificación OPENCLAW para obtener un 6% adicional en su primer recargo!

Preguntas frecuentes

¿Necesito informar a OpenClaw sobre CapSolver o CAPTCHAs?

No. OpenClaw simplemente ejecuta un script que envía una solicitud HTTP. n8n maneja el resto. Su Agente de IA no tiene conocimiento de CAPTCHAs — solo activa un trabajo y lee el resultado.

¿Puedo apuntar esto a un sitio diferente?

Sí, pero probablemente necesite ajustar más que solo la URL. Cada sitio envía el token de CAPTCHA de manera diferente — algunos usan campos de formulario, otros cuerpos JSON, encabezados o cookies. Consulte la sección "Adaptar el flujo al sitio objetivo" anterior para un análisis completo de qué verificar y cambiar.

¿Qué pasa si su sitio objetivo usa Turnstile en lugar de reCAPTCHA?

Cambie el tipo de tarea del nodo CapSolver a AntiTurnstileTaskProxyless. Luego inspeccione las solicitudes de red de su sitio objetivo para encontrar dónde se envía el token de Turnstile — a menudo está en un campo oculto llamado cf-turnstile-response, pero algunas implementaciones lo pasan en un cuerpo JSON, un encabezado o una cookie en su lugar.

¿Cuántos resultados se almacenan?

Depende de su elección de almacenamiento. Con un archivo JSON local, puede guardar tantos como desee. Con Google Sheets o una base de datos, cada ejecución agrega una fila indefinidamente. Configure el nodo Guardar resultado para que coincida con sus necesidades de retención.

¿Puedo activar esto desde un trabajo programado en lugar de OpenClaw?

Sí — el punto de conexión de webhook es simplemente una solicitud HTTP POST. Cualquier cosa que pueda realizar una solicitud HTTP puede activarlo:

curl -s -X POST http://127.0.0.1:3005/webhook/openclaw/scrape

¿Cuánto cuesta cada extracción?

Cada ejecución cuesta un crédito de CapSolver para resolver la CAPTCHA. reCAPTCHA v2 es uno de los tipos más económicos. Consulte los precios actuales en capsolver.com.

¿Es gratuito OpenClaw?

OpenClaw es de código abierto y gratuito para autohospedaje. Necesitará créditos de API para su proveedor de modelo de IA y CapSolver para resolver CAPTCHAS.