/ip-hacker

Discord bot to analyze and fetch as much data as possible from ip addresses

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

ip-hacker

Overview

ip-hacker is an advanced OSINT tool tailored for Discord, enabling cyber investigators, security researchers, and enthusiasts to gather in-depth data on target IP addresses. By integrating a broad spectrum of utilities into one platform, this bot provides real-time insights into an IP's geolocation, associated services, potential security threats, and more. Its foundation lies in its ability to seamlessly interact with the user, combining convenience and data-driven decision-making into one unified experience. Provide data from many sources and even provides links to possible open ports to help further your investigation.

Table of Contents

  1. Installation
  2. Requirements
  3. Configuration
  4. Usage & Features
  5. Benefits of Team-Based OSINT

Installation

Clone the Repository:

git clone https://github.com/RocketGod-git/ip-hacker.git
cd ip-hacker

Requirements

Python Dependencies

Windows:

pip install -r requirements.txt

Linux:

pip3 install -r requirements.txt

External Dependencies

  1. Nmap:

    Nmap (Network Mapper) is an indispensable tool for port scanning. It determines what services an IP address is running, providing insights into potential vulnerabilities.

    Installation:

    Debian/Ubuntu:

    sudo apt-get install nmap

    Windows:

    Make sure Nmap is in your PATH:

    After installing, ensure Nmap is accessible from the command line by adding it to your system's PATH.

    Check out Nmap's GitHub repository for more details and potential contributions.

Configuration

Update config.json:

{
    "TOKEN": "YOUR DISCORD BOT TOKEN HERE",
    "SHODAN_KEY": "YOUR SHODAN API KEY HERE",
    "VIRUSTOTAL_API_KEY": "YOUR VIRUSTOTAL API KEY HERE"
}

API Key Instructions:

  1. Shodan:

    • Visit Shodan's website.
    • Create an account or log in.
    • Once logged in, navigate to 'My Account' on the top right.
    • Here, you'll find your API Key. Use this key for the "SHODAN_KEY" in the config.json.

  2. VirusTotal:

    • Visit VirusTotal's website.
    • Register or sign in.
    • Navigate to the API section from the profile menu.
    • Here, you will find your public API Key. Use this key for the "VIRUSTOTAL_API_KEY" in the config.json.

Usage & Features

Running the Tool:

Windows:

python main.py

Linux:

python3 main.py

Features:

  1. Clickable Links: When the bot identifies open ports, it provides clickable links for quick access to the related services.
  2. Comprehensive Data Extraction:
    • Geolocation: Determine an IP's geographical origin.
    • Tor Exit Node Check: Identify if an IP is a known TOR exit node.
    • Whois Data: Acquire domain or IP related metadata.
    • Nmap Scans: Port scans, mainly for ports 20-80, with additional scans for specific services like IP cameras, game servers, and others.
    • Shodan & VirusTotal Integration: Extract device details, vulnerabilities, and extensive security reports related to the IP.

Benefits of Team-Based OSINT

Utilizing ip-hacker in a team setting on Discord offers:

  1. Real-time Sharing: Share data instantly.
  2. Collaborative Analysis: Multiple perspectives offer deeper insights.
  3. Unified Data: Keep all gathered intel in one place.
  4. Efficient Task Distribution: Assign specific investigation areas.
  5. Learning & Mentorship: Real-time learning and guidance for members.

Integrate the strengths of collaborative OSINT operations with the data extraction capabilities of ip-hacker for an enhanced investigatory experience.

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

License

LICENSE

rocketgod_logo