Skip to content
Open Source·

CyberBot

Telegram bot with cybersecurity tools — ping, WHOIS, DNS lookup, port scanning, and an educational link-tracking feature.

PythonTelegram Bot APIMongoDBDockerFlask
Source code

CyberBot

A Telegram bot that bundles common cybersecurity reconnaissance tools into a chat interface. Send a command, get results in Telegram. Also includes an educational link-tracking feature for demonstrating phishing awareness.

Commands

Cybersecurity tools

  • /ping <host> — Ping an IP or domain
  • /whois <domain> — WHOIS lookup
  • /dns <domain> — DNS records
  • /headers <url> — HTTP response headers
  • /ipinfo <ip> — IP geolocation
  • /scanssl <domain> — SSL certificate check
  • /hash <text> — Hash calculation (MD5, SHA256)
  • /scanurl <url> — URL reputation scan
  • /subdomains <domain> — Subdomain enumeration
  • /portscan <ip> — Port scanning (use responsibly)

Admin features

  • Password-protected admin login (/adminlogin)
  • View registered users (/viewusers)
  • View generated link statistics (/viewlinks)

Educational link tracking

/generatelink creates a unique URL. When visited, the page collects browser fingerprint data (IP, device info) and reports it back to the link creator via Telegram. This exists to demonstrate how phishing links work — for educational use only.

Stack

  • Language: Python 3.10+
  • Bot framework: python-telegram-bot
  • Database: MongoDB Atlas
  • Web server: Integrated Flask server for link-tracking pages
  • Deployment: Docker container on Render

Running locally

git clone https://github.com/higgn/cyberobot.git
cd cybersecurity-telegram-bot
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
pip install -r requirements.txt
# Configure .env with BOT_TOKEN, MONGODB_URI, ADMIN_PASSWORD, ADMIN_CHAT_ID
python -m bot.bot

Bot starts polling Telegram, web server listens on port 8080.

← All projects