/GenMCShodan

is a Python tool designed to search for Minecraft servers using the Shodan API. It retrieves information about servers such as their IP addresses, ports, player count, and message of the day (MOTD).

Primary LanguagePythonMIT LicenseMIT

GenMCShodan

is a Python utility for scanning and gathering information about Minecraft servers using the Shodan API, providing insights into server status, player counts, and configurations.

EN

GenMCShodan is a Python-based tool designed to scan and retrieve information about Minecraft servers using the Shodan API. This tool is particularly useful for network administrators and security enthusiasts interested in analyzing Minecraft server infrastructure.

Features

  • Shodan API Integration: Leverages Shodan's vast database to find Minecraft servers.
  • Minecraft Server Status: Retrieves server status including player count, server version, and MOTD.
  • Colorful CLI Output: Uses colorama for a visually appealing command-line interface.
  • Result Logging: Saves scan results to a specified file for further analysis.

Prerequisites

  • Python 3.x: Make sure Python is installed on your system.
  • Shodan API Key: You need a valid Shodan API key to use this tool.

Installation

  1. Clone the repository:
git clone https://github.com/geniuszlyy/GenMCShodan.git
  1. Navigate to the project directory:
cd GenMCShodan
  1. Install the required Python packages:
pip install -r requirements.txt

Usage

  1. Setup API Key: Create a config.json file in the root directory with your Shodan API key.
{
    "SHODAN_API_KEY": "your_api_key_here"
}
  1. Run the Tool:
python GenMCShodan.py [PORT] [RESULT_FILE_PATH] [SEARCH_QUERY]
  • PORT: The port to scan (e.g., 25565 for Minecraft).
  • RESULT_FILE_PATH: Path to save the scan results.
  • SEARCH_QUERY: The Shodan search query to find servers.

image

Example

python GenMCShodan.py 25565 results.txt "Minecraft"

image

image

RU

GenMCShodan — это инструмент на Python, предназначенный для сканирования и получения информации о серверах Minecraft с использованием API Shodan. Этот инструмент особенно полезен для сетевых администраторов и энтузиастов безопасности, интересующихся анализом инфраструктуры серверов Minecraft.

Особенности

  • Интеграция с Shodan API: Использует обширную базу данных Shodan для поиска серверов Minecraft.
  • Статус сервера Minecraft: Получает статус сервера, включая количество игроков, версию сервера и MOTD.
  • Красочный CLI вывод: Использует colorama для визуально привлекательного интерфейса командной строки.
  • Логирование результатов: Сохраняет результаты сканирования в указанный файл для дальнейшего анализа.

Требования

  • Python 3.x: Убедитесь, что Python установлен на вашем компьютере.
  • Shodan API ключ: Вам нужен действующий API ключ Shodan для использования этого инструмента.

Установка

  1. Клонируйте репозиторий:
git clone https://github.com/geniuszlyy/GenMCShodan.git
  1. Перейдите в директорию проекта:
cd GenMCShodan
  1. Установите необходимые пакеты Python:
pip install -r requirements.txt

Использование

  1. Настройка API ключа: Создайте файл config.json в корневой директории с вашим API ключом Shodan.
{
    "SHODAN_API_KEY": "your_api_key_here"
}
  1. Запуск инструмента:
python GenMCShodan.py [PORT] [RESULT_FILE_PATH] [SEARCH_QUERY]
  • PORT: Порт для сканирования (например, 25565 для Minecraft).
  • RESULT_FILE_PATH: Путь для сохранения результатов сканирования.
  • SEARCH_QUERY: Поисковый запрос для Shodan.

image

Пример

python GenMCShodan.py 25565 results.txt "Minecraft"

image

image