TG CLI
TG Telegram Parser, CLI с MCP, обновляет выгрузку канала: добавляет новые посты и возвращается к выбранному окну обсуждений.
- 241 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает доступную аккаунту историю Telegram и сохраняет сообщения, сведения пользователей и медиа локально; опциональный анализ передает данные модели.
Установка
- Сервисы
Ручная установка
docker compose up --buildПервый запуск из локальной копии репозитория. Docker создает env-шаблон; реальные доступы вводятся владельцем отдельно.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает доступную аккаунту историю Telegram и сохраняет сообщения, сведения пользователей и медиа локально; опциональный анализ передает данные модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TG Telegram Parser, инструмент с CLI и MCP, собирает посты каналов Telegram вместе с комментариями обсуждений и реакциями. Экспорт можно сохранить в JSON, CSV, Parquet или PostgreSQL, а при необходимости скачать медиа. Локальная веб-панель показывает посты, дерево комментариев и показатели наборов данных. Повторный запуск умеет добавлять новые посты и обновлять часть ранее выгруженных. Отдельные команды сравнивают периоды и анализируют экспорт через настроенную языковую модель. Через CLI и MCP агент вызывает эти операции без ручного управления панелью.
Для кого. Редакторам Telegram-каналов, которые анализируют обсуждения и сравнивают реакцию аудитории по сохраненным выгрузкам.
Подходит, если
- Редактор собирает посты и комментарии своих каналов для анализа.
- После первой выгрузки оператор добавляет новые посты и обновляет недавние обсуждения.
- В отчете сравнивают комментарии, участников и реакции двух периодов.
- Сохраненный JSON открывают локально без нового подключения к Telegram.
Не подходит, если
- Учетная запись не имеет доступа к нужному каналу или обсуждениям.
- Выгрузку с пользовательскими именами собираются публиковать без проверки.
- От инкрементального режима ожидается постоянное обновление всей истории без ограничения окна.
Пример запроса к агенту
Выгрузи посты и комментарии моего канала за согласованный период, включи анонимизацию и сохрани локально без отправки в LLM.Ограничения
Для экспорта нужны API_ID, API_HASH и сессия Telegram-аккаунта; храните файл сессии отдельно от публичных материалов. При повторном экспорте TG обновляет новые посты и заданное число старых, поэтому комментарии за пределами окна могут остаться прежними. При анонимизации TG заменяет выбранные поля пользователя, но текст сообщений нужно проверить отдельно перед передачей. Для анализа внешней моделью пользователь отдельно настраивает провайдера, после чего TG отправляет ему содержимое выгрузки.
Как отключить. Остановите Docker-сервисы, планировщик и режим наблюдения. Проверьте сохраненные сессии, выгрузки и медиа перед их удалением или передачей.
Частые вопросы
Как открыть панель?
После `docker compose up --build` откройте `http://localhost:9595`. Настройки Telegram вводятся в разделе экспорта.
Можно ли попробовать без Telegram?
Да. В репозитории есть демонстрационный JSON для локальной панели. Используйте его перед настройкой аккаунта.
Как проверить настройки?
Запустите `docker compose run --rm cli config-check`. Исправьте недостающие параметры перед экспортом.
Что обновляется при повторной выгрузке?
Новые посты и число старых постов, заданное через `INCREMENTAL_LOOKBACK_POSTS`. Для них обновляются комментарии, реакции и счетчики; обсуждения вне этого окна могут остаться в прежнем состоянии.
Обязательно ли использовать LLM?
Нет. Экспорт и локальная панель работают отдельно от команды анализа. Подключайте модель только для согласованной задачи.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыTGStat MCP
tgstat-mcp
MCP-сервер TGStat: поиск Telegram-каналов и постов, динамика подписчиков и охватов, ERR и упоминания
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
MCP-мост из VK в Telegram
vk-tg-bridge
MCP-сервер на 4 инструмента: забирает посты со стены VK, фильтрует по правилам и публикует в Telegram через Bot API
Коротко о README
Режим наблюдения держит Telegram-сессию открытой и обновляет активные обсуждения. Его запускают отдельно от планировщика, который выполняет выгрузки по расписанию.