Servidor MCP de Audiense Insights

Este servidor, basado en el Protocolo de Contexto de Modelo (MCP) , permite que Claude o cualquier otro cliente compatible con MCP interactúe con su cuenta de Audiense Insights . Extrae información de marketing y análisis de audiencia de los informes de Audiense, incluyendo análisis demográficos, culturales, de influencers y de interacción con el contenido .

🚀 Requisitos previos

Antes de utilizar este servidor, asegúrese de tener:

• Node.js (v18 o superior)
• Aplicación de escritorio Claude
• Cuenta de Audiense Insights con credenciales de API
• Token portador de API de X/Twitter (opcional, para datos enriquecidos de influencers)

Instalación mediante herrería

Para instalar Audiense Insights Server para Claude Desktop automáticamente a través de Smithery :

⚙️ Configuración de Claude Desktop

1. Abra el archivo de configuración de Claude Desktop:
   • Sistema operativo Mac:
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Ventanas:
     code %AppData%\Claude\claude_desktop_config.json
2. Agregue o actualice la siguiente configuración:
   "mcpServers": { "audiense-insights": { "command": "/opt/homebrew/bin/node", "args": [ "/ABSOLUTE/PATH/TO/YOUR/build/index.js" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }
3. Guarde el archivo y reinicie Claude Desktop.

🛠️ Herramientas disponibles

📌 get-reports

Descripción : Recupera la lista de informes de estadísticas de Audiense propiedad del usuario autenticado.

• Parámetros : Ninguno
• Respuesta :
  • Listado de informes en formato JSON.

📌 get-report-info

Descripción : Obtiene información detallada sobre un informe de inteligencia específico , que incluye:

• Estado
• Tipo de segmentación
• Tamaño de la audiencia
• Segmentos
• Enlaces de acceso
• Parámetros :
  • report_id(cadena) : El ID del informe de inteligencia.
• Respuesta :
  • Detalles completos del informe en formato JSON.
  • Si el informe aún se está procesando, devuelve un mensaje indicando el estado pendiente.

📌 get-audience-insights

Descripción : Recupera información agregada para una audiencia determinada, que incluye:

• Demografía : género, edad, país.
• Rasgos de comportamiento : Horas activas, uso de la plataforma.
• Psicografía : Rasgos de personalidad, intereses.
• Factores socioeconómicos : ingresos, nivel educativo.
• Parámetros :
  • audience_insights_id(cadena) : el ID de las estadísticas de audiencia.
  • insights(matriz de cadenas, opcional) : lista de nombres de insights específicos para filtrar.
• Respuesta :
  • Perspectivas formateadas como una lista de texto estructurada.

📌 get-baselines

Descripción : Recupera las audiencias base disponibles, opcionalmente filtradas por país .

• Parámetros :
  • country(cadena, opcional) : código de país ISO por el que filtrar.
• Respuesta :
  • Lista de audiencias de referencia en formato JSON.

📌 get-categories

Descripción : Recupera la lista de categorías de afinidad disponibles que se pueden utilizar en comparaciones de personas influyentes.

• Parámetros : Ninguno
• Respuesta :
  • Lista de categorías en formato JSON.

📌 compare-audience-influencers

Descripción : Compara a los influencers de una audiencia dada con una audiencia de referencia . Esta audiencia se determina de la siguiente manera:

• Si un solo país representa más del 50% de la audiencia, ese país se utiliza como base.
• De lo contrario, se utiliza la línea base global .
• Si se selecciona un segmento específico , se utiliza la audiencia completa como base.

Cada comparación de influencers incluye:

• Afinidad (%) : qué tan bien se alinea el influencer con la audiencia.
• Afinidad de referencia (%) : la afinidad del influenciador dentro de la audiencia de referencia.
• Puntuación de singularidad : qué tan distinto es el influenciador en comparación con la línea base.
• Parámetros :
  • audience_influencers_id(cadena) : ID de los influenciadores de la audiencia.
  • baseline_audience_influencers_id(cadena) : ID de los influenciadores de la audiencia de referencia.
  • cursor(número, opcional) : Cursor de paginación.
  • count(número, opcional) : Número de elementos por página (predeterminado: 200).
  • bio_keyword(cadena, opcional) : filtrar influencers por palabra clave biográfica .
  • entity_type(enum: person | brand , opcional) : Filtrar por tipo de entidad.
  • followers_min(número, opcional) : Número mínimo de seguidores.
  • followers_max(número, opcional) : Número máximo de seguidores.
  • categories(matriz de cadenas, opcional) : filtra influencers por categorías .
  • countries(matriz de cadenas, opcional) : filtra personas influyentes por códigos ISO de país .
• Respuesta :
  • Lista de personas influyentes con puntuaciones de afinidad, comparación de referencia y puntuaciones de singularidad en formato JSON.

📌 get-audience-content

Descripción : Recupera detalles de interacción con el contenido de la audiencia , incluidos:

• Contenido gustado : publicaciones, dominios, emojis, hashtags, enlaces, medios y una nube de palabras más populares.
• Contenido compartido : la mayoría del contenido compartido está categorizado de manera similar.
• Contenido influyente : contenido de cuentas influyentes.

Cada categoría contiene:

• popularPost : Publicaciones más comprometidas.
• topDomains : Dominios más mencionados.
• topEmojis : Emojis más utilizados.
• topHashtags : Los hashtags más utilizados.
• topLinks : Enlaces más compartidos.
• topMedia : Medios compartidos.
• wordcloud : Palabras más utilizadas.
• Parámetros :
  • audience_content_id(cadena) : El ID del contenido de la audiencia.
• Respuesta :
  • Datos de participación en el contenido en formato JSON.

📌 report-summary

Descripción : Genera un resumen completo de un informe de Audiense, que incluye:

• Metadatos del informe (título, tipo de segmentación)
• Tamaño completo de la audiencia
• Información detallada del segmento
• Principales perspectivas para cada segmento (palabras clave biográficas, datos demográficos, intereses)
• Principales influencers de cada segmento con métricas de comparación
• Parámetros :
  • report_id(cadena) : El ID del informe de inteligencia a resumir.
• Respuesta :
  • Resumen completo del informe en formato JSON con datos estructurados para cada segmento
  • Para informes pendientes: Mensaje de estado que indica que el informe aún se está procesando
  • Para informes sin segmentos: Mensaje que indica que no hay segmentos para analizar

💡 Indicaciones predefinidas

Este servidor incluye indicaciones preconfiguradas

• audiense-demo : ayuda a analizar los informes de Audiense de forma interactiva.
• segment-matching : una solicitud para hacer coincidir y comparar segmentos de audiencia en los informes de Audiense, identificando similitudes, rasgos únicos y conocimientos clave basados en datos demográficos, intereses, personas influyentes y patrones de participación.

Uso:

• Acepta un argumento reportName para encontrar el informe más relevante.
• Si se proporciona una identificación, se busca por ID de informe.

Caso de uso: Orientación estructurada para el análisis de audiencia.

🛠️ Solución de problemas

Herramientas que no aparecen en Claude

1. Consulte los registros de Claude Desktop:

2. Verifique que las variables de entorno estén configuradas correctamente.
3. Asegúrese de que la ruta absoluta a index.js sea correcta.

Problemas de autenticación

• Verifique nuevamente las credenciales de OAuth.
• Asegúrese de que el token de actualización siga siendo válido.
• Verifique que los ámbitos de API requeridos estén habilitados.

📜 Visualización de registros

Para comprobar los registros del servidor:

Para MacOS/Linux:

Para Windows:

🔐 Consideraciones de seguridad

• Mantenga seguras las credenciales de API: nunca las exponga en repositorios públicos.
• Utilice variables de entorno para gestionar datos confidenciales.

📄 Licencia

Este proyecto está licenciado bajo la licencia Apache 2.0. Consulte el archivo de licencia para más detalles.