Radar Notiviral: la API de noticias de Argentina en tiempo real (código abierto)

Acabé de publicar el repositorio público de Radar Notiviral —la API de noticias de Argentina que vengo construyendo— con licencia MIT, documentación interactiva y un video tutorial que muestra el radar real funcionando. En este artículo te muestro el video, te explico qué hace y por qué es distinto de cualquier agregador de noticias que ya conocés.

Si sos periodista, editor, desarrollador o simplemente querés entender qué está pasando ahora mismo en tu provincia, esto te interesa: abajo está el video y, después, la API completa para que la pruebes con un curl.

🎬 Video tutorial: el radar en 94 segundos

Grabado con pantallas reales de la plataforma y narración en off: qué es el radar, cómo se leen las señales y cómo empezar con la API gratis.

Qué vas a ver, capítulo por capítulo:

1. La landing — qué es el radar y por qué no es "un agregador más".
2. El panel = la API — el feed con las señales de expansión, primicia, huérfana y gap.
3. El mural — la misma API leída como portada de diario.
4. Mapa de calor — las 23 provincias en vivo (GET /api/v1/mapa).
5. Lector integrado — video de YouTube en vivo embebido + bloc de notas + FENIX Recorder.
6. Docs interactivas — Swagger + openapi.json de todos los endpoints.
7. curl en 60 segundos — X-API-Key → JSON con datos reales de hoy.
8. SDK Python — clusters, gaps y reloj en tres líneas.

📥 Si preferís el archivo: descargá el MP4 desde GitHub (1080p, H.264, narration en español rioplatense). El código, la documentación y los tutoriales viven en el repositorio público.

Qué es Radar Notiviral (APIFENIX)

Radar Notiviral es una API de noticias argentinas en tiempo real: un radar periodístico de las 23 provincias que ingiere fuentes reales (RSS y YouTube), agrupa lo que se está publicando y le dice al periodista tres cosas que ningún otro servicio le dice:

• Qué se está expandiendo (la noticia se está haciendo nacional).
• Qué publicó primero cada medio (primicia, con minutos de diferencia).
• Qué no está cubriendo nadie (gaps y notas huérfanas: una sola fuente).

No es un agregador. Un agregador te devuelve una lista de títulos; un motor de inteligencia periodística te devuelve el estado de la cobertura: quién va primero, quién se está copiando, qué tema está desatendido y qué nota tiene una sola fuente. Eso convierte al radar en una herramienta de trabajo para redacciones y, al mismo tiempo, en un dataset para desarrolladores.

Y es API ARGENTINA de verdad: fuentes reales de las 23 provincias, español rioplatense y un producto pensado para el periodismo del país, no una traducción de un producto estadounidense.

🔥 Las cinco señales que no existen en otras APIs

Cada señal sale de un endpoint dedicado, así podés consultarlas por separado o filtrarlas en el listado general.

🚀 Quickstart: 60 segundos desde cero

1. Registrate y obtené tu key:

curl -X POST https://apifenix.mp4-render.site/registro

2. Explorá el radar:

curl -H "X-API-Key: TU_KEY" \
  "https://apifenix.mp4-render.site/api/v1/items?provincia=AR-A&page_size=5"

Y en el navegador, sin key: la documentación interactiva (Swagger) y el openapi.json te muestran todos los endpoints con sus esquemas.

📡 Los endpoints del Motor Radar v2

GET /api/v1/items         Filtros: provincia, region, tipo, tema, clusters,
                          huerfanas, primicia, gap, min_fuentes, ventana,
                          sin_video, orden, search
GET /api/v1/clusters      Notas EN EXPANSIÓN (de dónde salió, cuántas fuentes, en qué minutos)
GET /api/v1/reloj         Reloj de la noticia: quién publicó primero y cuánto tardó cada medio
GET /api/v1/gaps          Cobertura gap: qué temas NO cubre nadie (oportunidad)
GET /api/v1/mapa          Mapa de calor provincial en JSON
GET /api/v1/primicias     Solo la fuente que fue primera en cada nota
GET /api/v1/huerfanas     Notas con 1 sola fuente (posible exclusiva)
GET /api/v1/sources       Catálogo de fuentes (editorial + YouTube)

La referencia completa, con parámetros, ejemplos de respuesta y códigos de error, está en docs/API.md.

🧩 Integraciones: pensadas para que no tengas que pegarle contra la API a mano

• SDK Python y SDK JavaScript — incluidos con tu API key.
• Servidor MCP — para que tu agente de IA (Claude Desktop, Cursor) consulte el radar como una herramienta más.
• Plugin n8n — webhook listo desde el panel para automatizar tu propio flujo.

from apifenix import ApiFenix
radar = ApiFenix("TU_KEY")

# ¿Qué se está expandiendo AHORA?
for c in radar.clusters(min_fuentes=3):
    print(c["titulo"], "→", c["n_fuentes"], "fuentes")

# ¿Dónde no cubre nadie?
for g in radar.gaps(provincia="AR-Y"):
    print("Oportunidad:", g["tema"], g["titulos"][0]["titulo"])

