Watchr.ai

Conecta agentes de IA a inteligencia competitiva en tiempo real, lanzamientos de productos, actualizaciones de precios y perspectivas de mercado.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Watchr

Lleva la inteligencia competitiva y el monitoreo de marcas a tu asistente de IA. Pregúntale a Claude, Cursor o cualquier cliente compatible con MCP qué hicieron tus competidores esta semana. Las respuestas provienen directamente de tu espacio de trabajo de Watchr.

Watchr es una plataforma de inteligencia competitiva y monitoreo de marcas. Vigila los sitios web, anuncios, publicaciones en redes sociales, noticias y otras fuentes de tus competidores, y luego califica cada señal según un prompt que tú defines, para que lo que veas sea movimiento relevante, no ruido.

Este repositorio aloja el servidor oficial de Model Context Protocol (MCP) para Watchr. Expone tus grupos de monitoreo, marcas rastreadas, insights validados e informes enviados a cualquier cliente compatible con MCP. Solo lectura.

El servidor está alojado por Watchr. Sin instalación local, sin Docker. Solo apunta tu cliente a https://mcp.watchr.ai/mcp y autentícate. Hay dos rutas, según tu cliente:

  • OAuth con un clic para Claude (Desktop / Code), ChatGPT, Cursor y cualquier otro cliente que admita Registro Dinámico de Clientes. Se abre el navegador, apruebas y listo.
  • Clave API personal (generada en tu espacio de trabajo de Watchr) para frameworks agénticos e integraciones personalizadas donde integres el MCP en tu propia pila de automatización.

Tabla de contenidos

Qué puedes hacer con él

Una vez conectado, puedes pedirle a tu asistente de IA cosas como:

  • "¿Qué lanzaron nuestros competidores esta semana?"
  • "Redacta un mensaje de Slack que resuma los 5 insights competitivos más importantes de este mes."
  • "Compara los cambios de posicionamiento en nuestras marcas rastreadas durante los últimos 30 días."
  • "Prepárame un informe competitivo de una página sobre HubSpot del último mes, hazlo visual."
  • "Actualiza automáticamente mis battle cards de Notion y las páginas de resumen de competidores con los insights de Watchr de esta semana."

El servidor MCP proporciona los datos; tu asistente se encarga del razonamiento, la redacción y la integración con el resto de tu flujo de trabajo.

Demostración

Una conversación breve con Claude que extrae las últimas señales de HubSpot a través de Watchr:

Chat with Claude using Watchr MCP

Los mismos datos, un prompt de seguimiento después. Claude genera un informe competitivo diseñado directamente a partir de los insights validados de Watchr:

Designed competitive briefing artifact generated from Watchr data

Este es el ciclo principal. Watchr recopila y califica. Tu cliente de IA razona y genera resultados. El servidor MCP es el pegamento.

Herramientas disponibles

El servidor expone seis herramientas de solo lectura:

HerramientaPropósito
list_monitoring_groupsLista todos los grupos de monitoreo (listas de seguimiento) a los que tienes acceso. Cada grupo agrupa una o más marcas rastreadas y un prompt de calificación personalizado que define qué cuenta como relevante.
list_brandsLista las marcas competidoras rastreadas dentro de un grupo de monitoreo. Úsalo para resolver nombres de marcas antes de buscar.
search_insightsBusca insights validados con filtros (marca, rango de fechas, tipo de fuente, texto libre). Devuelve una lista compacta diseñada para decidir qué insights abrir.
get_insightObtiene el cuerpo completo de un insight individual por ID: URL de la fuente, contenido original, capturas de pantalla, justificación de calificación, fechas y elementos relacionados cuando estén disponibles.
list_reportsLista los informes que se han enviado desde un grupo de monitoreo.
get_reportObtiene el cuerpo completo de un informe individual: narrativa, insights incluidos, destinatarios, fecha de envío.

Todos los endpoints están paginados y son filtrables. El servidor es de solo lectura. No puede crear, editar ni eliminar nada en tu espacio de trabajo de Watchr.

