Recursos · Integración n8n

Integración urlscan.io n8nAutomatiza urlscan.io con n8n.

Un enlace sospechoso entra por cualquier canal y el flujo devuelve el veredicto sin que nadie abra el navegador. La integración urlscan.io n8n cabe en un nodo de 3 operaciones sobre 1 recurso: lanzar un escaneo, buscar entre los anteriores y recuperar uno por su identificador.

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

Por qué automatizar

¿Qué hace de verdad la integración urlscan.io n8n?

urlscan.io abre una página en su propio navegador y apunta todo lo que ocurre: los dominios que contacta, los archivos que carga, una captura de pantalla y un veredicto sobre la página. El nodo de n8n convierte ese servicio en 3 pasos que colocas entre otros dos nodos, así que un enlace que llega a cualquier buzón queda revisado sin que nadie lo pegue a mano en una web.

Todo funciona con un único credential, la credencial que n8n guarda una vez y ofrece luego en un desplegable.

Primer escenario, la atención al cliente de una tienda online. Llega un correo con un enlace raro, un paso de Gmail lo lee, el nodo lanza el escaneo sobre ese enlace y el resultado aterriza en el canal de guardia de Slack. Esa es la forma de la plantilla pública Scan URLs with urlscan.io and Send Results via Gmail (6946), y del flujo de análisis de phishing (1992), que añade una llamada HTTP Request a un segundo servicio de reputación.

Segundo escenario, la vigilancia de marca. Un Schedule Trigger arranca cada mañana, Get Many lanza una Query del estilo domain:n8n.io y los escaneos encontrados se guardan en una tabla MySQL que se convierte en el histórico consultable del equipo. La plantilla de vigilancia de certificados (12221) aplica la misma idea a dominios recién registrados que imitan una marca.

Tercer escenario, enriquecer un ticket. El escaneo se lanza al abrir el ticket y una rama posterior recupera el informe terminado por su identificador para adjuntarle la captura y la lista de dominios contactados.

El nodo cubre solo el recurso Scan. Para el resto de la API de urlscan.io entra el nodo HTTP Request, que reutiliza ese mismo credential mediante la autenticación predefinida en lugar de obligarte a montar una cabecera a mano.

Dos límites conviene tenerlos claros antes de montar nada. No existe un trigger de urlscan.io en n8n, es decir que nada del lado de urlscan.io puede despertar un flujo por su cuenta. Y un escaneo no es instantáneo por naturaleza: la página tiene que cargarse y quedar registrada, y por eso lanzarlo y leerlo son dos operaciones separadas. Si quieres la mirada amplia sobre la plataforma, la Reseña n8n cuenta para qué sirve bien.

Conexión

¿Cómo se conecta urlscan.io con n8n?

  1. 01

    Abre una cuenta de urlscan.io

    El credential necesita una cuenta en urlscan.io, así que empieza por ahí si el equipo todavía no tiene una. Esa cuenta es la que guardará los escaneos, y eso pesa después: el ajuste Visibility de un escaneo decide si queda privado para esa cuenta o si se ve desde fuera, y la operación de búsqueda lee lo que la cuenta alcanza a ver.

  2. 02

    Genera la clave API

    Dentro de urlscan.io entra en Settings & API, luego API Keys, y crea una clave. Una clave API es una cadena larga que sustituye a la contraseña cuando un programa habla con el servicio, así que trátala igual de bien. Cópiala cuando te la muestre. Es el único método de autenticación que acepta el nodo: ni flujo OAuth ni selector de autenticación.

  3. 03

    Guarda el credential en n8n

    En n8n abre el menú Credentials, crea un credential de urlscan.io y pega el valor en el campo API Key. Un credential vive fuera del flujo de trabajo: lo creas una vez y cualquier nodo de urlscan.io de la instancia lo encuentra en su desplegable, tanto si la instancia corre en n8n Cloud como en tu propio Docker.

Acciones

Lo que sabe hacer el nodo de urlscan.io

El nodo urlscan.io expone 3 operaciones en 1 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoGetGet ManyPerform
Scan✓✓✓

Scan

3 operaciones
01

Get a scan

scan.get

Lo que ves en n8n

Notas y casos de uso

Recupera un escaneo ya terminado y devuelve su resultado completo: la página cargada, los dominios alcanzados y el veredicto asociado.

Parámetros clave

  • Scan ID: el escaneo que quieres recuperar. El nodo no marca ningún campo como obligatorio aquí, pero sin identificador no tiene a qué apuntar, así que el valor suele venir de una expresión, {{ $json.scanId }}, que arrastra el dato del paso que lanzó el escaneo.
