telegram-reader

Read and export Telegram channel messages for financial news research using the tdl CLI.

3.3k|382|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/himself65/finance-skills --skill telegram-reader-himself65
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: telegram-reader
Source: https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills/telegram-reader
Command: npx skills add https://github.com/himself65/finance-skills --skill telegram-reader-himself65

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tdl, and includes references (resource) components.

What problem does it solve? Financial news and market signals often appear first in Telegram channels and groups, but manually monitoring dozens of channels is time-consuming. This Skill lets an AI agent read, search, and export messages from your Telegram channels directly from the command line. ## Core Features & Use Cases - List and search chats: View all your Telegram channels, groups, and contacts with filters, and find channels by name or type. - Export messages: Fetch recent messages, or messages within a specific time range or ID range, from any channel you have joined. - Read-only safety: The Skill cannot send messages, join or leave channels, or perform any write operations. - Use Case: Ask your agent to pull the last 20 messages from a crypto news channel and a macro channel, then summarize breaking news, price targets, and earnings surprises grouped by theme. ## Quick Start Ask the agent to check what is new in your Telegram financial news channels and summarize the latest market updates.

Frequently Asked Questions about telegram-reader

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

FAQPage Schema
How do I read Telegram channel messages from the command line?▼

Use tdl chat export with the channel username, for example tdl chat export -c @channel_name -T last -i 20 --all --with-content -o export.json. The --all --with-content flags ensure text messages are included, and the JSON output file can then be read and summarized.

How do I log in to tdl for Telegram access?▼

Run tdl login -T qr and scan the QR code with your Telegram mobile app under Settings > Devices > Link Desktop Device. Login is one-time and the session persists on disk. Alternatively use tdl login -T code for phone and verification code login.

Can this skill send Telegram messages or join channels?▼

No, the skill is strictly read-only. It can list chats and export messages from channels you have already joined, but it cannot send messages, join or leave channels, or perform any write operations.

Does telegram-reader work on Claude.ai?▼

No, it works on Claude Code and other CLI-based agents only. The Claude.ai sandbox restricts the network access and local binaries that tdl requires to connect to Telegram.

Why does tdl export return a FLOOD_WAIT or CHANNEL_PRIVATE error?▼

FLOOD_WAIT_X means Telegram rate-limited the request; wait X seconds and retry. CHANNEL_PRIVATE means your account lacks access; join the channel in your Telegram app first, then export again.