himself65/finance-skills / plugins/social-readers/skills/telegram-reader
telegram-reader
FlaggedRead Telegram channels and groups for financial news and market research with the tdl CLI: list chats and channels, find a channel by name, and export recent messages or a date or ID range. Use this skill whenever the user wants to check their Telegram, see what's new in their channels, read or export messages from a news, crypto, or trading channel or group, or gather market news and signals posted on Telegram. Read-only: it cannot send messages or join or leave channels.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.9 KB |
| SKILL.md | skill md | 7.7 KB |
| references/commands.md | markdown | 4.5 KB |
README.md
View on GitHub# telegram-reader
Read-only Telegram skill for financial news and market research using [tdl](https://github.com/iyear/tdl).
## What it does
Reads Telegram channels and groups for financial news — exporting messages, listing channels, and monitoring financial news feeds. Capabilities include:
- **List chats** — view all your Telegram channels, groups, and contacts with filtering
- **Export messages** — read recent messages from any channel or group you've joined
- **Time-range queries** — fetch messages from specific time periods
- **Channel search** — find channels by name or type
**This skill is read-only.** It does NOT support sending messages, joining/leaving channels, or any write operations.
## Authentication
Requires a one-time interactive login via QR code or phone number. After login, the session persists on disk — no further authentication needed.
## Triggers
- "check my Telegram", "read Telegram channel", "Telegram news"
- "what's new in my Telegram channels", "export messages from"
- "financial news on Telegram", "crypto Telegram", "market news Telegram"
- Any mention of Telegram in context of financial news or market research
## Platform
Works on **Claude Code** and other CLI-based agents. Does **not** work on Claude.ai — the sandbox restricts network access and binaries required by tdl.
## Setup
```bash
# Choose finance-social-readers when prompted.
npx plugins add himself65/finance-skills
# Or install just this skill
npx skills add himself65/finance-skills --skill telegram-reader
```
See the [main README](../../../../README.md) for more installation options.
## Prerequisites
- [tdl](https://github.com/iyear/tdl) installed (`brew install telegram-downloader` on macOS)
- One-time login: `tdl login -T qr` (scan QR code with Telegram mobile app)
## Reference files
- `references/commands.md` — Complete tdl command reference for reading channels and exporting messages
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |