How do I install the Telegram Scrape skill?

Run npx skillmds@latest add aaaaqwq/telegram-scrape in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Telegram Scrape skill do?

Search Telegram channels, read posts, ad contacts It is listed under Coding & Dev Tools on SkillMD.

Is Telegram Scrape safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Telegram Scrape?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Telegram Scrape free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Telegram Scrape?

aAAaqwq (@aaaaqwq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Telegram Scrape by aaaaqwq — Agent Skill

Name: Telegram Scrape
Rating: 4.2 (5 reviews)
Author: aAAaqwq

File contents

Telegram Scrape

Search channels, read messages, analyze ad contacts

When to use

"find AI channels on telegram"
"show messages from a channel"
"find ad contacts of channels"
"where can I buy ads"
"scraping telegram channels"

Tool

$TG_TOOLS_PATH/tools/tg_scrape.py

How to run

Search channels by keywords

# Find channels with "ai" or "cursor" in the name
python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai,cursor"

# Save to CSV
python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --output channels.csv

# Save to JSON (more data: about, links)
python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --output channels.json

# With exclusions
python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --exclude "spam,nsfw"

Output: title, username, link, subscribers, ad_contacts, ad_links, about.

Read channel/group messages

# Last 20 messages
python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Channel Name" --limit 20

# From the last 7 days
python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Channel Name" --days 7

Channel Name -- search by substring (case-insensitive).

Search for ad contacts

python3 $TG_TOOLS_PATH/tools/tg_scrape.py ads --keywords "ai,cursor" --posts 10

Analyzes:

Channel description (looks for @username, t.me/ links, words "ad", "ads", "price")
Last N posts (keyword mentions)
Calculates relevance score

Output (JSON stdout): title, username, subscribers, score, ad_contacts, keyword_mentions, sample_posts.

Parameters

Command	Parameter	Description
`channels`	`--keywords, -k`	Keywords comma-separated
`channels`	`--exclude, -x`	Exclude (comma-separated)
`channels`	`--output, -o`	File (.csv or .json)
`messages`	`channel`	Channel/group name
`messages`	`--limit, -n`	Max messages (default: 20)
`messages`	`--days, -d`	Only from last N days
`ads`	`--keywords, -k`	Keywords (required)
`ads`	`--exclude, -x`	Exclude
`ads`	`--posts, -p`	Posts to analyze (default: 10)

Limitations

Searches only among channels you are subscribed to
GetFullChannelRequest has rate limits
0.2-0.3 sec delay between channels (automatic)

Related skills

telegram-groups -- group operations
telegram-send -- sending messages (e.g. to advertisers)

---name: telegram-scrapedescription: Search Telegram channels, read posts, ad contacts---# Telegram Scrape > Search channels, read messages, analyze ad contacts ## When to use - "find AI channels on telegram" - "show messages from a channel" - "find ad contacts of channels" - "where can I buy ads" - "scraping telegram channels" ## Tool `$TG_TOOLS_PATH/tools/tg_scrape.py` ## How to run ### Search channels by keywords ```bash # Find channels with "ai" or "cursor" in the name python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai,cursor" # Save to CSV python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --output channels.csv # Save to JSON (more data: about, links) python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --output channels.json # With exclusions python3 $TG_TOOLS_PATH/tools/tg_scrape.py channels --keywords "ai" --exclude "spam,nsfw" ``` Output: title, username, link, subscribers, ad_contacts, ad_links, about. ### Read channel/group messages ```bash # Last 20 messages python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Channel Name" --limit 20 # From the last 7 days python3 $TG_TOOLS_PATH/tools/tg_scrape.py messages "Channel Name" --days 7 ``` Channel Name -- search by substring (case-insensitive). ### Search for ad contacts ```bash python3 $TG_TOOLS_PATH/tools/tg_scrape.py ads --keywords "ai,cursor" --posts 10 ``` Analyzes: - Channel description (looks for @username, t.me/ links, words "ad", "ads", "price") - Last N posts (keyword mentions) - Calculates relevance score Output (JSON stdout): title, username, subscribers, score, ad_contacts, keyword_mentions, sample_posts. ## Parameters | Command | Parameter | Description | |---------|-----------|-------------| | `channels` | `--keywords, -k` | Keywords comma-separated | | `channels` | `--exclude, -x` | Exclude (comma-separated) | | `channels` | `--output, -o` | File (.csv or .json) | | `messages` | `channel` | Channel/group name | | `messages` | `--limit, -n` | Max messages (default: 20) | | `messages` | `--days, -d` | Only from last N days | | `ads` | `--keywords, -k` | Keywords (required) | | `ads` | `--exclude, -x` | Exclude | | `ads` | `--posts, -p` | Posts to analyze (default: 10) | ## Limitations - Searches only among channels you are subscribed to - GetFullChannelRequest has rate limits - 0.2-0.3 sec delay between channels (automatic) ## Related skills - `telegram-groups` -- group operations - `telegram-send` -- sending messages (e.g. to advertisers)

Frequently asked questions