n8n

​

Introducción a Firecrawl y n8n

​

¿Por qué usar Firecrawl con n8n?

• Extraen datos de cualquier sitio web de forma fiable
• Conectan los datos extraídos con otras herramientas empresariales
• Se ejecutan según una programación o se activan mediante eventos
• Escalan desde tareas simples hasta pipelines complejos

​

Paso 1: Crea tu cuenta de Firecrawl

​

Regístrate en Firecrawl

1. Ve a firecrawl.dev en tu navegador web
2. Haz clic en el botón “Empezar” o “Registrarse”
3. Crea una cuenta con tu dirección de correo electrónico o inicia sesión con GitHub
4. Verifica tu correo electrónico si se te solicita

​

Obtén tu clave de API

1. Ve al dashboard de Firecrawl
2. Accede a la página de claves de API
3. Haz clic en “Create New clave de API”
4. Asigna a tu clave un nombre descriptivo (p. ej., “n8n Integration”)
5. Copia la clave de API generada y guárdala en un lugar seguro

​

Paso 2: Configura n8n

​

Selecciona tu versión de n8n

• No requiere instalación
• Plan Free disponible
• Infraestructura gestionada
• Actualizaciones automáticas

• Control total sobre los datos
• Se ejecuta en tus propios servidores
• Requiere instalar Docker
• Ideal para usuarios avanzados con requisitos de seguridad específicos

​

Opción A: n8n Cloud (recomendado para principiantes)

1. Visita n8n.cloud
2. Haz clic en “Start Free” o “Sign Up”
3. Regístrate con tu dirección de correo electrónico o GitHub
4. Completa el proceso de verificación
5. Accederás a tu dashboard de n8n

​

Opción B: Autogestionado con Docker

• Docker Desktop instalado en tu equipo
• Conocimientos básicos de la línea de comandos o la terminal

1. Abre la terminal o el símbolo del sistema
2. Crea un volumen de Docker para conservar los datos de tu flujo de trabajo:

docker volume create n8n_data

3. Ejecuta el contenedor de Docker de n8n:

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

4. Espera a que n8n se inicie. Verás una salida que indica que el servidor está en funcionamiento.
5. Abre el navegador web y ve a http://localhost:5678
6. Crea tu cuenta de n8n registrándote con una dirección de correo electrónico

​

Conocer la interfaz de n8n

• Flujos de trabajo: Aquí aparecen tus automatizaciones guardadas
• Ejecuciones: Historial de ejecuciones de los flujos de trabajo
• Credenciales: Claves de API y tokens de autenticación almacenados
• Configuración: Configuración de la cuenta y el espacio de trabajo

​

El lienzo del flujo de trabajo

• Lienzo: El área principal donde colocas y conectas nodos
• Botón Añadir nodo (+): Haz clic para añadir nuevos nodos a tu flujo de trabajo
• Panel de nodos: Se abre al hacer clic en ”+” y muestra todos los nodos disponibles
• Ejecutar flujo de trabajo: Ejecuta manualmente tu flujo de trabajo para probarlo
• Guardar: Guarda la configuración de tu flujo de trabajo

​

Paso 3: Instala y configura el nodo de Firecrawl

​

Añade el nodo de Firecrawl a tu flujo de trabajo

1. En el lienzo de tu nuevo flujo de trabajo, haz clic en el botón ”+” del centro
2. Se abrirá el panel de selección de nodos en el lado derecho
3. En el cuadro de búsqueda de la parte superior, escribe “Firecrawl”
4. Verás que el nodo de Firecrawl aparece en los resultados de búsqueda

5. Haz clic en “Instalar” junto al nodo de Firecrawl
6. Espera a que finalice la instalación (tardará unos segundos)
7. Una vez instalado, haz clic en el nodo de Firecrawl para añadirlo al lienzo

​

Conecta tu clave de API de Firecrawl

1. Haz clic en el recuadro del nodo de Firecrawl para abrir su panel de configuración a la derecha.
2. En la parte superior, verás un menú desplegable llamado “credencial para conectarse”.
3. Como es la primera vez que lo haces, haz clic en “crear nueva credencial”.

4. Se abrirá una ventana de configuración de credenciales.
5. Introduce un nombre para esta credencial (por ejemplo, “Mi cuenta de Firecrawl”).
6. Pega tu clave de API de Firecrawl en el campo “clave de API”.
7. Haz clic en “Save” en la parte inferior.

​

Prueba la conexión

1. Con el nodo de Firecrawl todavía seleccionado, revisa el panel de configuración.
2. Establece Recurso en “Scraping” y Operación en “Scrape URL”.
3. En el campo “URL”, introduce: https://firecrawl.dev.
4. Por ahora, deja el resto de la configuración con los valores predeterminados.
5. Haz clic en el botón “Execute step”.

