Zulunity
Tu socio tecnologico integral
Propuesta de Desarrollo
Social Media Monitoring System
MVP v1.0 — Monitoreo Automatizado de Redes Sociales
Confidencial
1. Resumen Ejecutivo
Requerimientos del Cliente
Portman Square Group requiere un sistema que monitoree automaticamente sus menciones e informacion relevante en Facebook, LinkedIn, X y Threads. El sistema debe ejecutar escaneos periodicos (cada 30 minutos), evaluar la relevancia de los hallazgos mediante inteligencia artificial, almacenar los resultados de forma centralizada en Notion, y enviar notificaciones en tiempo real al canal de comunicacion que el cliente elija (Slack, WhatsApp o Telegram).
La Solucion
Un agente inteligente basado en Claude que, de forma automatica y periodica, escanea las 4 redes sociales en busca de informacion relevante segun identificadores configurados. Los hallazgos se almacenan en Notion como base de datos centralizada y se notifican en tiempo real al canal elegido por el cliente.
- Automatizacion total: Elimina la necesidad de revisar manualmente multiples redes sociales.
- Inteligencia semantica: El agente utiliza comprension contextual para evaluar relevancia, sentimiento y urgencia — no solo palabras clave.
- Notificaciones a su canal preferido: El cliente elige un canal de notificacion (Slack, WhatsApp o Telegram) segun su flujo de trabajo.
- Costo operativo minimo: Arquitectura serverless en GCP que solo consume recursos cuando ejecuta escaneos.
Cifras Clave
6
Semanas
$2,000
MXN/semana
6
Modulos
3
Roles
Stack Tecnologico
| Componente | Tecnologia |
|---|---|
| Lenguaje / Runtime | TypeScript / Node.js 20 |
| Agente IA | Claude Sonnet 4.5 (Anthropic SDK) |
| Persistencia | Notion API (unica capa de datos) |
| Cloud | Google Cloud Platform (Cloud Run, Scheduler, Secret Manager) |
| Contenedores | Docker (multi-stage, node:20-alpine) |
| IaC | Pulumi (TypeScript) |
| CI/CD | GitLab CI/CD + Artifact Registry |
2. Descripcion de la Solucion
El sistema se compone de 6 modulos con responsabilidades claras, organizados bajo Clean Architecture con Strategy Pattern para conectores y notificadores intercambiables.
2.1 Modulos del Sistema
Scan Engine
Coordina la ejecucion de la Claude Skill con los conectores sociales. Ejecuta busquedas en paralelo usando
Promise.allSettled y filtra resultados por umbral de relevancia configurable.Claude Skill
Skill especializada con dos modos: generacion de queries optimizadas por red social y evaluacion de relevancia con scoring 0-100 + analisis de sentimiento.
Notion Storage
Unica capa de persistencia. Gestiona 3 tablas: Identificadores, Hallazgos y Logs. Incluye deduplicacion por hash SHA-256 y batching con delay de 350ms.
Notification Engine
Distribuye hallazgos al canal de notificacion elegido por el cliente (Slack, WhatsApp o Telegram) con Strategy Pattern. Throttling de 20 notificaciones/ciclo y retry con backoff exponencial (max 3 intentos).
Orchestrator
Punto de entrada del ciclo de escaneo. Coordina carga de identificadores, escaneo, deduplicacion, notificaciones y logging. Fail gracefully por identificador.
CI/CD & Infra
Pipeline automatizado en GitLab: lint, test, security scan (Trivy + npm audit + Semgrep), build Docker, deploy a Cloud Run. IaC con Pulumi para GCP.
2.2 Arquitectura del Sistema
Diagrama de Arquitectura — 3 Capas
Capa de Orquestacion
Cloud Scheduler + Cloud Run Job
Cloud Scheduler (*/30 * * * *)
Orchestrator
Execution Logger
Error Handler
↓
Capa de Aplicacion
TypeScript / Node.js 20
Scan Engine
Claude Skill Executor
Notifier Engine
Deduplication Service
Relevance Filter
Message Formatter
↓
Capa de Infraestructura
APIs Externas + GCP
X API v2
Meta Graph API
Threads API
LinkedIn API
Notion API
Anthropic API
Notificaciones (Slack / WhatsApp / Telegram)
Secret Manager
Orquestacion
Aplicacion
Infraestructura
2.3 Flujo del Ciclo de Escaneo
Flujo del Sistema — Secuencia 1→7
1
Scheduler
Trigger cada 30 min
2
Load IDs
Notion → Identifiers
3
Generate Queries
Claude Skill Mode 1
- Interpretar contexto del identificador
- Generar 3-5 queries por red social
- Adaptar formato por API
4
Scan Networks
4 redes en paralelo
- X API v2 (Recent Search)
- Facebook (Graph API)
- LinkedIn (API + fallback)
- Threads (Meta API)
5
Evaluate
Claude Skill Mode 2
- Score de relevancia 0-100
- Analisis de sentimiento
- Resumen conciso (280 chars)
- Filtro por umbral
6
Dedup & Save
Hash SHA-256 → Notion
7
Notify
Canal elegido por cliente
- Slack (Incoming Webhook)
- WhatsApp (Twilio/Meta)
- Telegram (Bot API)
Orchestrator
Claude Skill
Scan Engine
Notifier
Click en un paso para expandir sub-etapas
2.4 Circuit Breaker — Resiliencia por Red Social
Cada conector social implementa un Circuit Breaker independiente que permite al sistema continuar operando incluso cuando una red social falla:
Circuit Breaker — Maquina de Estados
CLOSED
Operacion normal
OPEN
Fallos consecutivos ≥3
HALF-OPEN
Prueba de recuperacion
CLOSED
Recuperado
SKIP
Red social omitida
RETRY
Backoff exponencial
FAILED
Log + continuar ciclo
failureCount
lastFailureTime
cooldownPeriod
isAvailable()
Closed (normal)
Open (fallo)
Half-Open (prueba)
Error/Failed
Retry
2.5 Principios de Diseno
"Serverless-first. Clean Architecture. Plugin-based integrations. Fail gracefully. Idempotencia. Observability by default."
- Serverless-first: Sin servidores persistentes. Scale to zero cuando no hay ejecucion.
- Plugin-based: Cada red social y canal de notificacion es un plugin intercambiable que implementa una interfaz comun (Strategy Pattern).
- Fail gracefully: La falla de una red social o un canal de notificacion no detiene el ciclo completo.
- Idempotencia: Ejecutar el mismo ciclo dos veces produce el mismo resultado sin duplicados (hash-based dedup).
3. Alcance y Entregables
A continuacion se detallan las 10 funcionalidades Must-Have que conforman el MVP, asi como las exclusiones explicitas de esta version.
3.1 Entregables Must-Have (MVP)
| # | ID | Funcionalidad | Descripcion |
|---|---|---|---|
| 1 | F-001 | Escaneo periodico automatizado | Job programado cada 30 minutos que ejecuta el agente de escaneo sobre todos los identificadores activos. |
| 2 | F-002 | Busqueda en Facebook | Busqueda de menciones, posts publicos y noticias en Facebook via Meta Graph API con fallback a scraping. |
| 3 | F-003 | Busqueda en LinkedIn | Busqueda de publicaciones y menciones publicas en LinkedIn via API oficial con fallback controlado. |
| 4 | F-004 | Busqueda en X (Twitter) | Busqueda de tweets, hilos y menciones en X usando la API v2 (Recent Search endpoint). |
| 5 | F-005 | Busqueda en Threads | Busqueda de posts y menciones en Threads de Meta via Threads API. |
| 6 | F-006 | Almacenamiento en Notion | Registro de hallazgos en Notion con: identificador, red social, contenido, URL, fecha, relevancia, sentimiento. |
| 7 | F-007 | Notificaciones al canal elegido | Envio automatico de alertas al canal de comunicacion que el cliente elija: Slack (webhook), WhatsApp (Twilio/Meta) o Telegram (Bot API). |
| 8 | F-008 | Claude Skill especializada | Skill completa con instrucciones para busqueda, filtrado por relevancia, scoring y analisis de sentimiento. |
| 9 | F-009 | Gestion de identificadores | Interfaz via Notion para agregar, editar y desactivar identificadores a monitorear. |
| 10 | F-010 | Deduplicacion de resultados | Sistema hash-based (SHA-256) para evitar notificaciones duplicadas entre ciclos. |
3.2 Fuera de Alcance (v1.0)
Las siguientes funcionalidades no estan incluidas en esta version del MVP y podran evaluarse en fases posteriores:
- Interfaz web de administracion propia
- Integracion con TikTok, YouTube o Reddit
- Analisis de sentimiento avanzado con dashboards
- Soporte multi-idioma en busquedas
- API publica para integraciones de terceros
- Autenticacion de usuarios finales
4. Cronograma
El proyecto se ejecuta en 6 semanas organizadas en 3 fases, con revisiones quincenales al cierre de cada fase.
4.1 Diagrama de ejecucion
Fase
S1
S2
S3
S4
S5
S6
Fase 1: Fundacion
Fase 2: Expansion
Fase 3: Hardening
4.2 Detalle por fase
| Fase | Duracion | Actividades Principales |
|---|---|---|
| Fase 1: Fundacion e Infraestructura | Semanas 1-2 | Setup GCP (Secret Manager, Cloud Run, Scheduler, Artifact Registry). Pipeline CI/CD en GitLab. Estructura de Notion (3 tablas). Primera version de la Claude Skill. Conector de X (API v2). Ciclo end-to-end funcional con X. Inicio de App Review de Meta. |
| Fase 2: Expansion de Redes y Notificaciones | Semanas 3-4 | Conectores Facebook, Threads y LinkedIn. Motor de notificaciones con Strategy Pattern. Canales Telegram, Slack y WhatsApp operativos. Deduplicacion hash-based. Claude Skill actualizada para 4 redes. |
| Fase 3: Refinamiento y Hardening | Semanas 5-6 | Refinamiento de la Skill con datos reales. Security scans (Trivy, npm audit, Semgrep). Tests unitarios (70%+ cobertura) + integracion E2E. Cloud Monitoring + alertas. Documentacion operativa. Handoff y capacitacion. |
4.3 Hitos de validacion
- Fin Semana 2 (Revision #1): Ciclo completo end-to-end con X funcionando. Infraestructura GCP operativa.
- Fin Semana 4 (Revision #2): 4 redes sociales + 3 canales de notificacion operativos. Deduplicacion activa.
- Fin Semana 6 (Entrega final): Sistema en produccion, tests completos, documentacion entregada, capacitacion realizada.
5. Inversion
Zulunity ofrece dos modelos de inversion diseñados para adaptarse a las necesidades del cliente.
5.1 Opcion 1: Suscripcion al Servicio (Recomendada)
| Concepto | Detalle |
|---|---|
| Inversion semanal | $2,000.00 MXN + IVA |
| Incluye | Creacion, mantenimiento y evolucion continua del servicio |
| Costos operativos | Infraestructura (GCP, APIs, Anthropic, WhatsApp) absorbidos por Zulunity |
| Flexibilidad | El pago puede detenerse cuando el cliente lo decida |
| Usuarios | Sin variacion de precio hasta 200 usuarios |
| Ideal para | Entrada con bajo compromiso inicial y servicio gestionado continuo |
5.2 Opcion 2: Pago por Proyecto
| Concepto | Monto | Momento de pago |
|---|---|---|
| Anticipo (50%) | $12,500.00 MXN + IVA | Al firmar contrato |
| Entrega final (50%) | $12,500.00 MXN + IVA | Al finalizar el proyecto |
| Total del proyecto | $25,000.00 MXN + IVA |
- Soporte post-entrega: Mantenimiento basico mensual por $1,500.00 MXN + IVA
- Costos operativos: Infraestructura a cargo del cliente. Estimacion: ~$122/mes con X API Basic, ~$22/mes sin X Basic.
5.3 Desglose de Costos Operativos Mensuales (Opcion 2)
| Servicio | Costo/Mes |
|---|---|
| Cloud Run (GCP) | ~$2.50 |
| Secret Manager + Artifact Registry | ~$0.12 |
| Anthropic API (Claude Sonnet) | ~$14.40 |
| X API Basic (opcional) | $100.00 |
| Twilio WhatsApp (~500 msgs) | ~$5.00 |
| Cloud Logging + Monitoring | $0 (free tier) |
| Telegram + Slack + Notion | $0 (incluidos en planes) |
| Total estimado | ~$122/mes |
6. Soporte y Mantenimiento
Soporte incluido
- Sin costo adicional
- 30 dias tras la entrega
- Correccion de bugs sobre lo entregado
- Ajustes menores de funcionalidad
- Acompañamiento tecnico para estabilizacion
Mantenimiento continuo (opcional)
- Cotizacion segun complejidad del proyecto
- Mensual renovable
- Monitoreo de la plataforma
- Actualizaciones de seguridad y dependencias
- Funcionalidades nuevas: cotizacion por separado
7. Terminos y Condiciones
- Infraestructura y Servicios de Terceros: Los costos de Google Cloud, dominios, certificados, almacenamiento, correo transaccional y cualquier servicio externo no estan incluidos en esta propuesta y seran responsabilidad del cliente.
- Validacion Funcional: La propuesta contempla un aterrizaje funcional inicial para cerrar campos, reglas y excepciones del piloto. Si durante el desarrollo aparecen cambios estructurales al proceso o nuevas reglas no documentadas, se evaluara su impacto en alcance, tiempo y costo.
- Propiedad Intelectual: Una vez liquidado el 100% del proyecto, la propiedad intelectual del codigo fuente desarrollado sera transferida al cliente.
- Cambios al Alcance: Cualquier funcionalidad adicional no contemplada en esta propuesta sera analizada y cotizada por separado.
- Migraciones e Integraciones: Esta fase no incluye migracion automatica de datos historicos, integraciones ERP/contables ni automatizaciones externas, salvo que se indique explicitamente en el alcance.
- Confidencialidad: Toda la informacion compartida durante el proyecto sera tratada bajo principios de confidencialidad entre ambas partes.
- Deslinde de Responsabilidad: Tras la entrega formal de la solucion y la liquidacion correspondiente, Zulunity queda deslindado de responsabilidades futuras sobre operacion, evolucion o mantenimiento del sistema, salvo contratacion expresa del servicio opcional de soporte.
- Estimacion de Roadmap Completo: El rango presentado para el sistema completo es una referencia para planeacion presupuestal; cada fase debera aprobarse por separado antes de su ejecucion.
8. Proximos Pasos
- Aprobacion de la Propuesta — Validacion interna de terminos, alcance e inversion.
- Firma de Contrato — Formalizacion del arranque del proyecto.
- Pago de Anticipo — Activacion de recursos y calendarizacion del equipo.
- Sesion de Kick-Off — Cierre de campos obligatorios, responsables, reglas de excepcion y catalogos base para el piloto.
- Inicio de Desarrollo — Arranque formal con seguimiento periodico y entregas incrementales.
Zulunity
Transformando operacion compleja en software escalable.
Contacto: Equipo de Desarrollo de Negocios
Email: contact@zulunity.com
Web: zulunity.com | zulunity.info