Telegram Search — скилл
Скилл и CLI для экспорта и нечеткого поиска по истории Telegram: локальная база, векторный поиск, только чтение
- 4 148 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Работает с личной перепиской через авторизованную сессию Telegram
- Массовый экспорт истории требует доступа к аккаунту через Telegram Takeout
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/groupultra/telegram-search.git
cd telegram-search
pnpm install
cp .env.example .env
pnpm run devРежим только браузер для локальной разработки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Работает с личной перепиской через авторизованную сессию Telegram
- Массовый экспорт истории требует доступа к аккаунту через Telegram Takeout
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Telegram Search дает агенту CLI tg-search для работы с историей чатов Telegram через авторизованный локальный профиль. Можно посмотреть список чатов и прочитать ограниченный диапазон сообщений без сохранения, а после явного согласия пользователя синхронизировать историю через Telegram Takeout в локальную базу с полнотекстовым и векторным поиском, включая семантический поиск по картинкам. Дальше агент запрашивает, ищет и получает контекст сообщений локально, без обращения к Telegram, а также может выгрузить историю в детерминированный JSONL. Скилл прямо запрещает отправку или изменение сообщений и запрос секретов вроде кода входа или 2FA.
Для кого. Для тех, кому нужно быстро находить старые сообщения в больших чатах Telegram, включая поиск на разных языках и по смыслу, а не только по точным словам.
Подходит, если
- Нужно найти сообщение по смыслу, а не по точной формулировке, в большом чате
- Нужна сводка непрочитанных сообщений или ответ на вопрос по истории переписки
- Нужен выгруженный архив переписки в структурированном виде
Не подходит, если
- Нужно отправлять или изменять сообщения: скилл работает только на чтение
- Не готовы явно подтверждать чаты, диапазон и объем данных для Telegram Takeout
Пример запроса к агенту
Найди в чате нашей команды все сообщения про перенос релиза за последний месяц и покажи контекстОграничения
Массовая синхронизация истории идет через официальный механизм Telegram Takeout и требует авторизации запроса на экспорт данных на одном из ваших устройств Telegram, это не мгновенно. Нужен локально поднятый сервис (PGlite или PostgreSQL, опционально MinIO для медиа).
Как отключить. Остановите сервис (docker compose down) и удалите профиль CLI, а также удалите скилл telegram-search-cli из каталога скиллов агента.
Частые вопросы
Может ли агент случайно отправить сообщение?
Нет, скилл прямо запрещает отправку и изменение сообщений Telegram, это read-only инструмент.
Нужно ли подтверждать каждую синхронизацию?
Да, массовая синхронизация через Takeout запускается только после явного согласия пользователя на конкретные чаты и диапазон, и требует подтверждения на устройстве Telegram.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыTG Telegram Parser, CLI с MCP, обновляет выгрузку канала: добавляет новые посты и возвращается к выбранному окну обсуждений.
Скилл аналитики BotHelp
claude-skill-bothelp
Скилл Claude Code для BotHelp Open API: карта ботов, drop-off по шагам, экспорт подписчиков и точечное управление через открытый API
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
Телеграм-бот для OpenCode: ставит задачи агенту, следит за ходом работы и переключает модели с телефона, пока OpenCode работает на вашем компьютере
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
Из блога
Коротко о README
Основной README на китайском описывает продукт как способ бэкапить и находить сообщения Telegram с помощью локального сегментатора текста и векторного поиска, включая поиск по картинкам и умные сводки непрочитанного. Есть готовый онлайн-демо, Docker-образ для сервера и режимы разработки, только браузер или сервер с PGlite/PostgreSQL и MinIO. Отдельный SKILL.md для агентов на английском фиксирует жесткие контракты: bounded remote reads без сохранения, синхронизация только после согласия пользователя, запрет на отправку сообщений и запрос секретов. Лицензия AGPL-3.0.
Бейдж для README
Исходный SKILL.md
--- name: telegram-search-cli description: Operate the Telegram Search CLI through an authorized local profile. Use when an agent needs to discover Telegram chats, read bounded remote messages, explicitly synchronize history with user-approved Telegram Takeout, query/search/contextualize persisted messages, compute statistics, export deterministic JSONL, or run a real CLI end-to-end canary. Never send or modify Telegram messages. --- # Telegram Search CLI Use the CLI as a local-first data tool. Let the agent compose atomic commands; do not require the web UI or a daemon. ## Contracts - Treat stdout as exactly one JSON envelope. Read diagnostics, prompts, migration output, and progress from stderr. - Use `chats list` and `messages list` for bounded remote reads without persistence. - Use local `messages query`, `search`, `context`, `stats`, and `export` without connecting to Telegram. - Use `sync --takeout` for message persistence and bulk history. Add `--takeout` only after the user explicitly approves the selected chats, time range, and data scope. - Never send messages or modify Telegram data.