n8n-nodes-seo-scanner

Nodo comunitario de n8n para auditorias SEO tecnicas con marca UOPIX. Analiza una URL, puede rastrear paginas internas del mismo dominio y devuelve un JSON estructurado con problemas, avisos, checks correctos, recomendaciones y un informe HTML tipo dashboard.

Que hace

• Audita una pagina web a partir de una URL absoluta.
• Puede rastrear URLs internas descubiertas en enlaces y sitemaps.
• Permite forzar paginas obligatorias, excluir patrones y silenciar fallos concretos.
• Detecta problemas SEO tecnicos, accesibilidad basica, enlaces rotos, headers de seguridad y metadatos sociales.
• Puede renderizar JavaScript con Puppeteer para webs React, Vue, Angular u otras SPAs.
• Genera un informe HTML listo para responder desde un Webhook de n8n.
• Puede enviar el resultado final a una API externa mediante callback.
• Soporta salida en ingles o espanol para los textos generados y el informe HTML.
• Limita rafagas por dominio, respeta Retry-After y reintenta de forma acotada errores temporales (403, 429 y 5xx).
• Usa un User-Agent identificable en Wikimedia y un fallback ligero de navegador solo ante paginas de bloqueo que requieren JavaScript.

Comprobaciones principales

• Estado HTTP, HTTPS y redirecciones.
• Title, meta description, viewport, robots y canonical.
• H1, estructura de headings y conteo aproximado de palabras.
• Imagenes sin alt, enlaces internos y externos, y enlaces rotos.
• Open Graph, JSON-LD, favicon, charset y atributo lang.
• Hreflang, idioma detectado y coherencia basica multidioma.
• Robots.txt, sitemap, DNS, CDN, SSL y geolocalizacion tecnica.
• Headers de seguridad y buenas practicas web.
• CMS, plugins y tecnologias detectadas cuando hay senales suficientes.
• Score 0-100, resumen por severidad y recomendaciones accionables.

Instalacion desde GitHub

En una instalacion local de n8n:

cd ~/.n8n/nodes
npm install github:OXSR/n8n-nodes-seo-scanner
n8n start

En Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.n8n\nodes"
Set-Location "$env:USERPROFILE\.n8n\nodes"
npm install github:OXSR/n8n-nodes-seo-scanner
n8n start

Tambien puedes cargarlo como extension local durante el desarrollo:

cd C:\Users\oriol\.n8n\custom\n8n-nodes-seo-scanner
npm install
npm run build
$env:N8N_CUSTOM_EXTENSIONS="C:\Users\oriol\.n8n\custom\n8n-nodes-seo-scanner"
n8n start

Despues de instalar o actualizar el nodo, reinicia n8n y recarga el editor.

Uso en n8n

1. Anade el nodo SEO UOPIX al workflow.
2. Introduce la URL de la pagina que quieres analizar.
3. Activa Escanear todo el sitio si quieres analizar tambien paginas internas.
4. Ajusta el limite de paginas, timeout, user-agent, idioma de salida y opciones de detalle.
5. Ejecuta el nodo y usa la salida JSON en tus siguientes pasos.

Campos utiles:

• URL de la pagina: URL absoluta, por ejemplo https://example.com/pagina.
• Escanear todo el sitio: rastrea URLs internas del dominio.
• Limite de paginas a escanear: controla el tamano del crawl.
• Paginas obligatorias a escanear: URLs del mismo dominio que siempre se incluyen.
• Excluir URLs que contengan: patrones para no rastrear rutas concretas.
• Ignorar fallos / paginas: filtra mensajes o URLs conocidas.
• Usar JavaScript Rendering: usa Puppeteer para contenido renderizado por cliente.
• Proteccion ante bloqueos: el nodo aplica pausas cortas por dominio y evita repetir el sondeo pesado de recursos en cada pagina interna.
• Output Language: English o Spanish.
• Generar informe HTML: agrega html y reportHtml a la salida.
• Enviar resultados a API externa: hace POST a una URL de callback al terminar.

Salida

La salida principal incluye:

• mainPage: analisis completo de la URL principal.
• internalPages: analisis de paginas internas cuando el crawl esta activo.
• internalScanSummary: resumen del rastreo interno.
• severitySummary: conteos por severidad.
• issues, warnings, passed y recommendations.
• score: puntuacion SEO de 0 a 100.
• html y reportHtml: informe HTML cuando esta activado.

El export JSON no se traduce por diseno: mantiene nombres de campo estables para automatizaciones.

Informe HTML

Para servir el informe desde n8n:

1. Crea un workflow con Webhook -> SEO UOPIX -> Respond to Webhook.
2. En SEO UOPIX, activa Generar informe HTML.
3. En Respond to Webhook, usa:
   • Respond With: Text
   • Response Body: {{ $json.html }}
4. Activa el workflow y abre la URL del webhook.

Si tu version de n8n muestra el HTML dentro de un iframe con sandbox y ves una pantalla en blanco, puedes usar N8N_INSECURE_DISABLE_WEBHOOK_IFRAME_SANDBOX=true en entornos self-hosted controlados.

Credenciales UOPIX

El nodo incluye credenciales SEO UOPIX API:

• API Key: clave personal generada en UOPIX.
• App Base URL: URL base que valida la API key, por defecto https://uopix.com.

Estas credenciales se usan cuando el flujo necesita validar o consumir usos de API asociados a UOPIX.

Desarrollo

npm install
npm run build

Archivos principales:

• nodes/SeoScanner/SeoScanner.node.ts: definicion del nodo y ejecucion.
• nodes/SeoScanner/analyzeUtils.ts: analisis SEO de pagina.
• nodes/SeoScanner/reportUtils.ts: salida e informe HTML.
• nodes/SeoScanner/uopix-mark.svg: icono del nodo.
• dist/nodes/SeoScanner: build que carga n8n.

Antes de publicar cambios:

npm run build

Licencia

MIT