Contrato de respuesta de insights

search_insights devuelve un payload de descubrimiento compacto. Cada elemento incluye un id, un título, un resumen factual, metadatos de fuente y marca, y un effective_date. El date_type adjunto indica si esa fecha efectiva es la fecha de publicación de la fuente (published) o la fecha de detección de Watchr (detected). Los cambios en sitios web, por lo tanto, siguen siendo fechables de forma segura incluso cuando no tienen fecha de publicación.

La respuesta de búsqueda omite intencionalmente el description original, el qualification_analysis, las fechas crudas y el related_items. Esto mantiene las páginas de resultados lo suficientemente pequeñas para que un cliente de IA pueda clasificar y preseleccionar sin gastar su ventana de contexto en texto fuente que quizás nunca use.

Cuando el título o resumen de un elemento no sea lo suficientemente claro, llama a get_insight con el id devuelto como insight_id antes de responder. get_insight proporciona la descripción de la fuente, el razonamiento de calificación, las fechas de publicación y detección, y cualquier insight validado relacionado. Los consumidores no deben inferir detalles faltantes solo del resumen compacto.

Cuando esté disponible, competitive_signal_id identifica insights que Watchr adjuntó al mismo movimiento competitivo y puede usarse como una pista de deduplicación.

Primeros pasos con Watchr

Necesitas un espacio de trabajo de Watchr configurado antes de que el servidor MCP tenga algo interesante que devolver. El camino completo:

  1. Crea una cuenta en watchr.ai/signup. Hay un plan gratuito disponible.
  2. Finaliza tu configuración en watchr.ai/app/settings:
    • Agrega las marcas y competidores que quieres rastrear
    • Especifica el mercado que estás monitoreando (se usa para calificar la relevancia)
    • Suscríbete a los boletines y fuentes de prensa que quieras incorporar
    • Agrega las páginas que quieres que Watchr monitoree para detectar cambios (precios, changelog, carreras, etc.)
    • Agrega perfiles de redes sociales para extraer (LinkedIn, Facebook, Instagram)
  3. Espera tu primer informe. Watchr recopila, califica y arma el primer briefing automáticamente.
  4. Conecta el servidor MCP (consulta Autenticación y Configuración) y comienza a consultar tus insights desde cualquier cliente de IA.

Autenticación

El endpoint del servidor es siempre https://mcp.watchr.ai/mcp. Hay dos formas de autenticarse. Elige la que admita tu cliente.

Opción A. OAuth con un clic

OAuth 2.1 estándar con Registro Dinámico de Clientes (RFC 7591) y PKCE. Tu cliente se autorregistra, abre una ventana del navegador, autorizas el acceso de Watchr y los tokens se almacenan de forma transparente en el cliente. Sin copiar y pegar, sin rotación manual.

Clientes con soporte OAuth confirmado de fábrica:

  • Claude Desktop
  • Claude Code
  • ChatGPT (Custom Connectors en Plus / Pro / Team / Enterprise)
  • Cursor (versiones recientes)

Si tu cliente está en esta lista, ve directo a Clientes OAuth. No se necesita generar ninguna clave.

Opción B. Clave API personal

Para frameworks agénticos, integraciones personalizadas, scripts, Windsurf, extensiones de VS Code o cualquier cliente que no admita OAuth, Watchr emite claves API de larga duración con el prefijo wat_mcp_.

Para generar una clave:

  1. Inicia sesión en watchr.ai
  2. Ve a Integraciones → MCP en tu espacio de trabajo
  3. Haz clic en Crear clave API
  4. Dale un nombre descriptivo (por ejemplo, "Mi agente LangGraph", "Windsurf, laptop de trabajo"), opcionalmente establece una fecha de vencimiento
  5. Copia la clave inmediatamente. Watchr solo muestra la clave completa una vez. El panel almacena un prefijo y un hash, por lo que una clave perdida no se puede recuperar (revócala y regenérala).

