Community Monitor

Community Monitor escanea fuentes externas — foros, Reddit, news, plataformas sociales — buscando menciones de tu marca, tus productos o keywords estratégicas. En lugar de googlear manualmente, defines un watch-term, dejas correr scans y ves todas las menciones en una lista cronológica con fuente, indicio de sentiment y drill-down. Para workflows de AI-Visibility y reputación, el módulo es complementario a AI-Visibility Tracking: AVI mide cómo nombran los LLMs a tu marca, Community Monitor mide qué dicen las comunidades reales sobre ti.

Qué puede hacer

• Listado de menciones — GET /v1/community-monitor/mentions entrega menciones cronológicas con fuente, plataforma, URL, extracto y fecha de captura.
• Detalle de mención — GET /v1/community-monitor/mentions/{id} muestra contexto completo, URL original y metadatos de la plataforma.
• Scan on-demand — POST /v1/community-monitor/scan arranca un scan para una palabra clave en una lista de plataformas. Async, 5 créditos por scan.
• Alerts — GET /v1/community-monitor/alerts lista los watch-terms configurados y sus últimos hits.
• Team-scoped — todas las menciones y scans pertenecen al team actual, cross-team → 404.
• Complementario a Reviews — las reviews de Google/Trustpilot etc. corren a través de Review Sources, Community Monitor recoge todo lo que no es una review estructurada.

Cuándo usarlo

• Quieres saber si se habla de tu marca en foros o en Reddit.
• Quieres trackear menciones de la competencia: ¿qué dice la comunidad sobre tus competidores?
• Quieres alerta temprana de PR/crisis — un repunte de menciones negativas es un trigger.
• Quieres entender las fuentes de los LLMs: muchos LLMs citan Reddit/foros — lo que se escribe allí sobre ti afecta tu AI-Visibility.

Workflow

1. Define el watch-term — p.ej. tu marca o un keyword estratégico de producto.
2. Inicia el scan — POST /v1/community-monitor/scan con {keyword, platforms[]} (p.ej. ["reddit", "hackernews", "news"]). Async — los resultados aterrizan en la lista de menciones.
3. Revisa las menciones — GET /v1/community-monitor/mentions con filtro y paginación.
4. Drill-Down — GET /v1/community-monitor/mentions/{id} para texto original y detalles de la plataforma.
5. Mantén alerts — GET /v1/community-monitor/alerts muestra los watch-terms activos; desde los hits se pueden generar Action-Items.

Tip: combina las menciones con AI-Visibility Tracking — las comunidades citadas con frecuencia en respuestas de LLMs son a menudo Reddit, Stack Exchange, foros especializados. Quien tiene presencia allí, gana visibilidad LLM.

API

Body de ejemplo para POST /v1/community-monitor/scan:

{
  "keyword": "Rankion AI",
  "platforms": ["reddit", "hackernews", "news"]
}

Créditos y límites

• Scan: 5 créditos por run — independientemente del número de menciones halladas.
• Endpoints de lectura: todos sin coste.
• Team-scoped: todas las menciones pertenecen a currentTeam(). Los IDs cross-team devuelven 404.
• Cap por plataforma: depende del proveedor externo — los límites típicos son 100–250 hits por scan y plataforma.

Módulos relacionados

• Review Sources — reviews estructuradas de Google, Trustpilot & Co. Community Monitor complementa con menciones no estructuradas.
• AI-Visibility Tracking — mide menciones LLM; muchos LLMs extraen de fuentes que escanea Community Monitor.
• Action Center — desde menciones críticas pueden generarse todos/action-items.
• Agentic Chat — pregunta al agent en lenguaje natural por menciones («¿qué se dijo esta semana sobre nosotros en Reddit?»).