Surtidito — fusión de yt-extract en el proyecto

Fecha: 2026-08-14. yt-extract (analítica de YouTube) pasó a vivir dentro de surtido.

Estructura nueva

  • monitoreo/ — paquete con toda la analítica (antes yt-extract/yt/):
    • api.py (cliente YT Data v3), live.py (trending/canales/videos), loader.py (dataset Kaggle), analyze.py (supervivencia en trending), deck.py (deck TweetDeck), observatory.py (scan trainability + snapshot), dashboard.py (charts matplotlib + emit_surtido), surtido.py (puente a channels.json / indice-credibilidad.json).
  • worker/ — el Worker de Cloudflare (D1 + crons) del observatorio en vivo.
  • scripts/daily.sh — corre monitoreo.observatory + monitoreo.dashboard.
  • feeds.json — config del deck.
  • data/ — datasets Kaggle (MX) + salidas runtime (gitignored).

Artefactos commiteables (servidos por la web)

  • reporte/observatorio.json — resumen de salud de fuentes (monitoreo.observatory).
  • reporte/analisis_trending.json — stats + 4 charts base64 (monitoreo.dashboard).
  • reporte/trainability.json — índice por fuente (trainability.py, lee worker o snapshot).

Notas operativas

  • .env de surtido necesita YT_DATA_API_KEY para el scan diario.
  • trainability.py ahora apunta su snapshot fallback a data/ (no a ~/Downloads/yt-extract).
  • Dataset Kaggle solo MX en data/ (45 MB); el resto de países se descarga si se necesita load_all().
  • yt-extract original queda en ~/Downloads como histórico; la fuente viva es monitoreo/.