search-telegram

Searches and reads Telegram channel and group history via MTProto or cached indexes.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/MDSIXONE/opencode-config --skill search-telegram-mdsixone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search-telegram
Source: https://github.com/MDSIXONE/opencode-config/tree/main/skills/search-telegram
Command: npx skills add https://github.com/MDSIXONE/opencode-config --skill search-telegram-mdsixone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving historical messages from Telegram channels and groups is difficult because the Bot API cannot read history from before a bot joined, and manual scrolling through long chat archives is impractical. This Skill provides a read-only workflow for searching Telegram content using an already-logged-in Telegram Web session, user-provided exports, or local cached indexes. ## Core Features & Use Cases - Read-only history search: Search public channels, groups, and message history by keyword, time range, or topic using MTProto/User API tools or cached indexes. - Source verification: Output message links, channel names, timestamps, message IDs, and context limits so results are verifiable. - Safe fallback paths: Use the telecrawl tool for deep caching when available, or fall back to WebSearch and browser-based reading of public channel pages. - Use Case: A researcher needs to find all messages about a specific topic posted in a public Telegram channel over the past year. The Skill queries the logged-in Telegram Web session or a telecrawl cache and returns matching messages with links and timestamps. ## Quick Start Search the public Telegram channel I linked for all messages mentioning "release notes" from the past six months and list them with links and dates.

Frequently Asked Questions about search-telegram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Telegram channel history by keyword?▼

Search Telegram channel history by using an already-logged-in Telegram Web session, a user-provided export, or a local read-only index. For deep archives, the telecrawl tool can build a cache that supports keyword and time-range queries.

Can the Telegram Bot API read old group messages?▼

No, the Bot API generally cannot read messages sent before the bot joined or content outside its authorized scope. Historical search requires MTProto/User API access, an existing logged-in session, or exported chat data.

What is telecrawl used for in Telegram search?▼

telecrawl is an optional fallback tool for deep caching of Telegram history. When installed, it builds a local cache that enables read-only retrieval of large message archives with rate control.

Can I search private Telegram groups or deleted messages?▼

No, private groups, deleted messages, and restricted channels cannot be reliably accessed. The Skill only reads content that is public or visible under the user's existing authorization and never bypasses permission or region limits.

Does Telegram search require storing credentials or session tokens?▼

No, the workflow never stores phone numbers, verification codes, sessions, API IDs, API hashes, tokens, or cookies. It only reuses an already-authenticated Telegram Web session in read-only mode.