@theyahia/tgstat-mcp

🌍 Часть WWmcp — коллекции из 114 MCP-серверов для развивающихся рынков (Россия, СНГ, MENA, Gulf, SE Asia, Africa). Единственная коллекция MCP, покрывающая не-западные API.

MCP-сервер для TGStat API — аналитика Telegram-каналов: поиск каналов и постов, статистика, динамика подписчиков и охватов, ERR, упоминания, тренды ключевых слов, сравнение каналов. 20 инструментов.

Установка

1. Получите токен

TGSTAT_TOKEN — API-ключ TGStat. Зарегистрируйтесь и получите токен на api.tgstat.ru (нужен доступ к Stat API и/или Search API — разные инструменты требуют разных пакетов). Текущую квоту и срок пакета смотрите инструментом get_usage.

2. Подключите сервер

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tgstat": {
      "command": "npx",
      "args": ["-y", "@theyahia/tgstat-mcp"],
      "env": {
        "TGSTAT_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Code:

claude mcp add tgstat -e TGSTAT_TOKEN=ваш_токен -- npx -y @theyahia/tgstat-mcp

Related MCP server: lolzteam-mcp

Инструменты (20)

Каналы

Посты

Метрики (динамика во времени)

Ключевые слова

Справочники

Использование

Формат вывода

Ответы курируются: возвращаются только релевантные поля (подписчики, охваты, ERR, текст-сниппет, ссылки), даты — в ISO. Это экономит токены контекста и упрощает ответы модели. Даты в фильтрах указываются как YYYY-MM-DD и автоматически конвертируются в Unix-таймстемпы, которых требует API.

Примеры запросов

Найди Telegram-каналы про маркетинг на русском
Какая статистика у @durov — подписчики, средний охват, ERR?
Покажи рост подписчиков @vc_ru по неделям за последние 3 месяца
Сравни каналы @rbc_news, @kommersant и @vedomosti по охвату и ERR
Найди посты про AI за январь 2026
Построй динамику упоминаний слова «нейросети» по месяцам
Кто упоминает канал @thebell_io?
Сколько у меня осталось запросов в TGStat API?

WWmcp — связки с соседними серверами

TGStat закрывает аналитику; соседние серверы из WWmcp — действие:

• vk-ads-mcp — рекламные кампании VK Ads

• sendpulse-mcp · unisender-mcp — email-рассылки

Пример сценария: «Найди топ финтех-каналы в Telegram (tgstat), оцени их ERR, выбери три с лучшим охватом и подготовь email-анонс через unisender».

Разработка

npm install
npm run build      # компиляция в dist/
npm run typecheck  # проверка типов, включая тесты
npm test           # vitest

⭐ Поддержать

Если сервер полезен — поставьте звезду этому репозиторию и WWmcp. Это помогает другим найти коллекцию серверов для не-западных API.

Лицензия

MIT