Sprout Social MCP-Server

Ein Model Context Protocol (MCP)-Server für die Sprout Social API. Er ermöglicht es KI-Assistenten (Claude, Cursor, Devin usw.), auf Ihre Sprout Social-Daten zuzugreifen – Analysen, Veröffentlichungen, Nachrichten, Listening und mehr – über eine standardisierte Schnittstelle.

Schnellstart

Voraussetzungen

• Node.js 18+

• Ein Sprout Social API-Token (Anleitung zur Erstellung)

• Ihre Sprout Social-Kunden-ID (Anleitung zum Finden)

Ausführung via npx

Keine Installation erforderlich:

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

Konfiguration mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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"
      }
    }
  }
}

Konfiguration mit Cursor

Fügen Sie dies zu Ihrer .cursor/mcp.json hinzu:

{
  "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"
      }
    }
  }
}

Konfiguration mit VS Code (GitHub Copilot)

Fügen Sie dies zu Ihrer .vscode/mcp.json hinzu:

{
  "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"
      }
    }
  }
}

Konfiguration mit Devin

Fügen Sie in den MCP-Einstellungen von Devin einen neuen Server hinzu:

• Name: sprout-social

• Befehl: npx -y sprout-social-mcp

• Umgebungsvariablen:

  • SPROUT_SOCIAL_API_KEY → Ihr API-Token

  • SPROUT_SOCIAL_CUSTOMER_ID → Ihre Kunden-ID

Umgebungsvariablen

Verfügbare Tools

Kunden-Metadaten

Analysen

Nachrichten

Listening

Veröffentlichungen

Medien

Fälle

Nutzungstipps

Paginierung von Beitragsanalysen

Die Sprout Social API paginiert Beitragsanalysen. Überprüfen Sie immer paging.total_pages in der Antwort und fordern Sie alle Seiten an:

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

Gültige Metriken auf Beitragsebene

• lifetime.impressions — Gesamtaufrufe

• lifetime.engagements — Gesamte Interaktionen (Likes, Kommentare, Shares, Speicherungen)

• lifetime.reactions — Nur Reaktionen

• lifetime.video_views — Anzahl der Videoaufrufe

Ungültige Metriken (verursachen Fehler): lifetime.comments, lifetime.shares, lifetime.reach

Finden von Profil-IDs

Verwenden Sie zuerst get_profiles, um Ihre customer_profile_id-Werte zu ermitteln, und übergeben Sie diese dann an Analyse- oder Veröffentlichungstools.

Entwicklung

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

Zum lokalen Testen:

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

Lizenz

MIT