Считайте охваты и ERR своих Telegram-каналов в чате

Агент ходит в api.tgstat.ru и читает аналитику Telegram-каналов: карточки и статистику каналов, публикации и stories, упоминания и репосты, динамику подписчиков и просмотров. Поверх сырых чисел он считает средний охват, ER и ERR, строит динамику по дням и называет публикации, вытянувшие период, а по отдельному посту поднимает почасовой разбор просмотров, реакций и репостов.

TGStat — это индекс поверх публичных каналов, а не сам Telegram. Агент видит ровно то, что сервис успел проиндексировать: закрытые каналы и чаты в выдачу не попадают, а по свежесозданному каналу статистика набирается не сразу. Поэтому упоминания бренда агент ищет по индексу и оговаривает его границы: пусто в выдаче означает «нет в индексе», а не «о вас не пишут».

На запись здесь делать почти нечего, и агент этого не скрывает: через TGStat нельзя опубликовать пост, отредактировать канал или написать подписчикам. Единственное изменяющее действие — добавление канала в индекс сервиса, и агент выполняет его только по прямой просьбе. Всё остальное — чтение: сведение своих каналов в один отчёт и сравнение чужих по подписчикам, охвату и ERR при подборе площадок под размещение.

Объём выдачи упирается в квоту запросов, и агент считает её заранее: остаток проверяет перед поиском, длинный период разбивает на окна по датам, а посты и упоминания забирает страницами, а не одним махом. Повторный вопрос по тому же каналу он не оплачивает вторым запросом, если цифры за это время не успели измениться. Частоту запросов агент держит в пределах лимита, а если данных нет — скажет прямо, а не покажет пустую таблицу.