Telegram Channel Reader
для OpenClaw

Навык для AI-агента: читает Telegram-каналы через официальный протокол MTProto — посты, комментарии, просмотры, репосты. Агент делает выводы на этих данных.

2275загрузок
61установок
35версий
6★ на GitHub
npx clawhub@latest install sergei-mikhailov-tg-channel-reader

Зачем нужен навык, если есть веб-мониторинг

OpenClaw умеет читать Telegram через браузер. Но веб-скрейпинг ломается каждый раз, когда Telegram меняет интерфейс. И не видит приватные каналы.

  1. Веб-скрейпинг ломается при обновлении Telegram — вы получаете пустой результат и не знаете об этом
  2. Через браузер нельзя читать приватные каналы, даже если вы подписаны
  3. Веб-скрейпинг отдаёт только текст — без просмотров, репостов и ссылок
  4. Браузер медленный: рендеринг страницы занимает секунды, MTProto — миллисекунды
  5. Частые блокировки и капчи при веб-скрейпинге

Как работает

1

Получите API-ключ Telegram

Бесплатно на my.telegram.org за две минуты. Нужен api_id и api_hash.

2

Авторизуйтесь один раз

Команда tg-reader auth — введите номер, подтвердите код из Telegram. Сессия сохраняется, повторять не нужно.

3

Просите агента

«Саммари за 24 часа из @durov» — агент вызывает навык, получает JSON с постами и комментариями, делает выводы.

Что умеет

Посты и комментарии по временному окну

24h, 7d, 2w или конкретная дата. Один или несколько каналов в одном запросе.

Просмотры, репосты, прямые ссылки

Каждый пост — с метриками охвата и ссылкой на оригинал. Не просто текст, а данные для анализа.

Приватные каналы

Любой канал, на который вы подписаны — публичный или приватный. Бот-админ не нужен.

Две библиотеки MTProto

Pyrogram (по умолчанию) или Telethon — переключение одной командой. Если одна падает, вторая работает.

JSON на выходе — готовый для агента

Не HTML, который надо парсить. Структурированные данные, которые агент сразу анализирует.

Не отправляет, не удаляет, не модифицирует

Только чтение. Навык не пишет от вашего имени и не трогает ваши данные.

MTProto vs веб-скрейпинг

Веб-скрейпингЭтот навык (MTProto)
НадёжностьЛомается при обновлении UIОфициальный протокол — всегда работает
СкоростьСекунды (рендеринг)Миллисекунды (прямой API)
Приватные каналыТолько публичныеЛюбые, где вы подписаны
ДанныеТолько текстПросмотры, репосты, ссылки, даты
БлокировкиКапчи, баныМягкие лимиты, хватает для работы
Для агентаНужен парсинг HTMLЧистый JSON, готов к анализу

Сценарии использования

Навык даёт данные: посты, комментарии, просмотры, репосты. Агент — делает выводы. Вот что можно построить на этих данных.

Анализ комментариев — как воспринимают публикации

Навык собирает посты и комментарии к ним. Агент анализирует: какие темы вызвали обсуждение, что хвалят, что критикуют, какие вопросы повторяются. Вы получаете картину восприятия — не отдельные комментарии.

Сравнение охватов — что зашло, что нет

У каждого поста есть просмотры и репосты. Агент сортирует по охвату, выделяет топ-посты и аутсайдеров, ищет закономерности: время публикации, формат, тема. Вы видите, что работает — без ручного перебора.

Ежедневные дайджесты по расписанию

Навык поддерживает режим unread — помнит, что вы уже читали. Настройте cron, и агент будет присылать саммари новых постов каждый день или неделю. Дайджест приходит сам: ключевые темы, топ-посты, необычное.

Мониторинг каналов конкурентов

Подпишитесь на каналы конкурентов — навык соберёт посты и метрики, агент сделает саммари: что публикуют, какие посты набирают охват, как аудитория реагирует. Не нужно читать вручную.

Отслеживание упоминаний и всплесков

Агент может отслеживать упоминания ключевых слов или всплески активности в данных навыка. Если в канале выросли комментарии или появилось ваше название — вы узнаете первыми.

Сравнение периодов

Сравните неделю с неделей, месяц с месяцем. Агент видит, какие темы набирают охват, а какие затухают. Полезно для контент-стратегии и понимания, куда движется аудитория.

Вопросы

Безопасно ли это?

Навык использует MTProto — официальный протокол Telegram. Сессионный файл даёт полный доступ к аккаунту, поэтому храните его с правами 600 и не коммитьте в git. Навык только читает — не отправляет, не удаляет, не модифицирует.

Нужен ли бот-админ в канале?

Нет. Навык работает от имени вашего аккаунта Telegram. Если вы подписаны на канал — публичный или приватный — навык его прочитает.

Какие зависимости нужны?

Python 3.10+, pyrofork (или pyrogram), tgcrypto, telethon. Установка через pip install или venv. Подробности — в README на GitHub.

Можно ли использовать с другими AI-агентами?

Навык создан для OpenClaw, но по сути это Python-скрипт с CLI. Можно вызвать из любого агента, который умеет запускать команды. JSON-вывод универсален.

Что делать, если не приходит код авторизации?

Код приходит в приложение Telegram, не по SMS. Проверьте все устройства, где открыт Telegram. Если не помогло — запустите python3 debug_auth.py для подробных логов MTProto.

Лицензия?

MIT. Используйте, форкайте, меняйте. Автор — @bzSega.

Попробовать

Установка — одна команда. Настройка — пять минут. После этого просите агента: «Саммари за неделю из @channel» — и получаете готовый анализ.

npx clawhub@latest install sergei-mikhailov-tg-channel-reader