​

Paso 4: Crea tu bot de Telegram

​

Crea un bot con BotFather

1. Abre Telegram en tu teléfono o computadora
2. Busca “@BotFather” (el bot oficial de Telegram)
3. Inicia una conversación con BotFather haciendo clic en “Start”
4. Envía el comando /newbot para crear un nuevo bot
5. BotFather te pedirá que elijas un nombre para tu bot (este es el nombre que verán los usuarios)
6. Introduce un nombre como “My Firecrawl Bot”
7. A continuación, elige un nombre de usuario para tu bot. Debe terminar en “bot” (p. ej., “my_firecrawl_updates_bot”)
8. Si el nombre de usuario está disponible, BotFather creará tu bot y te enviará un mensaje con el token de tu bot

​

Obtén tu ID de chat

1. Abre el navegador web y visita esta URL (sustituye YOUR_BOT_TOKEN por el token de tu bot):
   https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
   
2. Mantén abierta esta pestaña del navegador
3. Busca el nombre de usuario de tu bot en Telegram (el que acabas de crear)
4. Inicia una conversación con tu bot haciendo clic en “Iniciar”
5. Envía cualquier mensaje a tu bot (por ejemplo, “hola”)
6. Vuelve a la pestaña del navegador y actualiza la página
7. Busca el campo "chat":{"id": en la respuesta JSON
8. El número junto a "id": es tu ID de chat (por ejemplo, 123456789)
9. Guarda este ID de chat para usarlo más adelante

​

Paso 5: Crea flujos de trabajo prácticos con Telegram

​

Ejemplo 1: Resumen diario de actualizaciones de producto de Firecrawl

• Hace scraping del blog de actualizaciones de producto de Firecrawl todos los días a las 9:00
• Usa IA para generar un resumen del contenido
• Envía el resumen a Telegram

1. Crea un nuevo flujo de trabajo en n8n
2. Añade un nodo Schedule Trigger:
   • Haz clic en el botón ”+” del lienzo
   • Busca “Schedule Trigger”
   • Configúralo para que se ejecute todos los días a las 9:00

3. Añade el nodo Firecrawl:
   • Haz clic en ”+” junto a Schedule Trigger
   • Busca y añade “Firecrawl”
   • Selecciona tu credencial de Firecrawl
   • Configura:
     • Recurso: Extracción de datos
     • Operación: Extraer contenido de una URL
     • URL: https://www.firecrawl.dev/blog/category/product-updates
     • Opciones de extracción: Añade Formats y selecciona “Resumen”

4. Añade el nodo Telegram:
   • Haz clic en ”+” junto a Firecrawl
   • Busca “Telegram”
   • Haz clic en “Send a text message” para añadirlo al lienzo
5. Configura las credenciales de Telegram:
   • Haz clic en el nodo Telegram para abrir su configuración
   • En el menú desplegable “Credencial para conectarse”, haz clic en “Crear nueva credencial”
   • Pega el token de tu bot de BotFather
   • Haz clic en “Guardar”

6. Configura el mensaje de Telegram:
   • Operación: Enviar mensaje
   • ID de chat: Introduce tu ID de chat
   • Texto: Por ahora, deja el mensaje “hello”
   • Haz clic en Ejecutar paso para probar el envío de un mensaje y recibir el resumen de Firecrawl.

• Ahora que tienes la estructura del resumen de Firecrawl, añade el resumen al texto del mensaje arrastrando el campo summary (dentro de data) desde la salida del nodo Firecrawl.

7. Prueba el flujo de trabajo:
   • Haz clic en “ejecutar flujo de trabajo”
   • Revisa Telegram para ver el mensaje con el resumen

8. Activa el flujo de trabajo con el interruptor “Active”

​

Ejemplo 2: Búsqueda de noticias de IA en Telegram

• Usa un Manual Trigger en lugar de Schedule (se ejecuta bajo demanda)
• Usa la operación Search en lugar de scraping
• Incluye un nodo Code para formatear varios resultados

1. Crea un nuevo flujo de trabajo y añade un nodo Manual Trigger
2. Añade un nodo Firecrawl con esta configuración:
   • Resource: Map & Search
   • Operation: Search Web
   • Query: ai news
   • Limit: 5

3. Añade un nodo Code para formatear los resultados de búsqueda:
   • Selecciona “Ejecutar una vez para todos los elementos”
   • Pega este código:

const results = $input.all();
let message = "Latest AI News:\n\n";

results.forEach((item) => {
  const webData = item.json.data?.web || [];
  webData.forEach((article, index) => {
    message += `${index + 1}. ${article.title}\n`;
    message += `${article.description}\n`;
    message += `${article.url}\n\n`;
  });
});

return [{ json: { message } }];

4. Actualiza el nodo Telegram (con tu credencial guardada):
   • Texto: Arrastra el campo message desde el nodo Code

​

Ejemplo 3: Resumen de noticias con IA

• Configurar las credenciales de OpenAI
• Añadir el nodo agente de IA entre Code y Telegram
• agente de IA analiza y resume de forma inteligente todos los artículos de noticias
• Telegram recibe el resumen generado por IA en lugar de la lista de noticias sin procesar

1. Obtén tu clave de API de OpenAI:
   • Ve a platform.openai.com/api-keys
   • Inicia sesión o crea una cuenta
   • Haz clic en “Create new secret key”
   • Asígnale un nombre (p. ej., “n8n Integration”)
   • Copia la clave de API inmediatamente (no podrás volver a verla)

2. Añade y conecta el nodo agente de IA:
   • Haz clic en ”+” después del nodo Code
   • Busca “Basic LLM Chain” o “agente de IA”
   • Arrastra el campo message del nodo Code al campo del prompt de entrada de agente de IA
   • Selecciona OpenAI como proveedor de LLM

3. Añade tus credenciales de OpenAI:
   • Haz clic en “crear nueva credencial” para OpenAI
   • Pega tu clave de API de OpenAI
   • Selecciona el modelo: gpt-5-mini (económico) o gpt-5 (más capaz)
   • Haz clic en “Save”

4. Añade el System prompt a agente de IA:
   • En el nodo agente de IA, añade este System prompt:

Eres un analista de noticias sobre IA. Analiza los artículos de noticias de IA proporcionados y crea un resumen
conciso y revelador que destaque los avances y las tendencias más importantes.
Agrupa los temas relacionados y aporta contexto sobre por qué estos avances son relevantes.
Mantén un tono cercano y ameno en el resumen, de unos 3 o 4 párrafos.

5. Actualiza el nodo de Telegram y pruébalo:
   • Actualiza el nodo de Telegram:
     • Texto: Arrastra la salida del agente de IA (el resumen generado)
     • Elimina el mapeo anterior al mensaje del nodo Code
   • Haz clic en “ejecutar flujo de trabajo” para probarlo
   • La IA analizará todos los artículos de noticias y creará un resumen
   • Revisa Telegram para ver el resumen generado por la IA

​

Operaciones de Firecrawl

​

Extraer contenido de una URL

• Hace scraping de una sola URL
• Devuelve markdown limpio, HTML o resúmenes generados por IA
• Devuelve datos estructurados con el formato JSON y un prompt o esquema
• Puede capturar capturas de pantalla y extraer enlaces

• Extracción de artículos
• Monitoreo de páginas de productos
• Scraping de publicaciones de blog
• Generación de resúmenes de páginas

​

Interact

• Execute Interaction: ejecuta un prompt o código sobre una página extraída, usando el scrapeId de la salida de Scrape URL (data.metadata.scrapeId)
• Stop Interaction: finaliza la sesión de Interact para ese scrapeId
• Get Interact Context: devuelve instrucciones de uso para agentes de IA que llaman a estas operaciones como herramientas

{
  "profile": {
    "name": "my-profile",
    "saveChanges": true
  }
}

​

Buscar en la web

• Busca en la web, noticias o images
• Devuelve títulos, descripciones y URL
• Opcionalmente, hace scraping del contenido completo de los resultados

• Automatización de la investigación
• Supervisión de noticias
• Detección de tendencias
• Encontrar contenido relevante

​

Crawl Website

• Sigue enlaces automáticamente
• Scrapea varias páginas en un solo trabajo
• Puede filtrar URL por patrones
• Devuelve el ID de la tarea de rastreo; añade un segundo nodo de Firecrawl con Get Crawl Status para leer las páginas extraídas

• Extracción completa de documentación
• Archivado de sitios
• Recopilación de datos de varias páginas

​

Mapear sitio web

• Descubre enlaces de un sitio
• Devuelve una lista limpia de URL
• Rápido y ligero

• Descubrimiento de URL
• Generación de mapas de sitio
• Planificación de crawls más grandes

​

Extracción por Lotes de URLs

• Procesa una lista de URLs de una sola vez, con las mismas opciones de extracción para cada una
• Es más eficiente que usar bucles
• Devuelve un ID de trabajo por lotes; agrega Obtener estado de Extracción por Lotes para leer todos los resultados a la vez

• Procesar listas de URLs
• Recopilación masiva de datos
• Proyectos de scraping a gran escala

​

Agente

• Acepta un prompt que describe los datos que necesitas, además de URLs opcionales y un esquema JSON
• El agente de IA navega y extrae información de forma autónoma
• Disponible como Extract Data With AI Agent (espera los resultados) y Start AI Agent Job (Async) (devuelve un ID de trabajo de inmediato)
• Usa Get Agent Status para consultar los resultados cuando utilices la operación async

• Recopilación compleja de datos en varias páginas guiada por un prompt
• Extraer información cuando no conoces la estructura exacta de la página
• Tareas de investigación que requieren navegar por varias páginas

• Extract Data With AI Agent inicia el trabajo y espera el resultado en un solo paso, la opción más sencilla para la mayoría de los casos de uso. El parámetro Max Wait Time controla durante cuánto tiempo el nodo consulta el estado antes de agotar el tiempo de espera (predeterminado: 300 segundos; máximo: 600 segundos). Si la tarea del agente tarda más, el nodo devuelve un estado timeout con el jobId, aunque el trabajo todavía pueda completarse en Firecrawl. Pasa ese ID a Get Agent Status o usa la operación async para trabajos que puedan superar los 10 minutos.
• Start AI Agent Job (Async) devuelve un ID de trabajo de inmediato. Añade un segundo nodo de Firecrawl con la operación Get Agent Status para recuperar los resultados cuando finalice el trabajo.

​

Extraer datos estructurados (heredado)

​

Sandbox del navegador

• Crear sesión del navegador: inicia una nueva sesión del navegador y devuelve su id
• Ejecutar código del navegador: ejecuta código Node (Playwright), Python o Bash en la sesión, usando el id del paso de creación como Session ID
• Obtener varias sesiones del navegador: muestra las sesiones activas o eliminadas
• Eliminar sesión del navegador: finaliza una sesión cuando termines
• Obtener contexto del navegador: devuelve instrucciones de uso y las sesiones activas para los agentes de IA que llaman a estas operaciones como herramientas

• Flujos de trabajo del navegador de varios pasos que requieren mantener el estado entre páginas
• Navegación dinámica entre páginas cuando el número de pasos se desconoce de antemano
• Flujos de trabajo que usan perfiles persistentes del navegador para conservar las cookies y el localStorage entre ejecuciones

​

Cuenta

​

Plantillas y ejemplos de flujos de trabajo

​

Plantillas destacadas

​

Cómo importar plantillas

1. Haz clic en el enlace de una plantilla de flujo de trabajo.
2. En la página de la plantilla, haz clic en el botón “Importar plantilla a la instancia autogestionada localhost:5678”.
3. El flujo de trabajo se abrirá en tu instancia de n8n.
4. Configura las credenciales de cada nodo.
5. Personaliza la configuración según tu caso de uso.
6. Activa el flujo de trabajo.

​

Prácticas recomendadas

​

Pruebas y depuración

• Prueba siempre los flujos de trabajo manualmente antes de activar las programaciones
• Usa el botón “ejecutar flujo de trabajo” para probar todo el flujo
• Comprueba los datos de salida en cada nodo para verificar que sean correctos
• Usa la pestaña “Executions” para revisar ejecuciones anteriores y depurar problemas

​

Manejo de errores

• Añade nodos Error Trigger para detectar y gestionar fallos
• Configura notificaciones cuando fallen los flujos de trabajo
• Usa la configuración “Continue On Fail” en nodos no críticos
• Supervisa periódicamente las ejecuciones de tus flujos de trabajo

​

Optimización del rendimiento

• Usa extracción por lotes para varias URL en lugar de bucles
• Establece límites de tasa adecuados para evitar sobrecargar los sitios de destino
• Almacena los datos en caché cuando sea posible para reducir solicitudes innecesarias
• Programa flujos de trabajo intensivos durante las horas de menor actividad

​

Seguridad

• Nunca expongas las claves de API en las configuraciones de los flujos de trabajo
• Usa el sistema de credenciales de n8n para almacenar de forma segura la información de autenticación
• Ten cuidado al compartir flujos de trabajo públicamente
• Respeta los términos de servicio y el archivo robots.txt de los sitios web objetivo

​

Próximos pasos

​

Explora funciones avanzadas

• Consulta las configuraciones de webhook para procesar datos en tiempo real
• Experimenta con la extracción basada en IA mediante prompts y schemas
• Crea flujos de trabajo complejos de varios pasos con lógica condicional

​

Únete a la comunidad

• Firecrawl Discord - Obtén ayuda con Firecrawl y conversa sobre web scraping
• Foro de la comunidad de n8n - Haz preguntas sobre automatización de flujos de trabajo
• Comparte tus flujos de trabajo y aprende de los demás

​

Ruta de aprendizaje recomendada

1. Completa los flujos de trabajo de ejemplo de esta guía
2. Modifica las plantillas de la biblioteca de la comunidad
3. Crea un flujo de trabajo para resolver un problema real en tu trabajo
4. Explora las operaciones avanzadas de Firecrawl
5. Comparte tus propias plantillas para ayudar a otras personas

​

Recursos adicionales

• Documentación de la API de Firecrawl
• Documentación de n8n
• Prácticas recomendadas para el scraping web