telegram_bot

This is a personalized telegram bot with the following commands available to users:

• /scan: Performs a port scan on the specified address passed as a parameter
  • For example: /scan <target ip address>
• /arp: Performs a network scan for all the devices connected to the script hosts network
• /prev: Calls the previously received command
• /reg: Registers the user as an admin only if a valid key is passed as a parameter
• /help: Returns a list of available commands with descriptions
• /img: Returns a random image result from the search
• /clear: Clears any cache arrays present (admin-only)
• /log: Returns the debugging log file (admin-only - personal information still saved in this version of the bot)
• /live: Returns a random result from the specified live leak search
• /mybb: Returns the specified number (default 5) of the latest articles from the MyBroadband website
• /logs: Returns the backed-up log files (admin-only)
• /clear_logs: Deletes the backed up log files (admin-only)
• /stats: Returns the current cpu and memory use statistics of the host (admin-only)

Temporarily disabled commands:

• /trace: Runs a traceroute to the specified website/address (admin-only)
• /monitor: Sniffs the packets on the host machine running the script. Packet count to return is an optional parameter
  • For example: /monitor <number>

Commands on the road-map:

• /dns: Performs a DNS lookup on the provided hostname

The bot was designed to keep running through most exceptions during runtime (apart from missing database or networking errors)

Example usage (commandline):

Requirements

• An already set-up instance of MySQL needs to be running for this bot to work
  • Database name, user login details, host and port can be specified in the config.json file.

Steps

1. Modify the template_config.json to suit your setup and rename to config.json

2. Install the required packages: pip install -r requirements.txt --upgrade

3. Run the following in console / terminal: python test_bot.py

4. Then in telegram open the chat link: telegram_bot

Example usage in code

from telegram_bot import run


if __name__ == "__main__":
    run()