Recursos · Integración n8n

Integración Npm n8nAutomatiza Npm con n8n.

La integración Npm n8n mete el registro npm dentro de tus flujos de trabajo. El nodo trae 5 operaciones repartidas en 2 recursos, los paquetes por un lado y los dist-tags por otro. Consulta el registro que indique el credential, la credencial que guardas una sola vez en n8n. Sin trigger propio, arranca otra cosa.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué hace de verdad la integración Npm n8n?

El nodo npm llama a la API del registro npm desde n8n. Lee lo que declara un paquete: los metadatos de una versión concreta, la lista completa de versiones publicadas, los dist-tags que apuntan un nombre hacia una versión y los resultados de una búsqueda por palabra clave. Solo una operación escribe, la que mueve un dist-tag hacia otra versión. Todo va contra el registro configurado en el credential, el público o el tuyo.

El primer escenario es el inventario de dependencias. Un Schedule Trigger lanza el flujo cada lunes, el nodo devuelve las versiones publicadas de cada paquete del inventario y el resultado se guarda en MongoDB, que conserva el histórico sin obligarte a fijar un esquema. Lo que mira el equipo es la diferencia con la semana anterior, no la lista entera.

El segundo escenario es la ficha previa a una aprobación. Cuando alguien propone subir una dependencia, el flujo pide los metadatos de esa versión exacta y los publica en el canal de Slack donde se decide. Así la conversación va sobre lo que declara el paquete y no sobre un número suelto.

El tercer escenario es la etiqueta de instalación. Terminada la validación, el flujo mueve el dist-tag hacia la versión aprobada y cada equipo instala esa sin tocar nada más. La búsqueda de paquetes cubre otra necesidad: rastrear qué existe sobre un tema y volcarlo en Google Sheets antes de elegir una librería.

El nodo se detiene en estas 5 operaciones. Publicar un paquete, retirarlo, marcar una versión como obsoleta o cambiar de propietarios queda fuera. El nodo HTTP Request llama al resto de la API del registro reutilizando el mismo credential, así que una operación ausente cuesta un nodo más, no un cambio de herramienta. Dos detalles conviene tenerlos claros antes de montar nada. Get Package Metadata pide una versión exacta, lo que obliga casi siempre a listar versiones primero y pasar la elegida a la segunda llamada. Y la búsqueda avanza con Limit y Offset, una llamada por página, sin forma de traerlo todo de golpe.

Queda la pregunta del alojamiento. El nodo viene incluido con n8n, tanto en n8n Cloud como en una instancia que alojes tú, sin instalación ni coste añadido por el lado de n8n. La Reseña n8n repasa dónde encaja la herramienta y dónde no.

Conexión

¿Cómo se conecta npm con n8n?

  1. 01

    Generar el token de acceso en npm

    Entra en la cuenta de npm que gestiona los paquetes que te interesan, abre el menú de tu perfil y elige Access Tokens. Genera un token desde esa pantalla y copia su valor. Esa cadena es lo que n8n envía en cada llamada, así que se trata como una contraseña: quien la tenga habla con el registro con los permisos de esa cuenta.

  2. 02

    Guardar el credential en n8n

    En n8n, abre el menú Credentials y crea un credential de npm. Pega el token en Access Token y mira después Registry URL: deja el valor del registro público que viene por defecto o sustitúyelo por la dirección de tu propio registro. El credential se crea una vez y se reutiliza en todas partes, de modo que el nodo npm ya te lo ofrece en su desplegable.

  3. 03

    Montar el nodo y ejecutarlo una vez

    Añade el nodo npm al flujo, elige el credential y selecciona después el recurso, Package o Distribution Tag, y la operación que cuelga de él. Rellena a mano los campos obligatorios para la primera prueba y ejecuta ese nodo solo. Lo que aparece en el panel de salida es exactamente lo que van a leer los nodos siguientes, conviene mirarlo antes de montar el resto.

Acciones

Las 5 operaciones del nodo npm , una a una

El nodo Npm expone 5 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoUpdateGet AllGet MetadataGet VersionsSearch
Package✓✓✓
Distribution Tag✓✓

Package

3 operaciones
01

Returns all the metadata for a package at a specific version

package.getMetadata

Lo que ves en n8n

Notas y casos de uso

Pide al registro una versión concreta y devuelve todo lo que esa versión declara, en un solo item. Lee sin modificar nada, así que puedes repetirla tantas veces como haga falta durante un análisis.

Parámetros clave

  • Package Name: el nombre del paquete tal y como está publicado en el registro, escrito a mano o traído de un nodo anterior con {{ $json.field }}.
  • Package Version: la versión exacta. El campo es obligatorio, el nodo se detiene si queda vacío, y aquí no hay atajo hacia la última versión.
Casos de uso
dejar documentada la versión que un equipo acaba de poner en producción, junto al ticket que originó la entrega.
02

Returns all the versions for a package

package.getVersions

Lo que ves en n8n

