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.

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-scraper

Claude 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-mcp

Usage 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

View all actors →

License

MIT — see LICENSE

telegram-channel-scraper-mcp

Quick Install