Envío para el AI Agents Challenge powered by n8n and Bright Data
Qué construí
Desarrollé un Agente Inteligente de Monitorización de Marcas y Palabras Clave que se ejecuta cada 2 horas, rastrea la web en busca de menciones y envía informes curados directamente a tu correo. Es como un asistente incansable que analiza cientos de publicaciones mientras duermes, filtra el ruido y resalta lo que realmente importa.
El problema que resuelve es claro: la monitorización manual de marca es abrumadora e incompleta. O te ahogas en menciones irrelevantes o te pierdes conversaciones importantes. Este agente encuentra el punto óptimo entre cobertura amplia e insights accionables.
Demo
Ver demo en video
El sistema procesa de forma autónoma cientos de posibles menciones y entrega solo los hallazgos relevantes mediante informes por correo con formato claro.
Workflow en n8n
Ver diagrama del workflow
Descargar JSON del workflow N8N BrightMentions
Guía de configuración
1 Importar y clonar
- Importa el JSON del workflow en tu instancia de n8n
- Clona esta base de datos de Airtable en tu cuenta
2 Conecta tus servicios
- Airtable: crea un token para tu base BrightMentions
- Bright Data: conecta tu cuenta y crea dos zonas llamadas serp_api1 y web_unlocker1
- OpenRouter: añade tus credenciales de API recomendado por su flexibilidad de límites
- SMTP: configura las credenciales de correo para notificaciones
3 Configura tus parámetros
- Sigue las notas amarillas dentro del workflow
- Define palabras clave, URLs de exclusión y destinatarios de correo en Airtable
Activa el workflow y la monitorización comenzará automáticamente.
Implementación técnica
Configuración del agente de IA
Ver captura del agente de IA
Instrucciones de sistema: el corazón es un prompt que convierte a la IA en un analista especializado en menciones. Más allá del sentimiento genérico, entiende contexto, niveles de urgencia y estrategias de respuesta. Evalúa cada mención en múltiples dimensiones: intensidad del sentimiento, impacto potencial, influencia del autor y acciones recomendadas.
Elección de modelos: usé los modelos GPT 4.1 mini y nano de OpenAI a través de OpenRouter por dos razones clave
- Ventanas de contexto muy amplias capaces de manejar contenido largo extraído sin topar con límites de tokens, crucial para analizar publicaciones extensas o artículos detallados
- Sin limitaciones de tasa en OpenRouter, lo que evita bloqueos del flujo durante picos de volumen
Memoria: el agente es sin estado por diseño. Cada análisis de mención es independiente y recibe todo el contexto en el prompt. Esto aporta consistencia y elimina errores asociados a memoria en flujos automatizados.
Herramientas: el agente utiliza el Structured Output Parser de n8n para asegurar respuestas JSON bien formateadas. Esta validación evita errores de parsing que podrían interrumpir el flujo. Todo el análisis ocurre dentro de una única instrucción de sistema que guía una evaluación estructurada.
El prompt exige un JSON con sentimiento, urgencia, evaluación de impacto y recomendaciones de respuesta, convirtiendo menciones crudas en datos accionables.
Bright Data Verified Node
Bright Data hace posible el carácter imparable del flujo. En vez de construir y mantener scrapers para decenas de plataformas, aprovecho sus soluciones listas que manejan la complejidad.
Scrapers verificados preconstruidos: el sistema usa 18 scrapers de Bright Data que cubren grandes plataformas como X, Instagram, Facebook, LinkedIn, TikTok, BlueSky, YouTube, Pinterest y Reddit entre otras.
Integración con SERP API: resultados de Google limpios y estructurados sin CAPTCHAs ni barreras antibots. La zona serp_api gestiona consultas con filtros de tiempo y exclusiones.
Web Unlocker: para URLs fuera de los scrapers preconstruidos, extrae contenido de prácticamente cualquier sitio y elude protecciones antibot de forma automática.
Procesamiento por lotes: el workflow usa snapshot IDs para paralelizar eficientemente. Envías múltiples URLs, recibes un snapshot ID y luego consultas hasta completar. Escala de manera natural con las necesidades de monitorización.
La fiabilidad marca la diferencia frente a soluciones DIY. Si Instagram cambia su interfaz, los scrapers de Bright Data se adaptan. Si un sitio estrena detección de bots, Web Unlocker lo gestiona de forma transparente.
Recorrido
Desafíos clave
El problema de la ambigüedad de palabras clave: las primeras versiones capturaban cada mención sin contexto. Monitorizar n8n devolvía abreviaturas, códigos postales y coincidencias aleatorias.
Solución: filtrado consciente del contexto. El sistema obtiene contexto de las URLs para entender qué representa cada término y usa IA para filtrar resultados de búsqueda antes de extraer contenido costoso.
Complejidad en el enrutamiento de URLs: al inicio se usaron switch cases para enviar URLs al scraper adecuado. Algunas fallaban en Web Unlocker pero funcionaban con scrapers preconstruidos, generando fallos impredecibles.
Solución: enrutamiento basado en expresiones regulares que clasifica URLs y elige el método óptimo de extracción. Más limpio y robusto ante casos límite.
Fiabilidad a escala: el scraping falla con frecuencia. Las primeras versiones se caían si fallaba una petición y se perdían lotes enteros.
Solución: manejo de errores con notificaciones por correo. Las extracciones fallidas se registran y reportan mientras las exitosas continúan. Visibilidad y resiliencia de extremo a extremo.
Claves técnicas
El contexto lo es todo: comprender lo que realmente buscas separa el valor del spam. La extracción automática de contexto desde URLs elevó drásticamente la precisión.
El enrutamiento inteligente importa: categorizar URLs y dirigirlas al método ideal preconstruido o Web Unlocker optimiza velocidad y fiabilidad.
Arquitecturas simples escalan mejor: análisis de IA sin estado en lugar de memorias complejas mantiene el flujo mantenible y predecible.
Resultados
- Cobertura integral 24x7 en las principales plataformas
- Alta precisión gracias al filtrado sensible al contexto que elimina menciones irrelevantes
- Eficiencia de costos mediante pago por uso alineado al volumen real
- Cero mantenimiento porque Bright Data gestiona cambios de plataformas
- Insights accionables con recomendaciones de respuesta y no solo datos crudos