n8n-nodes-playwright-captcha

Nodo personalizado de n8n que integra Playwright para automatización web con:

• ✅ Navegación web automatizada
• ✅ Resolución automática de captchas usando 2captcha (reCAPTCHA v2/v3, hCaptcha)
• ✅ Soporte para proxies HTTP con autenticación
• ✅ Acciones múltiples: click, type, wait, screenshot, getText

Instalación

npm install
npm run build

Instalación en n8n

Opción 1: Instalación privada desde GitHub/GitLab (Recomendado)

Desde GitHub:

cd ~/.n8n
npm install <tu-usuario>/n8n-nodes-playwright-captcha

Desde GitLab:

cd ~/.n8n
npm install git+https://gitlab.com/<tu-usuario>/n8n-nodes-playwright-captcha.git

Usando variable de entorno:

export N8N_CUSTOM_EXTENSIONS="<tu-usuario>/n8n-nodes-playwright-captcha"
n8n start

Opción 2: Instalación manual local

1. Copia la carpeta dist en tu directorio de nodos personalizados de n8n
2. Reinicia n8n

Opción 3: Publicar en npm (Nodos comunitarios)

Para publicar en la comunidad de n8n:

1. Crear cuenta en npm: https://www.npmjs.com/signup

2. Configurar el paquete (ya está listo):

   • El nombre debe empezar con n8n-nodes-
   • Incluir keyword n8n-community-node-package

3. Publicar:

   npm login
   npm publish

4. Registrar en n8n: Envía un PR a https://github.com/n8n-io/n8n-nodes-registry

Después los usuarios podrán instalarlo con:

npm install n8n-nodes-playwright-captcha

Uso

Configuración básica

1. URL: URL de la página a visitar
2. Actions: Conjunto de acciones a realizar:
   • Click: Hacer click en un elemento
   • Type Text: Escribir texto en un campo
   • Wait: Esperar X milisegundos
   • Screenshot: Capturar pantalla
   • Get Text: Extraer texto de un elemento

Configuración de Captcha

Para resolver captchas automáticamente:

1. Activa "Enable Captcha Solving"
2. Ingresa tu API Key de 2captcha
3. Selecciona el tipo de captcha (reCAPTCHA v2/v3, hCaptcha)
4. Ingresa el Site Key del captcha (puedes encontrarlo en el HTML de la página)

Configuración de Proxy

Para usar un proxy HTTP:

1. Activa "Enable Proxy"
2. Ingresa la URL del servidor proxy (ej: http://proxy.example.com:8080)
3. Opcionalmente ingresa usuario y contraseña si el proxy requiere autenticación

Ejemplo de uso

{
  "url": "https://example.com",
  "actions": {
    "actionItems": [
      {
        "actionType": "type",
        "selector": "#username",
        "text": "mi_usuario"
      },
      {
        "actionType": "type",
        "selector": "#password",
        "text": "mi_password"
      },
      {
        "actionType": "click",
        "selector": "#login-button"
      },
      {
        "actionType": "wait",
        "waitTime": 2000
      },
      {
        "actionType": "screenshot"
      }
    ]
  },
  "captchaSettings": {
    "captchaConfig": [
      {
        "enabled": true,
        "apiKey": "tu_api_key_2captcha",
        "captchaType": "recaptchav2",
        "siteKey": "6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI"
      }
    ]
  },
  "proxySettings": {
    "proxyConfig": [
      {
        "enabled": true,
        "server": "http://proxy.example.com:8080",
        "username": "usuario",
        "password": "password"
      }
    ]
  }
}

API de 2captcha

Necesitas una cuenta en 2captcha.com y obtener tu API Key desde el panel de control.

Tipos de captcha soportados:

• reCAPTCHA v2: El captcha clásico de Google con checkbox "No soy un robot"
• reCAPTCHA v3: Captcha invisible de Google
• hCaptcha: Alternativa a reCAPTCHA

Licencia

MIT