n8n-node-playwright

Este plugin para n8n permite controlar y automatizar navegadores web mediante Playwright a través de una conexión WebSocket, permitiendo realizar operaciones de automatización de navegadores, navegación web, extracción de datos y captura de pantallas.

Características

• Gestión de múltiples sesiones de navegadores mediante identificadores únicos
• Conexión a un servidor Playwright via WebSocket para ejecutar comandos remotamente
• Estructura modular con nodos especializados para diferentes tareas
• Soporte para Chrome, Firefox y WebKit (Safari)
• Opciones avanzadas para navegación, extracción y captura de pantallas

Nodos incluidos

PlaywrightBrowser

Nodo para iniciar y cerrar sesiones de navegador Playwright.

Operaciones:

• start: Inicia una nueva sesión de navegador (Chrome, Firefox, WebKit)
• close: Cierra una sesión existente

Opciones:

• Tipo de navegador (Chrome, Firefox, WebKit)
• Modo headless/headed
• Tamaño de viewport
• User agent personalizado

PlaywrightNavigation

Nodo para realizar acciones de navegación y manipulación del DOM.

Operaciones:

• Navegar a URL
• Hacer clic en elementos
• Escribir texto en formularios
• Seleccionar opciones de dropdown
• Esperar elementos/navegación
• Avanzar/retroceder en el historial
• Recargar página

PlaywrightExtract

Nodo para extraer datos de páginas web.

Operaciones:

• Extraer texto
• Extraer HTML
• Extraer atributos de elementos
• Evaluar expresiones JavaScript
• Extraer listas de elementos
• Extraer tablas con formato personalizable

PlaywrightScreenshot

Nodo para capturar imágenes de páginas web.

Operaciones:

• Capturar pantalla completa
• Capturar área visible
• Capturar elementos específicos

Opciones:

• Formato de imagen (PNG/JPEG)
• Calidad
• Escala
• Output (base64/binario)

PlaywrightExecute

Nodo para ejecutar código JavaScript personalizado en el contexto del navegador.

Operaciones:

• Evaluar en página
• Evaluar en elemento específico
• Ejecutar funciones predefinidas (URL, título, cookies, formularios, scroll)

Requisitos

Servidor Playwright WebSocket

Para utilizar este plugin, necesitas un servidor WebSocket que controle instancias de Playwright y responda a los mensajes enviados por los nodos. El servidor debe implementar la lógica para:

• Crear y gestionar sesiones de navegador
• Ejecutar comandos de navegación
• Extraer datos según las especificaciones
• Capturar pantallas
• Ejecutar código JavaScript personalizado

Instalación

1. Instala el plugin en tu instalación de n8n:

   npm install @aiospe/n8n-nodes-playwright

2. Configura las credenciales del servidor WebSocket Playwright en n8n.

Ejemplo de uso

1. Añade un nodo PlaywrightBrowser con la operación "start" y define un ID de sesión.
2. Usa PlaywrightNavigation para navegar a una URL específica.
3. Utiliza PlaywrightExtract para extraer datos de la página.
4. Finaliza con PlaywrightBrowser usando la operación "close" para cerrar la sesión.

Notas sobre implementación del servidor WebSocket

El servidor debe estar preparado para recibir mensajes JSON con la siguiente estructura:

{
  "action": "startBrowser|closeBrowser|navigate|extract|screenshot|execute",
  "sessionId": "session-unique-id",
  "operation": "operación-específica",
  "options": { ... opciones adicionales ... }
}

Y responder con:

{
  "success": true|false,
  "data": { ... datos resultantes ... },
  "error": "mensaje de error si ocurrió alguno"
}

Licencia

MIT