🚀 Meet Telelinker: A CLI Tool to Extract and Analyze Links from Telegram Groups

👋 Hey everyone!

I recently built Telelinker — an open-source command-line tool that helps you extract and analyze links shared in Telegram groups.

If you’ve ever wanted to know what people are sharing most often in your community — YouTube videos, TikToks, LinkedIn posts, Medium articles — Telelinker can help you find out in seconds.

💡 Why I built it

Telegram is full of interesting content. But if you manage or research multiple groups, tracking what gets shared can get messy.

I wanted a simple tool that could:

• Grab all links shared in a group
• Detect which platform they belong to (YouTube, TikTok, etc.)
• Collect useful metadata like username, likes, comments, views
• Export everything to CSV or PostgreSQL for analysis

So, I built Telelinker.

⚙️ What Telelinker does

Once you connect it to your Telegram account, Telelinker can:

✅ Extract links automatically from groups you’re a member of
✅ Detect platforms — YouTube, TikTok, Instagram, LinkedIn, Medium, Dev.to, and more
✅ Pull metadata (username, views, likes, comments, date, title…)
✅ Export results to CSV, JSON, or PostgreSQL
✅ Run interactively or headless
✅ Process multiple groups at once

Perfect for:

• 📊 Content trend analysis
• 🧠 Social research
• 🧰 Community management
• 🧮 Data mining and social media analytics

🧩 Installation

You can install Telelinker in a few ways.

Option 1 — Scoop (Windows)

scoop bucket add telelinker https://github.com/nkmelndz/telelinker
scoop install telelinker

Option 2 — Docker

git clone https://github.com/nkmelndz/telelinker.git
cd telelinker
docker build -t telelinker .
docker run --rm -it -v "$(pwd)":/app telelinker

Option 3 — From Source (Python 3.11+)

git clone https://github.com/nkmelndz/telelinker.git
cd telelinker
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
python -m src.main setup

🎮 How to use Telelinker

1️⃣ Configure your Telegram API credentials

You’ll need an API ID and HASH from my.telegram.org.
Once you have them, run:

telelinker setup
telelinker login

2️⃣ List your Telegram groups

telelinker groups --interactive

or export them:

telelinker groups --format csv --out my_groups.csv

3️⃣ Extract and analyze links

telelinker fetch --interactive

You can filter by group, limit results, and choose export formats.
Example:

telelinker fetch --group @mygroup --limit 100 --format csv --out links.csv

📊 Example output

After running Telelinker, you’ll get a CSV or JSON file like this:

🧠 What you can do with the data

• Find trends: Which platforms are most shared in your groups
• Research topics: What kind of content spreads fastest
• Build dashboards: Combine Telelinker exports with tools like Grafana or Metabase
• Automate reports: Use cron jobs to fetch fresh data weekly

🤝 Want to contribute?

Telelinker is open source under the MIT License — everyone’s welcome to contribute!

You can help by:

• Adding scrapers for more platforms
• Improving metadata extraction
• Suggesting new features
• Writing docs or tutorials

Check out the CONTRIBUTING.md for details.

💬 Final thoughts

I built this tool to make Telegram data more accessible for analysis — and I’d love to see what others do with it.

If you find it useful, please ⭐ star the repo or share it withothers!
Feedback, ideas, and contributions are all super welcome 🙌

👉 GitHub: github.com/nkmelndz/telelinker