n8n-nodes-seo-scanner
v0.1.9
Published
Nodo n8n: escaneo SEO técnico completo de una página web, con opción de escanear enlaces internos, informe HTML tipo dashboard, detección de CMS/plugins, crawl extendido (DNS, CDN, SSL, analytics).
Downloads
972
Maintainers
Readme
n8n-nodes-seo-scanner
Nodo personalizado de n8n para escaneo SEO técnico de una página web.
Qué hace
- Una URL: Analiza la página indicada y devuelve un informe técnico SEO.
- Opción "Escanear enlaces internos": Además de la página principal, analiza hasta N enlaces internos (mismo dominio) encontrados en la página, con un máximo configurable (1–50) para no alargar demasiado el escaneo.
Comprobaciones SEO incluidas
- URL: HTTPS, código de respuesta
- Título: presencia, longitud (30–60 caracteres), avisos
- Meta description: presencia, longitud (120–160 caracteres)
- Meta viewport: correcta para móvil
- Meta robots: contenido y aviso si hay noindex
- Canonical: presencia y si apunta a la propia URL
- H1: cantidad (recomendado 1), textos
- Estructura de headings: H2, H3, etc.
- Imágenes: total, con/sin
alt, lista de las que faltan - Enlaces: internos vs externos, lista de URLs internas
- Open Graph: og:title, og:description, og:image
- JSON-LD: número de scripts de datos estructurados
- Atributo lang en
<html> - Charset y favicon
- Palabras (aprox.) en el cuerpo
- Puntuación 0–100 y listas de issues, warnings y checks pasados
Instalación
En la carpeta del nodo:
npm install npm run buildConfigura n8n para cargar el nodo (por ejemplo con variable de entorno):
N8N_CUSTOM_EXTENSIONS="C:\Users\tu-usuario\.n8n\custom\n8n-nodes-seo-scanner"Reinicia n8n. El nodo SEO Scanner aparecerá en la categoría Analytics / Marketing.
Uso
- URL de la página: obligatoria; debe ser una URL absoluta (p. ej.
https://example.com/pagina). - Escanear enlaces internos: activar si quieres que además se analicen enlaces internos de esa página.
- Máximo de URLs internas: solo si lo anterior está activado; entre 1 y 50 (por defecto 10).
- Timeout por página: segundos de espera por cada página (5–60).
Salida
- mainPage: objeto con todo el análisis de la URL principal.
- Si escaneas enlaces internos: internalPages (array de análisis por URL), internalScanSummary (resumen: total escaneadas, páginas con errores, puntuación min/max/media) y mainPageScore / averageScoreInternal.
Informe HTML (dashboard)
Si activas Generar informe HTML, el nodo devuelve (igual que el nodo HTML de n8n):
html: HTML completo del informe (para usar en Respond to Webhook).reportHtml: el mismo HTML.
Cómo ver el informe en el navegador (recomendado)
Webhook + Respond to Webhook (igual que servir HTML con webhooks en n8n):
- Webhook (trigger) → SEO Scanner (con “Generar informe HTML” activado) → Respond to Webhook.
- En Respond to Webhook: Respond With = Text, Response Body =
{{ $json.html }}. - En el Webhook: “Respond to Using” = Respond to Webhook.
- Activa el workflow y abre la URL del webhook en el navegador (GET). Verás el dashboard.
Si ves pantalla en blanco al abrir esa URL (desde n8n 1.103 el HTML se sirve dentro de un iframe con sandbox):
- Self‑hosted: añade la variable de entorno
N8N_INSECURE_DISABLE_WEBHOOK_IFRAME_SANDBOX=truey reinicia n8n (referencia). - Alternativa: guarda el informe en un archivo y ábrelo: copia
{{ $json.html }}o{{ $json.reportHtml }}, pégalo en un editor, guarda comoinforme.html(UTF-8) y ábrelo en Chrome/Edge/Firefox.
- Self‑hosted: añade la variable de entorno
Requisitos
- Node.js 18+ (usa
fetchnativo). - Dependencia:
cheeriopara parsear HTML.
Licencia
MIT
