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

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)