tg-mtproto-cli
by cyberash-dev
Browser & AutomationBrief
Read-only Telegram CLI via MTProto.
Description
What This Skill Does
Read-only Telegram CLI that uses the MTProto protocol directly, bypassing the Bot API. Lists chats, fetches message history, downloads media, and manages multiple authenticated sessions. Cannot send messages or modify any Telegram data.
Direct MTProto access avoids Bot API rate limits and works on any chat the user is a member of, not just bots.
When to Use It
- Pulling recent messages from a Telegram channel for archiving
- Downloading photos or videos from a group chat
- Searching message history across multiple accounts
- Monitoring a forum topic for new posts since a given date
- Extracting structured message data for scripts or pipelines
Example Workflow
User asks: Download all photos posted in @mychat in the last 50 messages
- 1
Run
tg messages @mychat -n 50 --jsonto fetch recent messages as JSON - 2
Pipe output through
jqto filter messages where.media.type == "photo"and extract.idvalues - 3
Loop over each message ID and run
tg download @mychat <id> --out ./photos - 4
Confirm download completion from exit codes and
--jsonoutput
All photos from the last 50 messages saved to ./photos directory
Requirements
- Telegram api_id and api_hash from my.telegram.org/apps
- tg-mtproto-cli installed globally via npm (`npm install -g tg-mtproto-cli`)
- Telegram phone number and OTP code for initial `tg auth` session setup
Installation
clawhub install cyberash-dev/tg-mtproto-cliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.