Skip to content

himself65/finance-skills / plugins/social-readers/skills/telegram-reader

telegram-reader

Flagged

Read 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.

FileKindSize
README.mdmarkdown1.9 KB
SKILL.mdskill md7.7 KB
references/commands.mdmarkdown4.5 KB
# 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
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall