Skip to main content
ClaudeWave
EN, English
groupultra / Subagents

telegram-search

🔍 导出并模糊搜索 Telegram 聊天记录 | Export and fuzzy search your Telegram chat history

  • 4.1k stars
  • 275 forks
  • 8 open issues
  • Language: TypeScript
  • License: AGPL-3.0
  • updated

Install

Terminal
git clone https://github.com/groupultra/telegram-search && cp telegram-search/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.

Editor's note

Telegram Search is a TypeScript application that exports Telegram chat history and makes it searchable through a combination of fuzzy text matching and vector semantic search. It connects to Telegram via the official MTProto API using credentials from my.telegram.org, then stores messages in either PGlite or PostgreSQL with pgvector, while optionally backing up media files to MinIO object storage. The search interface supports multilingual tokenization, image-to-text semantic search via embeddings, and a RAG-based chat mode that lets users ask questions against their own message history. A companion Telegram bot allows searching and exporting directly within Telegram, with deep links that jump back to the original conversation. An unread message summarization feature automatically condenses pending messages across chats. The project exposes an MCP integration, making it usable as a Claude subagent, and embeds LLM and embedding model settings are configured per account through the in-app settings panel rather than environment variables. Developers, researchers, and heavy Telegram users who need to retrieve specific messages across large multilingual histories are the primary audience.

Installable items

1 items in this repository

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.

Install
README

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
Topics
aiai-agentembeddingmcptelegramtelegram-bot
Frequently asked

What people ask about telegram-search

What is groupultra/telegram-search?

groupultra/telegram-search is subagents for the Claude AI ecosystem. 🔍 导出并模糊搜索 Telegram 聊天记录 | Export and fuzzy search your Telegram chat history It has 4.1k GitHub stars and its last recorded update is dated 2026-10-17.

How do I install telegram-search?

You can install telegram-search by cloning the repository (https://github.com/groupultra/telegram-search) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is groupultra/telegram-search safe to use?

Our security agent has analyzed groupultra/telegram-search and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains groupultra/telegram-search?

groupultra/telegram-search is maintained by groupultra. The last recorded GitHub activity is dated 2026-10-17, with 8 open issues.

Are there alternatives to telegram-search?

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.