telegram-channel-scraper-mcp-server
v1.0.1
Published
MCP server for scraping public Telegram channels — messages, emails, leads, channel info. No login or API key required. Powered by Apify.
Maintainers
Readme
Telegram Channel Scraper MCP Server
An MCP (Model Context Protocol) server that lets Claude, Cursor, and any MCP-compatible AI scrape public Telegram channels — no Telegram account, no phone number, no API key required.
Powered by the khadinakbar/telegram-channel-scraper Apify actor.
Tools
| Tool | Description |
|------|-------------|
| telegram_scrape_messages | Scrape messages from one or more public channels |
| telegram_get_channel_info | Get subscriber count, title, verification status |
| telegram_discover_related_channels | Find related channels via forwarded message analysis |
| telegram_extract_leads | Extract email addresses and links for lead generation |
Prerequisites
- Free Apify account (no credit card required for free tier)
- Your Apify API token from console.apify.com/account/integrations
Installation
Option 1: Hosted MCP — Zero Setup (Recommended)
Use the Apify-hosted MCP endpoint — no install, no npm, just add this URL to your MCP client:
https://mcp.apify.com/?tools=actors,docs,get-actor-run,get-actor-run-list,khadinakbar/telegram-channel-scraperClaude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"telegram-scraper": {
"type": "http",
"url": "https://mcp.apify.com/?tools=actors,docs,get-actor-run,get-actor-run-list,khadinakbar/telegram-channel-scraper",
"headers": {
"Authorization": "Bearer YOUR_APIFY_TOKEN"
}
}
}
}Option 2: npm / npx (Local Install)
Add to your claude_desktop_config.json:
{
"mcpServers": {
"telegram-scraper": {
"command": "npx",
"args": ["-y", "telegram-channel-scraper-mcp-server"],
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor / VS Code / Other MCP Clients
{
"mcpServers": {
"telegram-scraper": {
"command": "npx",
"args": ["-y", "telegram-channel-scraper-mcp-server"],
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}Manual Installation
npm install -g telegram-channel-scraper-mcp-server
APIFY_TOKEN=your_token telegram-channel-scraper-mcpUsage Examples
Once connected, ask Claude naturally:
"Scrape the last 100 messages from @telegram"
"How many subscribers does @durov have?"
"Find email addresses in @somebusinesschannel"
"What channels are related to @cryptonews?"
"Extract leads from @marketingchannel and @salesdeals"Tool Reference
telegram_scrape_messages
Scrape messages from public Telegram channels.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| channels | string[] | required | Channel usernames without @ (e.g. ["telegram"]) |
| max_messages | number | 50 | Max messages per channel (1–1000) |
| include_media | boolean | false | Include media URLs |
| include_reactions | boolean | false | Include reaction counts |
| extract_emails | boolean | true | Extract email addresses from text |
| extract_links | boolean | true | Extract URLs from text |
| since_last_run | boolean | false | Incremental mode — only new messages |
| response_format | string | "markdown" | "markdown" or "json" |
telegram_get_channel_info
Get metadata for a channel.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| channel | string | required | Channel username without @ |
| response_format | string | "markdown" | "markdown" or "json" |
telegram_discover_related_channels
Find channels related to your seeds via forwarded message analysis.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| channels | string[] | required | Seed channels (max 5) |
| max_messages | number | 100 | Messages to scan per seed |
| response_format | string | "markdown" | "markdown" or "json" |
telegram_extract_leads
Extract emails and links for lead generation.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| channels | string[] | required | Channels to scan (max 10) |
| max_messages | number | 200 | Messages to scan per channel |
| response_format | string | "markdown" | "markdown" or "json" |
Pricing
Uses Apify's pay-per-event pricing through the underlying actor:
- Actor start: $0.003 per run
- Per message: $0.002 each
- Per channel info: $0.001 each
Scraping 100 messages costs approximately $0.20. Apify's free tier includes $5/month in credits.
Privacy & Legal
This MCP server only accesses public Telegram channels via their public web preview (t.me/s/channel). It does not access private channels, DMs, or require any Telegram credentials.
More Scrapers by Khadin
| Tool | Description | |------|-------------| | YouTube Channel Email Scraper | Extract contact emails from YouTube channels | | Google Maps Leads Scraper | Scrape B2B leads and contact info from Maps | | B2B Lead Finder | Find and enrich B2B leads by industry/location | | Meta Ad Library Scraper | Monitor competitor Facebook/Instagram ads | | Reddit Scraper | Scrape posts and comments from subreddits | | AI Brand Monitor | Track your brand mentions across AI search engines | | Instagram Hashtag Scraper | Scrape posts by hashtag | | LinkedIn Profile Email Scraper | Extract emails from LinkedIn profiles | | Google News Scraper | Scrape Google News results for any query | | Twitter/X Profile Scraper | Scrape Twitter profiles and follower lists |
License
MIT — see LICENSE
