Servidor MCP de Sprout Social

Un servidor de Model Context Protocol (MCP) para la API de Sprout Social. Permite a los asistentes de IA (Claude, Cursor, Devin, etc.) acceder a tus datos de Sprout Social —analíticas, publicación, mensajes, escucha y más— a través de una interfaz estandarizada.

Inicio rápido

Requisitos previos

• Node.js 18+

• Un token de API de Sprout Social (cómo crear uno)

• Tu ID de cliente de Sprout Social (cómo encontrarlo)

Ejecución mediante npx

No requiere instalación:

SPROUT_SOCIAL_API_KEY=your-token \
SPROUT_SOCIAL_CUSTOMER_ID=your-customer-id \
npx sprout-social-mcp

Configuración con Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "sprout-social": {
      "command": "npx",
      "args": ["-y", "sprout-social-mcp"],
      "env": {
        "SPROUT_SOCIAL_API_KEY": "your-api-token",
        "SPROUT_SOCIAL_CUSTOMER_ID": "your-customer-id"
      }
    }
  }
}

Configuración con Cursor

Añade a tu .cursor/mcp.json:

{
  "mcpServers": {
    "sprout-social": {
      "command": "npx",
      "args": ["-y", "sprout-social-mcp"],
      "env": {
        "SPROUT_SOCIAL_API_KEY": "your-api-token",
        "SPROUT_SOCIAL_CUSTOMER_ID": "your-customer-id"
      }
    }
  }
}

Configuración con VS Code (GitHub Copilot)

Añade a tu .vscode/mcp.json:

{
  "servers": {
    "sprout-social": {
      "command": "npx",
      "args": ["-y", "sprout-social-mcp"],
      "env": {
        "SPROUT_SOCIAL_API_KEY": "your-api-token",
        "SPROUT_SOCIAL_CUSTOMER_ID": "your-customer-id"
      }
    }
  }
}

Configuración con Devin

En la configuración MCP de Devin, añade un nuevo servidor:

• Nombre: sprout-social

• Comando: npx -y sprout-social-mcp

• Variables de entorno:

  • SPROUT_SOCIAL_API_KEY → tu token de API

  • SPROUT_SOCIAL_CUSTOMER_ID → tu ID de cliente

Variables de entorno

Herramientas disponibles

Metadatos del cliente

Analíticas

Mensajes

Escucha

Publicación

Medios

Casos

Consejos de uso

Paginación de analíticas de publicaciones

La API de Sprout Social pagina las analíticas de publicaciones. Comprueba siempre paging.total_pages en la respuesta y solicita todas las páginas:

Ask: "Get all Instagram post analytics for last week"
→ Tool calls get_post_analytics with page=1, then page=2, etc.

Métricas válidas a nivel de publicación

• lifetime.impressions — total de visualizaciones

• lifetime.engagements — total de interacciones (me gusta, comentarios, compartidos, guardados)

• lifetime.reactions — solo reacciones

• lifetime.video_views — recuento de visualizaciones de video

Métricas no válidas (causarán errores): lifetime.comments, lifetime.shares, lifetime.reach

Encontrar IDs de perfil

Usa get_profiles primero para descubrir tus valores de customer_profile_id, luego pásalos a las herramientas de analíticas o publicación.

Desarrollo

git clone https://github.com/jginorio/sprout-social-mcp.git
cd sprout-social-mcp
npm install
npm run build

Para probar localmente:

SPROUT_SOCIAL_API_KEY=your-token \
SPROUT_SOCIAL_CUSTOMER_ID=your-customer-id \
node dist/index.js

Licencia

MIT