Telegram Search

Установка

npx skillfoxx add skills/telegram-search

npx skills add groupultra/telegram-search --skill telegram-search-cli -a claude-code -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .claude/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .claude/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a cursor -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a github-copilot -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .github/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .github/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a codex -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a gemini-cli -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .devin/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .devin/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a cline -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .cline/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .cline/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a roo -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .roo/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .roo/skills/telegram-search-cli

npx skills add groupultra/telegram-search --skill telegram-search-cli -a opencode -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/groupultra/telegram-search.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/telegram-search-cli/
git -C "$tmp" checkout 5d734888401f0a63a86e3dd29f942a5275da0207
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/telegram-search-cli" .agents/skills/telegram-search-cli

git clone https://github.com/groupultra/telegram-search.git
cd telegram-search
pnpm install
cp .env.example .env
pnpm run dev

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Telegram Search дает агенту CLI tg-search для работы с историей чатов Telegram через авторизованный локальный профиль. Можно посмотреть список чатов и прочитать ограниченный диапазон сообщений без сохранения, а после явного согласия пользователя синхронизировать историю через Telegram Takeout в локальную базу с полнотекстовым и векторным поиском, включая семантический поиск по картинкам. Дальше агент запрашивает, ищет и получает контекст сообщений локально, без обращения к Telegram, а также может выгрузить историю в детерминированный JSONL. Скилл прямо запрещает отправку или изменение сообщений и запрос секретов вроде кода входа или 2FA.

Для кого. Для тех, кому нужно быстро находить старые сообщения в больших чатах Telegram, включая поиск на разных языках и по смыслу, а не только по точным словам.

Пример запроса к агенту

Найди в чате нашей команды все сообщения про перенос релиза за последний месяц и покажи контекст

Ограничения

Массовая синхронизация истории идет через официальный механизм Telegram Takeout и требует авторизации запроса на экспорт данных на одном из ваших устройств Telegram, это не мгновенно. Нужен локально поднятый сервис (PGlite или PostgreSQL, опционально MinIO для медиа).

Как отключить. Остановите сервис (docker compose down) и удалите профиль CLI, а также удалите скилл telegram-search-cli из каталога скиллов агента.

Проверка безопасности

• Работает с личной перепиской через авторизованную сессию Telegram
• Массовый экспорт истории требует доступа к аккаунту через Telegram Takeout

Коротко о README

Основной README на китайском описывает продукт как способ бэкапить и находить сообщения Telegram с помощью локального сегментатора текста и векторного поиска, включая поиск по картинкам и умные сводки непрочитанного. Есть готовый онлайн-демо, Docker-образ для сервера и режимы разработки, только браузер или сервер с PGlite/PostgreSQL и MinIO. Отдельный SKILL.md для агентов на английском фиксирует жесткие контракты: bounded remote reads без сохранения, синхронизация только после согласия пользователя, запрет на отправку сообщений и запрос секретов. Лицензия AGPL-3.0.

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.

Похожие