@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

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

Каналы

| Инструмент | Описание | |------------|----------| | search_channels | Поиск каналов по запросу с фильтрами категории / языка / страны / типа | | get_channel | Профиль канала: подписчики, категория, индекс цитирования (ci_index), отметка РКН | | get_channel_stats | Статистика: средний охват поста, ERR%, дневной охват | | get_channel_mentions | Где канал упоминают / репостят другие каналы и чаты | | compare_channels | Сравнение каналов (2–10) по подписчикам, охвату и ERR — таблицей |

Посты

| Инструмент | Описание | |------------|----------| | get_channel_posts | Последние посты канала с просмотрами; фильтр по датам и пагинация | | get_post | Детали поста: просмотры, репосты, реакции, текст | | search_posts | Полнотекстовый поиск постов с фильтрами типа / категории / языка / страны / дат | | get_post_stats | Динамика вовлечённости поста во времени |

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

| Инструмент | Описание | |------------|----------| | get_channel_subscribers | История числа подписчиков (group: hour/day/week/month) | | get_channel_views | История суммарных просмотров постов | | get_channel_avg_reach | История среднего охвата поста | | get_channel_err | История ERR (engagement rate by reach) | | get_channel_forwards | Посты других каналов, репостнувшие контент канала |

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

| Инструмент | Описание | |------------|----------| | get_word_mentions | Динамика упоминаний слова/фразы по периодам (упоминания + просмотры) | | get_word_mentions_by_channels | Разбивка упоминаний слова по каналам |

Справочники

| Инструмент | Описание | |------------|----------| | list_categories | Коды категорий каналов (для фильтра category) | | list_countries | Коды стран (для фильтра country) | | list_languages | Коды языков (для фильтра language) |

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

| Инструмент | Описание | |------------|----------| | get_usage | Квота и лимиты API: израсходовано запросов / каналов / слов, срок пакета |

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

Ответы курируются: возвращаются только релевантные поля (подписчики, охваты, 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