Watchr API key generation interface

Pasa la clave como token Bearer en cada solicitud:

Authorization: Bearer wat_mcp_<your-key>

La mayoría de los clientes MCP te permiten declarar esto mediante un campo headers en su configuración. Ejemplos en Clientes con clave API.

Algunas notas sobre seguridad:

  • Trata la clave como una contraseña. Solo lectura no significa bajo riesgo: puede ver toda tu inteligencia competitiva.
  • Una clave por dispositivo o integración, con nombre claro. Revócala y vuelve a emitirla desde Integraciones → MCP si se pierde una laptop.
  • Establece una fecha de vencimiento en las claves para entornos de CI o compartidos.
  • Las claves heredan el acceso de tu cuenta. Cubren todos los grupos de monitoreo activos de la cuenta.

¿Aún no tienes una cuenta de Watchr? Crea una gratis.

Configuración

Clientes OAuth

Para todos los clientes a continuación, la URL del servidor es https://mcp.watchr.ai/mcp y la autenticación se activa automáticamente en la primera conexión.

Claude Desktop

Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "watchr": { "url": "https://mcp.watchr.ai/mcp" }
  }
}

Reinicia Claude Desktop. Watchr aparece en el panel de conectores. Haz clic en él para completar el OAuth.

Claude Code

claude mcp add --transport http watchr https://mcp.watchr.ai/mcp

Luego ejecuta /mcp dentro de Claude Code y haz clic en Autenticar junto a Watchr.

ChatGPT

Configuración → Conectores → Agregar conector personalizado:

  • URL del servidor MCP: https://mcp.watchr.ai/mcp
  • Autenticación: OAuth

ChatGPT activa el flujo OAuth en el primer uso.

Cursor

Configuración → MCP → Agregar nuevo servidor MCP:

{
  "watchr": { "url": "https://mcp.watchr.ai/mcp" }
}

Clientes con clave API

Primero genera una clave API y luego pásala como token Bearer en la configuración del cliente.

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "watchr": {
      "serverUrl": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

VS Code

Agrega a .vscode/mcp.json (o configuración de usuario):

{
  "servers": {
    "watchr": {
      "type": "http",
      "url": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

Cursor (sin OAuth)

Misma forma JSON que la versión OAuth con un bloque headers adicional:

{
  "watchr": {
    "url": "https://mcp.watchr.ai/mcp",
    "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
  }
}

Frameworks agénticos personalizados

LangGraph, CrewAI, Mastra, n8n, agentes personalizados en Python o TypeScript, etc. Conéctate a https://mcp.watchr.ai/mcp mediante HTTP transmisible y adjunta el encabezado Authorization: Bearer wat_mcp_<your-key> a cada solicitud. Cualquier SDK compatible con MCP funciona.

Mejorando tus resultados

Si tu asistente dice que "no hay insights relevantes" o devuelve resultados escasos, los datos viven río arriba en tu espacio de trabajo de Watchr. Haz que Watchr sea más inteligente y el MCP también lo será:

  • Agrega páginas monitoreadas (precios de competidores, changelog, carreras, páginas de producto)
  • Completa los perfiles sociales agregando los handles de LinkedIn, Facebook e Instagram de cada marca rastreada
  • Refina el prompt de calificación a nivel del grupo de monitoreo. Decide qué cuenta como "relevante". Ajústalo (temas más específicos que te importan) o amplíalo (captura más) según lo que esté pasando.
  • Agrega más fuentes de noticias y prensa. Cuantas más fuentes, mayor densidad de señal.

Todo es configurable en watchr.ai/app/settings.

Soporte

  • Reportes de errores y solicitudes de funciones: abre un issue en este repositorio
  • Preguntas generales y comentarios: contact@watchr.ai
  • Estado y disponibilidad: el endpoint MCP comparte el estado con la plataforma principal de Watchr

Construido por el equipo de Watchr. Licencia MIT.