TweetBinder de Audiense MCP Server

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para la API de TweetBinder de Audiense , que permite que Claude y otros modelos de IA compatibles con MCP accedan a los datos analíticos de TweetBinder de Audiense.

Características

• Acceda a los análisis de TweetBinder directamente desde Claude
• Analizar hashtags, usuarios y conversaciones en Twitter/X
• Obtenga métricas de participación, análisis de sentimientos y más
• Cree informes de Twitter con consultas de búsqueda personalizadas
• Comprobar el estado de generación del informe
• Recuperar estadísticas detalladas del informe
• Obtenga información sobre el saldo de la cuenta y la cuota
• Contar tweets que coinciden con consultas específicas
• Enumere y administre sus informes de TweetBinder
• Acceda al contenido de los tweets y a la información del usuario desde los informes

Instalación

Instalación mediante herrería

Para instalar mcp-tweetbinder para Claude Desktop automáticamente a través de Smithery :

Configuración manual

Prerrequisitos

• Node.js (v18 o superior)
• Aplicación de escritorio Claude
• Cuenta TweetBinder de Audiense con credenciales de API

1. Clonar este repositorio
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build

Necesita un token de portador de la API de TweetBinder válido para usar este servicio. Configúrelo en su entorno:

Uso con Claude Desktop

1. Edite su 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. Añade esta configuración:

3. Reiniciar Claude Desktop

Herramientas disponibles

create-twitter-report

Crea un nuevo informe que analiza los datos de Twitter/X según una consulta de búsqueda.

• Parámetros :
  • query (cadena): La consulta de búsqueda de datos de Twitter. Puede incluir operadores como AND, OR, hashtags, menciones, etc.
  • limit (número, opcional): número máximo de tweets a recuperar (hasta 50.000).
  • startDate (número, opcional): fecha de inicio como marca de tiempo Unix (segundos desde la época).
  • endDate (número, opcional): fecha de finalización como marca de tiempo Unix (segundos desde la época).
  • reportType (enumeración, opcional): Tipo de informe a crear: "7 días" para la última semana o "histórico" para todos los tiempos. Valor predeterminado: "7 días".
• Respuesta :
  • ID del informe e información de estado del informe creado.
  • Instrucciones para comprobar el estado del informe y recuperar estadísticas.

create-twitter-count

Crea un nuevo informe que cuenta los tweets que coinciden con una consulta de búsqueda.

• Parámetros :
  • query (cadena): La consulta de búsqueda de datos de Twitter. Puede incluir operadores como AND, OR, hashtags, menciones, etc.
  • reportType (enumeración, opcional): Tipo de informe a crear: "7 días" para la última semana o "histórico" para todos los tiempos. Valor predeterminado: "7 días".
• Respuesta :
  • Respuesta JSON sin procesar que contiene:
    • status : El estado de la creación del informe
    • resourceId : El ID del informe creado
    • error / message : Cualquier mensaje de error o estado

list-reports

Recupera una lista de todos sus informes de TweetBinder con capacidades de clasificación.

• Parámetros :
  • order (cadena, opcional): parámetro de ordenación con el formato 'campo|dirección'. Ejemplo: 'createdAt|-1' para lo más nuevo primero, 'createdAt|1' para lo más antiguo primero.
• Respuesta :
  • Respuesta JSON sin procesar que contiene una serie de informes con detalles para cada uno:
    • id : ID del informe
    • name : Nombre del informe
    • status : Estado actual (Generado, En espera, etc.)
    • createdAt : Marca de tiempo de creación
    • updatedAt : Marca de tiempo de la última actualización
    • type : Tipo de informe
    • source : Fuente del informe
    • query : Consulta de búsqueda original

get-report-content

Recupera los tweets o usuarios reales de un informe generado con filtrado y paginación avanzados.

• Parámetros :
  • reportId (cadena): el ID del informe cuyo contenido se recuperará.
  • contentType (enum): el tipo de contenido a recuperar: 'tweets' para datos de tweets o 'usuarios' para datos de usuarios.
  • page (número, opcional): Número de página para la paginación. Comienza en 1.
  • perPage (número, opcional): Número de elementos por página.
  • sortBy (cadena, opcional): Campo por el cual ordenar (por ejemplo, 'createdAt', 'counts.favorites').
  • sortDirection (enumeración, opcional): Dirección de ordenación: '1' para ascendente, '-1' para descendente.
  • filter (cadena, opcional): cadena JSON con criterios de filtrado. Ejemplo: '{"counts.favorites":{"$gt":10}}'