Notas y casos de uso

Entra un nombre de paquete y sale la lista de versiones publicadas para él. Es la operación que responde a si ha salido algo desde ayer, porque nada avisa a n8n de una publicación por su cuenta.

Parámetros clave

  • Package Name: el paquete a leer, fijo en el campo o tomado del item que entra, por ejemplo {{ $json.field }}.
Casos de uso
un repaso diario de los paquetes que sostienen el producto, comparado con la lista del día anterior para avisar solo de lo nuevo.

Distribution Tag

2 operaciones
04

Returns all the dist-tags for a package

distTag.getMany

Lo que ves en n8n

Notas y casos de uso

Devuelve los dist-tags de un paquete. Un dist-tag es un nombre que apunta a una versión publicada: sirve de etiqueta estable donde si no habría que recordar un número de versión.

Parámetros clave

  • Package Name: el paquete cuyas etiquetas quieres leer.
Casos de uso
comprobar paquete por paquete a qué versión apunta cada etiqueta antes de abrir una ventana de despliegue.
05

Update a the dist-tags for a package

distTag.update

Lo que ves en n8n

Notas y casos de uso

Aquí el nodo escribe: hace que una etiqueta apunte a la versión que tú indiques. Es la única operación del nodo que cambia algo en el registro, así que su sitio está al final del flujo, después del control que aprueba la versión.

Parámetros clave

  • Package Name: el paquete al que pertenece la etiqueta.
  • Package Version: la versión a la que apunta la etiqueta tras la llamada, muchas veces traída del nodo anterior con {{ $json.field }}.
  • Distribution Tag Name: el nombre de la etiqueta que la llamada hace apuntar a la versión de arriba.
Casos de uso
cerrar una validación cambiando la etiqueta que instalan los equipos hacia la versión aprobada.
Necesitas ayuda

¿Necesitas ayuda para automatizar Npm con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Preguntas frecuentes sobre npm en n8n

01¿La integración Npm n8n es gratuita?
Sí por el lado de n8n. El nodo npm viene incluido con n8n, tanto en n8n Cloud como en una instancia que alojes tú en Community Edition, bajo licencia Sustainable Use. No hay nada que instalar ni nada extra que comprar para este nodo en concreto: lo que pagas es tu plan de n8n o el servidor donde corre. Por el lado del registro depende de la cuenta que conectes, ya que el nodo consulta el registro indicado en el credential. El flujo es idéntico en los dos modelos de alojamiento, así que puedes empezar en Cloud y llevártelo después.
02¿Qué credentials necesita el nodo npm?
Una cuenta de npm y un token de acceso de API. El credential de n8n guarda dos campos: Access Token, que generas desde la entrada Access Tokens del menú de tu perfil de npm, y Registry URL, que mantiene el valor del registro público mientras no apuntes a un registro interno. Se crea una vez en el menú Credentials y cualquier flujo de la instancia puede seleccionarlo, así que rotar el token se hace en un único sitio. De las 5 operaciones, 4 solo leen; la actualización de un dist-tag es la que escribe.
03¿Qué límites tiene el nodo npm en n8n?
Son 5 operaciones y leen mucho más de lo que escriben. Metadatos de una versión, lista de versiones, dist-tags de un paquete y búsqueda por palabra clave forman la parte de lectura. Del lado de la escritura solo está el movimiento de un dist-tag. Publicar un paquete, retirarlo, marcar una versión como obsoleta o gestionar propietarios no entra en el nodo. Dos puntos molestan en la práctica: Get Package Metadata exige una versión exacta y no solo un nombre, y la búsqueda avanza página a página con Limit y Offset. Para el resto de la API, el nodo HTTP Request toma el relevo con el mismo credential.
04¿Se puede reaccionar al instante a una publicación?
No de forma directa. npm no tiene nodo trigger en n8n, de modo que nada empuja el aviso hacia tu flujo. Necesitas otro punto de partida: un Schedule Trigger que se ejecute a intervalo fijo, liste las versiones y las compare con lo que guardaste en la vuelta anterior; un nodo Webhook, es decir una URL de n8n que llama un servicio externo, por ejemplo tu cadena de publicación; o el trigger de otra herramienta, como un repositorio de código. La primera vía encaja con paquetes ajenos. La segunda es más precisa cuando publicas tú, porque el aviso llega en el momento.
05¿n8n o Make para automatizar npm?
Depende sobre todo del alojamiento y del modelo de coste. Make lo aloja su fabricante, sin opción de instalarlo en tu servidor, y factura por operación: una vigilancia que recorre cada mañana muchos paquetes ve crecer la factura con el número de llamadas. n8n corre en Cloud o en tu propio servidor, algo que cuenta cuando el token guardado abre un registro interno y prefieres que no salga de casa. Make resulta más fácil para los primeros escenarios. n8n suma el nodo HTTP Request para cubrir lo que el nodo npm no hace, y eso suele inclinar la decisión.