Servidor MCP de escucha social

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de escucha social a través de la API de Syften. Este servidor permite el análisis de menciones en redes sociales mediante IA, con compatibilidad con notificaciones en tiempo real mediante webhooks.

Características

Monitoreo de menciones sociales en tiempo real
Categorización de contenido impulsada por IA
Notificaciones de webhook para menciones importantes
Relleno de datos históricos
Análisis de tendencias e informes
Compatibilidad con consultas en lenguaje natural

Prerrequisitos

Node.js (v16 o posterior)
Una cuenta Syften con acceso API
Aplicación de escritorio Claude o VSCode con la extensión Claude

Instalación

Clonar el repositorio:

git clone https://github.com/fred-em/social-listening.git
cd social-listening

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Configuración

1. Configuración de la API de Syften

Inicie sesión en su cuenta de Syften
Vaya a Configuración > Acceso API
Genere una clave API si aún no lo ha hecho
Copia tu clave API para el siguiente paso

2. Configuración del escritorio de Claude

Agregue la configuración del servidor a ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "social-listening": {
      "command": "node",
      "args": ["/absolute/path/to/social-listening/build/index.js"],
      "env": {
        "SYFTEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Configuración de VSCode (opcional)

Si está utilizando VSCode con la extensión Claude, agregue la configuración a /Users/YOUR_USERNAME/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json :

{
  "mcpServers": {
    "social-listening": {
      "command": "node",
      "args": ["/absolute/path/to/social-listening/build/index.js"],
      "env": {
        "SYFTEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Herramientas disponibles

1. configurar_ai_filter

Configure los ajustes de filtrado de IA para el análisis de menciones.

{
  "enabled": true,
  "min_confidence": 0.7,
  "categories": ["spam", "support", "feedback", "bug_report", "feature_request"],
  "webhook_url": "https://your-webhook.com/endpoint",
  "webhook_secret": "your-secret-token"
}

2. configuración_webhook

Configurar el punto final del webhook para notificaciones en tiempo real.

{
  "endpoint_url": "https://your-webhook.com/endpoint",
  "secret_token": "your-secret-token",
  "enabled": true
}

3. mes de relleno

Rellene las menciones de un mes específico.

{
  "year": 2024,
  "month": 2
}

4. sync_latest

Sincronizar nuevas menciones desde la última actualización.

{}

5. analizar_tendencias

Analizar las tendencias de menciones a lo largo del tiempo.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "group_by": "day",
  "tags": ["feature", "bug"]
}

6. obtener_fuentes_principales

Obtenga las principales fuentes/autores mencionados.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "limit": 10
}

7. nlp_prompt

Procesar consultas en lenguaje natural.

{
  "prompt": "show me feedback mentions from last week"
}

8. obtener menciones filtradas por IA

Obtenga menciones procesadas mediante filtrado de IA.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "min_confidence": 0.8,
  "categories": ["feedback", "bug_report"],
  "limit": 50
}

Ejemplo de uso en Claude

A continuación se muestran algunos ejemplos de indicaciones que puedes utilizar con Claude:

Configurar el filtrado de IA:

Configure the social listening AI filter to detect bug reports and feature requests with 80% confidence.

Configurar notificaciones de webhook:

Set up a webhook for the social listening server to send notifications to https://my-server.com/webhook with the secret token "my-secret".

Analizar tendencias:

Show me the trend of bug reports and feature requests from last month.

Obtener menciones filtradas:

Show me all high-confidence bug reports from the past week.

Consultas en lenguaje natural:

What kind of feedback have we received about the new feature launch?

Integración de webhooks

Al configurar webhooks, el servidor enviará notificaciones en este formato:

{
  "mention_url": "https://example.com/post",
  "ai_score": 0.95,
  "ai_categories": ["bug_report", "feature_request"],
  "timestamp": "2024-02-12T15:30:00Z"
}

Encabezados incluidos con las solicitudes de webhook:

Content-Type: application/json
X-Webhook-Secret: your-secret-token

Desarrollo

Construyendo desde la fuente

# Install dependencies
npm install

# Build the server
npm run build

# Run tests
npm test

Añadiendo nuevas funciones

Implementar nueva funcionalidad en src/
Añadir pruebas en tests/
Construir y probar localmente
Enviar una solicitud de extracción

Solución de problemas

Errores de webhook : asegúrese de que el punto final de su webhook sea accesible y admita HTTPS
Problemas con la clave API : Verifique que su clave API de Syften esté configurada correctamente en la configuración
Errores de base de datos : Verifique si el directorio data existe y se puede escribir

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

Social Listening MCP Server