Casos de uso
un agente marca un enlace, el escaneo sale al abrirse el ticket y una rama posterior recoge el informe acabado para adjuntarlo a ese mismo ticket.
02

Get many scans

scan.getAll

Lo que ves en n8n

Notas y casos de uso

Buscar en vez de recuperar: esta operación devuelve una lista de escaneos que coinciden con una búsqueda, un item por escaneo.

Parámetros clave

  • Query: vive en la colección Filters y espera la sintaxis Elastic Search query string, por ejemplo domain:n8n.io, aplicada a los campos que urlscan.io documenta para la búsqueda.
  • Return All: activado, n8n recorre las páginas de la API hasta traer todos los escaneos que coinciden.
  • Limit: con Return All desactivado, marca cuántos escaneos como mucho pasan al paso siguiente.
Casos de uso
un repaso matinal que reúne cada escaneo registrado sobre un dominio propio.
03

Perform a scan

scan.perform

Lo que ves en n8n

Notas y casos de uso

Envía una URL para que urlscan.io la cargue en su entorno aislado y registre la visita. Este paso crea el escaneo; leer el resultado es una llamada aparte.

Parámetros clave

  • URL: la dirección a escanear, con la forma https://n8n.io, muchas veces alimentada por {{ $json.url }} desde el nodo anterior.
  • Visibility: private, public o unlisted, decide quién podrá ver el escaneo después.
  • Tags: una lista separada por comas, tipo phishing, malicious, con un tope de 10 tags por escaneo.
Casos de uso
la colección Additional Fields trae además Custom Agent, Referer y Override Safety, útiles cuando una página fraudulenta solo se muestra con cierto user agent.
Necesitas ayuda

¿Necesitas ayuda para automatizar urlscan.io con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

urlscan.io y n8n, las preguntas que vienen después

01¿La integración urlscan.io n8n es gratis?
Del lado de n8n, sí. El nodo de urlscan.io viene incluido en n8n, así que no hay nada que instalar, nada que comprar aparte y ninguna diferencia entre ejecutarlo en n8n Cloud o en una instancia que alojas tú con Docker o con npm. El mismo flujo se comporta igual en los dos sitios. Lo que sí necesitas es una cuenta de urlscan.io, porque el credential es una clave API que emite esa cuenta. Lo que cueste esa cuenta se resuelve con urlscan.io, no con n8n.
02¿Qué credenciales hacen falta para el nodo de urlscan.io?
Una clave API, y es el único método de autenticación que admite el nodo. Creas una cuenta de urlscan.io, entras en Settings y API, luego API Keys, generas una clave y la pegas en el campo API Key de un credential de urlscan.io dentro de n8n. No hay pantalla de OAuth, ni scopes que marcar, ni selector de autenticación en el nodo, así que la configuración es idéntica para las 3 operaciones. Crea el credential una vez desde el menú Credentials y cualquier flujo de la instancia podrá elegirlo en el desplegable.
03¿Qué límites tiene el nodo de urlscan.io en n8n?
El nodo cubre un solo recurso, Scan, con 3 operaciones: recuperar uno, buscar varios y lanzar uno nuevo. El resto de la API de urlscan.io no está envuelto en el nodo, y la salida para eso es HTTP Request, que reutiliza el mismo credential de urlscan.io con la autenticación predefinida sin obligarte a montar la llamada a mano. En la parte de búsqueda, vigila Return All: si lo dejas desactivado solo salen tantos escaneos como permita Limit, que es la razón habitual de un informe más corto de lo esperado.
04¿urlscan.io dispara un flujo de n8n en tiempo real?
No, porque no existe un nodo trigger de urlscan.io en n8n. Nada del lado de urlscan.io puede despertar un flujo, así que el punto de partida lo eliges tú. Un Schedule Trigger lanza el flujo cada cierto intervalo fijo, que encaja con una búsqueda recurrente sobre un dominio. Un Webhook de n8n, o sea una URL a la que llama otro servicio, encaja cuando es ese servicio el que empuja la URL a revisar. Y el trigger de otra herramienta, un mensaje nuevo o una fila nueva, encaja con el triaje del buzón. El escaneo se lanza primero y se lee después.
05¿n8n o Make para urlscan.io?
Depende de dónde quieras que corra el flujo y de cómo prefieras pagarlo. Make lo aloja Make, sin opción de alojarlo tú, y se factura por operación, así que un bucle de escaneos que gira a menudo tiene un coste que sube con el volumen. n8n se instala en tu propio servidor, lo que mantiene las URL analizadas y los resultados dentro de tu infraestructura, y su modelo de coste no va por operación. Make suele leerse más rápido para quien empieza con la automatización visual. Si el control del dato pesa en tu equipo de seguridad, la decisión se toma sola.