Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacyΒ© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
tgspyder β€” CLI tool for structured Telegram OSINT data collection. Scrapes members, messages, invite links, and user metadata from public/private groups, exporting to CSV for investigative workflows. | Kitploit
Tools/GitHubGitHub/darksight-analytics/tgspyder
OSINT (Open Source Intelligence)ReconnaissanceData ExfiltrationInformation GatheringThreat IntelligenceLearning & EducationCrawler
GitHubdarksight-analytics/tgspyder
Share

tgspyder

CLI tool for structured Telegram OSINT data collection. Scrapes members, messages, invite links, and user metadata from public/private groups, exporting to CSV for investigative workflows.

View Repository
343405711 months agoReviewed by Kitploit

πŸ•·οΈ TGSpyder

TGSpyder Banner

TGSpyder is an Open-Source Telegram OSINT CLI Tool by Darksight Analytics.

Features

  • Scrape members list from both public and private groups to CSV
  • Scrape chat messages from both public and private groups to CSV
  • Extract t.me invite links from chat history (public and private groups)
  • Look up a Telegram user by username or (limited) numeric ID
  • Identify sticker pack creator ID (inferred via sticker set ID) Credits to: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
  • Proxy support:
    • Save proxy (--set-proxy)
    • Remove proxy (--remove-proxy)
    • One-off proxy override (--proxy)

Requirements

  • Python 3.10+

Install

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

πŸ•·οΈ Introduction

Telegram OSINT CLI Tool Built for investigators, analysts, journalists, and researchers.

TGSpyder is a command-line OSINT tool for structured collection and analysis of Telegram data. It enables scraping of members, messages, invite links, users, and metadata from public and private Telegram groups and channels β€” exporting everything into investigator-friendly CSV files.

Features

  • πŸ“‹ Scrape member lists (where Telegram allows)
  • πŸ’¬ Crawl chat messages
  • πŸ”— Extract and de-duplicate Telegram invite links
  • 🧍 Lookup users by ID or username
  • 🎭 Identify sticker pack creators
  • 🌐 SOCKS proxy support (Tor / VPN)
  • πŸ“ Clean CSV output for OSINT workflows
  • πŸ“¦ Output Structure

All collected data is stored in a single runtime folder:

TGSpyder Output/
β”œβ”€β”€ members/
β”‚   └── members_<target>_<timestamp>.csv
β”œβ”€β”€ chats/
β”‚   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

πŸš€ Quick Start

1️⃣ Clone the repository

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ Create & activate a virtual environment

python3 -m venv venv
source venv/bin/activate

3️⃣ Install dependencies

pip install -r requirements.txt

4️⃣ Install TGSpyder as a CLI

pip install -e .

Verify installation:

tgspyder --help

πŸ”‘ Telegram API Credentials

  • Head over to https://my.telegram.org and log in with your Telegram account.
  • Navigate to API development tools to generate your API ID and API Hash, which are required to authenticate TGSpyder with Telegram.

🧭 Basic Usage

Scrape members and chats

tgspyder https://t.me/examplegroup --members --chats

Extract invite links only

tgspyder https://t.me/examplegroup --crawl-invites

User lookup

tgspyder --user 123456789
tgspyder --user @username

Sticker pack creator lookup

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 Proxy Support

TGSpyder supports SOCKS proxies (Tor / VPN-friendly).

One-off proxy

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

Save proxy for future runs

tgspyder --set-proxy socks5://127.0.0.1:9050

Remove saved proxy

tgspyder --remove-proxy

πŸ” Authentication & Config

On first run, TGSpyder will prompt for:

  • Telegram API ID
  • Telegram API Hash
  • User account or bot token

Credentials are stored locally in: ~/.tgspyder.conf

Session files are reused automatically.

⚠️ Limitations

  • Some groups do not expose member lists
  • Private groups require valid invite links
  • Sticker creator attribution is not always guaranteed
  • Subject to Telegram API limits

πŸ§ͺ Ethical Use & OSINT Disclaimer

TGSpyder is intended for:

  • OSINT investigations
  • Academic research
  • Journalism
  • Threat & network analysis

Users are responsible for compliance with:

  • Local laws
  • Platform terms of service
  • Ethical research standards

πŸ“„ License

MIT License See LICENSE for details.

πŸš€ Demo

TGSpyder Demo

πŸ‘€ Author

  • Valdemar Balle
  • Founder of Darksight Analytics

βš–οΈ Disclaimer

TGSpyder is provided for open-source intelligence (OSINT), research, investigative, and educational purposes only.

Users are solely responsible for ensuring that their use of this tool complies with:

  • Applicable laws and regulations
  • Platform terms of service
  • Ethical research and investigative standards

The author and contributors assume no liability for misuse of this tool or for any consequences arising from its use.

Download Tool

Most Popular

View all β†’

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    837
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    536
  • 3

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    424
  • 4

    redforge

    cybersecurity91/redforge

    Browser-side red team toolkit with 102 offline tools for recon, payload generation, credential attacks, crypto, encoding and engagement reporting.

    355
  • 5

    looking-glass

    anonghosty/looking-glass

    CSIRT platform that ingests Shadowserver reports into MongoDB and replays them as interactive maps, analysis, findings, advisories and executive dashboards.

    294
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    The system of action for AI-native cybersecurityβ€”where intent becomes governed execution, evidence becomes operational memory, and every operation improves the next.

    276

Explore all tools

Browse our collection of tools

View all tools β†’