MCP-сервер Sprout Social

Сервер Model Context Protocol (MCP) для API Sprout Social. Он позволяет ИИ-ассистентам (Claude, Cursor, Devin и др.) получать доступ к вашим данным Sprout Social — аналитике, публикациям, сообщениям, мониторингу и многому другому — через стандартизированный интерфейс.

Быстрый старт

Предварительные требования

• Node.js 18+

• API-токен Sprout Social (как создать)

• Ваш ID клиента Sprout Social (как найти)

Запуск через npx

Установка не требуется:

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

Настройка в Claude Desktop

Добавьте в ваш 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"
      }
    }
  }
}

Настройка в Cursor

Добавьте в ваш .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"
      }
    }
  }
}

Настройка в VS Code (GitHub Copilot)

Добавьте в ваш .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"
      }
    }
  }
}

Настройка в Devin

В настройках MCP в Devin добавьте новый сервер:

• Имя: sprout-social

• Команда: npx -y sprout-social-mcp

• Переменные окружения:

  • SPROUT_SOCIAL_API_KEY → ваш API-токен

  • SPROUT_SOCIAL_CUSTOMER_ID → ваш ID клиента

Переменные окружения

Доступные инструменты

Метаданные клиента

Аналитика

Сообщения

Мониторинг

Публикации

Медиа

Обращения

Советы по использованию

Пагинация аналитики публикаций

API Sprout Social использует пагинацию для аналитики публикаций. Всегда проверяйте paging.total_pages в ответе и запрашивайте все страницы:

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

Допустимые метрики уровня публикации

• lifetime.impressions — общее количество показов

• lifetime.engagements — общая вовлеченность (лайки, комментарии, репосты, сохранения)

• lifetime.reactions — только реакции

• lifetime.video_views — количество просмотров видео

Недопустимые метрики (вызовут ошибки): lifetime.comments, lifetime.shares, lifetime.reach

Поиск ID профилей

Сначала используйте get_profiles, чтобы найти значения customer_profile_id, а затем передавайте их в инструменты аналитики или публикации.

Разработка

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

Для локального тестирования:

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

Лицензия

MIT