MCP-сервер для TGStat — аналитика Telegram-каналов через ИИ
🌍 Часть WWmcp — коллекции из 46 MCP-серверов для развивающихся рынков (Россия, СНГ, MENA, Gulf, SE Asia, Africa). Единственная коллекция MCP, покрывающая не-западные API.
Если вы искали, как выгрузить статистику Telegram-канала не копируя её руками из TGStat, сравнить каналы перед закупкой рекламы или отследить упоминания бренда — это оно. 20 инструментов: поиск каналов и постов, динамика подписчиков и охватов, ERR, упоминания, тренды ключевых слов, сравнение каналов. Спрашиваете «сравни эти три канала по ERR за месяц» — получаете таблицу, а не десять вкладок.
Установка
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)
Каналы
Посты
Метрики (динамика во времени)
Ключевые слова
Справочники
Использование
Формат вывода
Ответы курируются: возвращаются только релевантные поля (подписчики, охваты, 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 Adssendpulse-mcp·unisender-mcp— email-рассылки
Пример сценария: «Найди топ финтех-каналы в Telegram (tgstat), оцени их ERR, выбери три с лучшим охватом и подготовь email-анонс через unisender».
Разработка
npm install
npm run build # компиляция в dist/
npm run typecheck # проверка типов, включая тесты
npm test # vitest
⭐ Поддержать
Если сервер полезен — поставьте звезду этому репозиторию и WWmcp. Это помогает другим найти коллекцию серверов для не-западных API.
Лицензия
MIT