Ese uso tiene un valor real: un bot que cada 15 minutos te avisa "en tu provincia hay 2 notas huérfanas y 1 gap con 0 columnas" es, con la nota y el video ya resueltos, una fábrica de noticias.

🏗️ Arquitectura

  Fuentes RSS + YouTube (23 provincias)
            │  ingesta c/15min
            ▼
     Motor Radar v2  ── clusters · primicias · huérfanas · reloj · gaps
            │
            ▼
    PostgreSQL  ──────  Redis (rate limit + cuotas)
            │
            ▼
      FastAPI pública  ──►  Portal  ·  Docs interactivas  ·  MCP

• Stack: FastAPI · SQLAlchemy · PostgreSQL · Redis · feedparser · APScheduler.
• Auth: API keys hasheadas (SHA-256) + Google OAuth + verificación por email.
• Privacidad por diseño: el análisis de ML corre en el navegador del periodista y el video del Recorder nunca toca el servidor.

🎨 Extras del portal (lo que vas a ver en el video)

• Agente de redacción IA — conectás tu propia API key (OpenAI, OpenRouter, Groq, Gemini o Claude), cifrada en reposo, con tono, largo, formato y público ajustables; chat por nota con el contexto del radar y tus apuntes.
• Mis Notas — todo lo que redactás queda guardado para retomar o pasarle al agente.
• Inteligencia IA — sentimiento por entidad, framing, temas IPTC y clusters, con el ML corriendo 100% en tu navegador (Transformers.js) y caché en IndexedDB; el servidor solo sirve datos ya indexados.
• FENIX Recorder — grabás pantalla, pestaña, cámara o reacción con cámara desde el navegador (MediaRecorder + IndexedDB); al servidor solo llega la ficha (duración, peso, hash). Desde cada nota de YouTube tenés el botón "Grabar esta nota".
• Diseñador de placas 1080×1350 con preview en vivo y descarga PNG.
• Sumá tu fuente al radar — los usuarios proponen medios y el admin aprueba: cada fuente nueva alimenta a todos.
• Tableros guardados y feed con etiquetas con la señal periodística visible.

🗞️ PRENSA Notiviral — el medio libre, con reglas claras

Además de la API, el proyecto incluye un medio con identidad verificada: cada alta exige consentimiento explícito del contrato vigente (hash único + IP + fecha y hora + versión) e identidad acreditada con documento. La responsabilidad es exclusiva del autor; la plataforma opera como intermediario tecnológico. Las notas nacen pending_review y un worker de heurísticas locales las publica o las rechaza, con take-down en milisegundos: tres IPs distintas o un reclamo de copyright bloquean la nota preventivamente y la sacan del feed y del índice.

Los textos legales están en docs/legal/.

⭐ Cómo apoyar el proyecto (y por qué esto crece solo)

Radar Notiviral es MIT y público: el código de la plataforma es privado, pero la documentación, los tutoriales y los videos son de libre acceso. Su crecimiento depende de tres cosas que podés hacer en un minuto:

1. ⭐ Star en el repo — no cambia el algoritmo de GitHub por vos, pero sí cambia cuánto puede crecer el proyecto y qué tanVisible queda para la comunidad.
2. 🔀 Fork + issues — la vía más rápida para que la API sirva a otro caso de uso: contame qué fuente o qué señal te falta y la sumo.
3. 📡 Sumá tu fuente al radar — si tenés un medio, un canal o una radio, registrá tu medio y tus notas pasan a alimentar el radar de todos. Cada medio nuevo suma provincias, temas y señales.

Y si llegaste hasta acá desde otro lado, compartí el post: para un proyecto open source el tráfico directo desde Reddit, X, LinkedIn o un grupo de periodistas de WhatsApp es lo que convierte un repo en herramienta de uso diario.

Si preferís una integración hecha a medida —un radar vertical para tu nicho, un bot que publique solo, o la API embebida en tu producto— escribime y lo armamos juntos.

🗺️ Qué viene ahora

• Más fuentes: cada provincia, cada medio local y cada canal de YouTube del país, con verificación editorial.
• Señales nuevas: velocidad de réplica por tema, predicción de alcance (qué nota se está volviendo nacional) y alertas por breaking en tu zona.
• SDK en más lenguajes y un plugin de WordPress para publicar desde el panel.
• Timelines por tema con la historia completa de cómo se cubrió cada noticia.

Si hay algo que te sirva y no está, abrí un issue: las features se priorizan por lo que la comunidad pide.

Conclusión

Publicar el código público de un proyecto privado no es un trámite: es la forma más rápida de que alguien externo te diga qué le falta. Radar Notiviral ya tiene lo más difícil —un problema real, usuarios reales en 23 provincias y una API que responde en segundos— y ahora también tiene lo que hace que un proyecto open source crezca: documentación, video tutorial y una comunidad que puede sumar fuentes.

Mirá el video de arriba, probá el curl con tu key y, si te sirvió, dejale una star al repo: es la señal más barata y más útil que podés dar a un proyecto que recién arranca.

Repo: github.com/NickDev24/radar-notiviral · Portal: radar-notiviral.online · Docs interactivas: https://apifenix.mp4-render.site/api/docs