• Respuesta :
  • Respuesta JSON sin procesar que contiene:
    • items : Matriz de tweets o objetos de usuario
    • pagination : Información sobre el total de artículos y páginas

  Al solicitar tweets, se devuelve información detallada, que incluye:

  • ID del tweet, texto, fecha de creación, idioma
  • Datos del autor (nombre, nombre de usuario, seguidores, etc.)
  • Métricas de participación (retweets, me gusta, respuestas, etc.)
  • Contenido multimedia (hashtags, imágenes, enlaces)
  • Análisis de sentimientos

  Al solicitar a los usuarios, la información incluye:

  • ID de usuario, nombre, nombre de usuario
  • URL de la foto de perfil
  • Seguidores y conteos de seguidos
  • Estado de verificación
  • Valor del usuario y otras métricas

Nota: El informe debe estar en estado "Generado" para acceder al contenido. Utilice la herramienta get-report-status para comprobar si un informe está listo.

Ejemplos de sintaxis de consulta:

• #apple : Tweets que contienen el hashtag #apple
• apple lang:en : Tweets en inglés que contienen "apple"
• (#apple OR #iphone) -#android : Tweets con #apple o #iphone pero no #android
• @apple : Tweets que mencionan a @apple
• from:apple : Tweets publicados por el usuario "apple"

Nota: Después de crear el informe de recuento, utilice la herramienta get-report-status para verificar cuándo esté listo, luego utilice get-report-stats para obtener el recuento real.

get-report-status

Comprueba el estado actual de un informe de TweetBinder.

• Parámetros :
  • reportId (cadena): el ID del informe a comprobar.
• Respuesta :
  • El estado actual del informe, que puede ser uno de los siguientes:
    • Generado : El informe está completo y listo para usar.
    • Esperando : el informe aún se está generando o esperando que se recopilen los tweets.
    • Obsoleto : el informe se está actualizando con nuevos datos y estará disponible pronto.
    • Eliminado : el informe ha sido eliminado y ya no está disponible.
    • Archivado : El informe ha sido archivado y es posible que se elimine pronto.
  • Una explicación de lo que significa el estado y qué acciones están disponibles.

Nota: primero debe crear un informe utilizando la herramienta create-twitter-report o create-twitter-count para obtener un ID de informe.

get-report-stats

Recupera estadísticas y análisis completos para un informe de TweetBinder.

• Parámetros :
  • reportId (cadena): el ID del informe para el que se recuperarán las estadísticas.
• Respuesta :
  • Un resumen formateado de las estadísticas del informe que incluye:
    • Descripción general : total de tweets, rango de fechas, colaboradores, participación, medios y enlaces.
    • Métricas de participación : alcance potencial, impresiones, retuits y me gusta.
    • Análisis de sentimientos : puntuación general del sentimiento e interpretación.
    • Principales colaboradores : usuarios más activos y su cantidad de tweets.
    • Contenido popular : publicaciones más retuiteadas.
    • Hashtags de uso frecuente : hashtags comunes utilizados en la conversación.

Nota: El informe debe tener el estado "Generado" para poder recuperar las estadísticas. Utilice la herramienta get-report-status para comprobar si un informe está listo.

get-account-balances

Recupera información sobre el saldo de crédito, el uso y la cuota restante de su cuenta.

• Parámetros :
  • Ninguno
• Devoluciones :
  • Respuesta JSON sin procesar que contiene:
    • total : Total de créditos disponibles
    • used : Créditos utilizados
    • available : Créditos actualmente disponibles
    • discount : Cualquier descuento aplicable
    • remainingReports : Número de informes restantes
    • quota : Información de cuota que incluye:
      • startedAt : Fecha de inicio del período de cuota
      • finishedAt : Fecha de finalización del período de cuota
      • remaining : Cuota restante
      • used : Cuota usada
      • total : Cuota total
  • Cualquier mensaje de error o estado

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.
• Asegúrese de que el token de actualización siga siendo válido.
• Verifique que los ámbitos de API requeridos estén habilitados y que tenga suficientes créditos.

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.