La integración de datos deportivos es la diferencia entre un broadcast donde el operador está sobrepasado disparando 80 gráficas por partido — y uno donde el sistema sabe que un jugador acaba de hacer su segunda falta y muestra la gráfica solo. KronoGraph se conecta a Genius Sports, FIBA LiveStats, FEB, OCR y a APIs custom, transforma cada fuente al mismo schema interno, y deja que las plantillas reaccionen automáticamente al feed. El operador supervisa y corrige; ya no es el único punto de falla.
Para quién es este servicio
- Federaciones con feed oficial (Genius Sports, FIBA LiveStats) que quieren capitalizar la inversión y mostrar stats en tiempo real al broadcast.
- Productoras independientes que cubren ligas medianas y necesitan reducir el equipo del operador a una sola persona sin perder calidad.
- Federaciones con APIs propias (legados, sistemas internos) que necesitan integración custom — REST o WebSocket — para alimentar sus gráficas.
- Producciones donde el feed oficial no es público y dependen de OCR sobre el scoreboard físico para alimentar las gráficas broadcast.
Fuentes integradas
Genius Sports REST + FLS (✅ producción)
Polling de boxscore y play-by-play vía REST, además de WebSocket FLS (Live Stats) para eventos en tiempo real. La FLS es lo que distribuye FIBA LiveStats — cualquier liga que use ese stack está cubierta out-of-the-box. En producción con DPB Colombia, BCLA y otras competencias.
FEB scraper (✅ producción)
Scraper HTML del portal baloncestoenvivo.feb.es de la Federación Española de Baloncesto. Transformamos el HTML público en frames del schema interno. En producción para Primera FEB y otras categorías de la federación.
OCR ingestion (✅ beta)
Para casos donde no hay feed oficial: enchufás una cámara apuntando al scoreboard físico, un proceso OCR convierte el video en frames de datos (score, cuarto, reloj, faltas) y los inyecta como cualquier otro feed. Útil para ligas regionales o eventos con tablero LED sin API.
Feeds genéricos REST/WebSocket (🔧 en desarrollo)
Bindings dinámicos por configuración: subís un schema mapping de tu API al frame schema interno y KronoGraph hace polling REST o conecta WebSocket sin necesidad de release de código. Disponible en alpha para clientes con APIs custom.
Auto-fire de gráficas
El ScoreBug + IngameStats reaccionan automáticamente al feed sin disparo manual. Reglas configurables: cuándo mostrar "2nd FOUL", cuándo destacar "8 PTS (2/3) 67% 3PT" sobre el scorebug, cuándo aparece "Player of the Match". Modelo de "dominancia estocástica" para milestones de equipo. El operador puede sobreescribir cualquier auto-fire desde el panel.
Replay forensics
Cualquier partido grabado se persiste como JSONL re-ejecutable. Sirve para tres cosas: entrenar operadores nuevos sobre data real, reproducir un bug específico de auto-fire, validar cambios de configuración antes de subirlos a un evento en vivo. Velocidad 1x o Nx (acelerado para QA rápido).
Cómo funciona
- Configurás la fuente — credenciales de Genius Sports / FLS, URL del feed FEB, parámetros del OCR, o el schema mapping del feed custom.
- El proceso de ingestion (Node, port 3001) hace polling y/o mantiene WebSocket abierto. Convierte cada update al frame schema interno.
- Las plantillas escuchan los frames y se actualizan solas. Las reglas de auto-fire deciden qué se muestra cuando.
- El operador supervisa desde el panel — puede flip a MANUAL en cualquier grupo (score / faltas / tiempo) si la fuente falla, o sobreescribir un auto-fire específico.
- Todo se persiste como JSONL para replay y auditoría posterior.
Modo MANUAL como red de seguridad
Si la fuente cae durante el partido, el operador hace flip a MANUAL en el grupo afectado y sigue operando con números a mano. Cuando el feed vuelve, hace flip a LIVE y el merged state se snapshotea — los datos no chocan. Esta arquitectura permite que un fallo de Genius o FEB no detenga la transmisión.
Casos de uso reales
- DPB Colombia — Genius Sports REST + FLS para temporada completa, auto-fire de scorebug, ingame stats y final score.
- Primera FEB — FEB scraper para todos los partidos de la liga, integración con bundle FEB de gráficas.
- BCLA 2026 — Genius Sports en producción para Basketball Champions League Americas.
- Reto 3X3 — feed custom adaptado al ruleset 3x3 con score-to-21 y reloj de 12s.
Funcionalidades incluidas
- Conexión Genius Sports REST + FLS WebSocket (producción)
- Scraper FEB
baloncestoenvivo.feb.es(producción) - OCR ingestion para escenarios sin feed oficial (beta)
- Feeds genéricos REST/WebSocket por configuración (en desarrollo)
- Auto-fire del ScoreBug + IngameStats con reglas configurables
- Replay forensics — captura JSONL re-ejecutable a 1x/Nx
- Modo MANUAL flip por grupo (score / faltas / tiempo) ante fallo
- Schema mapping para integraciones custom (1-3 semanas típico)
- Multi-fuente, multi-partido en paralelo (proceso Node dedicado)
- Persistencia JSONL para auditoría y debugging
Preguntas frecuentes
¿Qué es auto-fire?
Las gráficas reaccionan al feed automáticamente, sin que el operador dispare manualmente. Reglas configurables (ej: mostrar stats cuando un jugador hace su 2da falta).
¿Qué fuentes están en producción?
Genius Sports REST + FLS, FEB scraper. OCR en beta. Feeds genéricos REST/WS en desarrollo.
¿Qué es replay forensics?
Capturas JSONL re-ejecutables a 1x/Nx para QA, training y reproducir bugs.
¿Pueden integrarse APIs no listadas?
Sí. REST polling y WebSocket genéricos por configuración. 1-3 semanas típico.
¿Qué pasa si la fuente cae?
Flip a MANUAL en el grupo afectado sin reiniciar. Cuando vuelve, flip a LIVE con snapshot del merged state.