{"id":24224798,"url":"https://github.com/geniuszly/genmcshodan","last_synced_at":"2025-07-08T13:05:43.290Z","repository":{"id":252599153,"uuid":"840907307","full_name":"geniuszly/GenMCShodan","owner":"geniuszly","description":"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). ","archived":false,"fork":false,"pushed_at":"2024-08-11T13:58:58.000Z","size":16,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-30T10:15:20.218Z","etag":null,"topics":["automation","cybersecurity","ethical-hacking","genmcshodan","information-gathering","iot-security","minecraft","minecraft-scanner","minecraft-shodan","network-security","penetration-testing","python","server-scanning","shodan"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geniuszly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-11T03:56:26.000Z","updated_at":"2024-10-16T15:52:31.000Z","dependencies_parsed_at":"2025-01-29T04:51:22.345Z","dependency_job_id":"6f12ae24-bb6a-445b-b05e-75842b4d103f","html_url":"https://github.com/geniuszly/GenMCShodan","commit_stats":null,"previous_names":["geniuszlyy/genmcshodan","geniuszly/genmcshodan"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/geniuszly/GenMCShodan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geniuszly%2FGenMCShodan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geniuszly%2FGenMCShodan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geniuszly%2FGenMCShodan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geniuszly%2FGenMCShodan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geniuszly","download_url":"https://codeload.github.com/geniuszly/GenMCShodan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geniuszly%2FGenMCShodan/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264275852,"owners_count":23583327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cybersecurity","ethical-hacking","genmcshodan","information-gathering","iot-security","minecraft","minecraft-scanner","minecraft-shodan","network-security","penetration-testing","python","server-scanning","shodan"],"created_at":"2025-01-14T07:26:46.458Z","updated_at":"2025-07-08T13:05:43.270Z","avatar_url":"https://github.com/geniuszly.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GenMCShodan\nis a Python utility for scanning and gathering information about Minecraft servers using the Shodan API, providing insights into server status, player counts, and configurations.\n\n# EN\n**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.\n\n## Features\n- **Shodan API Integration**: Leverages Shodan's vast database to find Minecraft servers.\n- **Minecraft Server Status**: Retrieves server status including player count, server version, and MOTD.\n- **Colorful CLI Output**: Uses colorama for a visually appealing command-line interface.\n- **Result Logging**: Saves scan results to a specified file for further analysis.\n\n## Prerequisites\n- **Python 3.x**: Make sure Python is installed on your system.\n- **Shodan API Key**: You need a valid Shodan API key to use this tool.\n\n## Installation\n1. Clone the repository:\n```bash\ngit clone https://github.com/geniuszlyy/GenMCShodan.git\n```\n2. Navigate to the project directory:\n```bash\ncd GenMCShodan\n```\n3. Install the required Python packages:\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n1. **Setup API Key**: Create a `config.json` file in the root directory with your Shodan API key.\n```bash\n{\n    \"SHODAN_API_KEY\": \"your_api_key_here\"\n}\n```\n2. **Run the Tool**:\n```bash\npython GenMCShodan.py [PORT] [RESULT_FILE_PATH] [SEARCH_QUERY]\n```\n- **PORT**: The port to scan (e.g., 25565 for Minecraft).\n- **RESULT_FILE_PATH**: Path to save the scan results.\n- **SEARCH_QUERY**: The Shodan search query to find servers.\n\n![image](https://github.com/user-attachments/assets/304cbd9e-c3c0-4b7f-b8a0-9cfcdb0b7421)\n\n\n## Example\n```bash\npython GenMCShodan.py 25565 results.txt \"Minecraft\"\n```\n![image](https://github.com/user-attachments/assets/c6247038-87ec-433b-bd99-70c2fa9f3cd2)\n\n![image](https://github.com/user-attachments/assets/331b4e7c-b87e-4752-8509-d4fff61cb024)\n\n\n\n# RU\n**GenMCShodan** — это инструмент на Python, предназначенный для сканирования и получения информации о серверах Minecraft с использованием API Shodan. Этот инструмент особенно полезен для сетевых администраторов и энтузиастов безопасности, интересующихся анализом инфраструктуры серверов Minecraft.\n\n## Особенности\n- **Интеграция с Shodan API**: Использует обширную базу данных Shodan для поиска серверов Minecraft.\n- **Статус сервера Minecraft**: Получает статус сервера, включая количество игроков, версию сервера и MOTD.\n- **Красочный CLI вывод**: Использует colorama для визуально привлекательного интерфейса командной строки.\n- **Логирование результатов**: Сохраняет результаты сканирования в указанный файл для дальнейшего анализа.\n\n## Требования\n- **Python 3.x**: Убедитесь, что Python установлен на вашем компьютере.\n- **Shodan API ключ**: Вам нужен действующий API ключ Shodan для использования этого инструмента.\n\n## Установка\n1. Клонируйте репозиторий:\n```bash\ngit clone https://github.com/geniuszlyy/GenMCShodan.git\n```\n2. Перейдите в директорию проекта:\n```bash\ncd GenMCShodan\n```\n3. Установите необходимые пакеты Python:\n```bash\npip install -r requirements.txt\n```\n\n## Использование\n1. **Настройка API ключа**: Создайте файл `config.json` в корневой директории с вашим API ключом Shodan.\n```bash\n{\n    \"SHODAN_API_KEY\": \"your_api_key_here\"\n}\n```\n2. **Запуск инструмента**:\n```bash\npython GenMCShodan.py [PORT] [RESULT_FILE_PATH] [SEARCH_QUERY]\n```\n- **PORT**: Порт для сканирования (например, 25565 для Minecraft).\n- **RESULT_FILE_PATH**: Путь для сохранения результатов сканирования.\n- **SEARCH_QUERY**: Поисковый запрос для Shodan.\n\n![image](https://github.com/user-attachments/assets/304cbd9e-c3c0-4b7f-b8a0-9cfcdb0b7421)\n\n## Пример\n```bash\npython GenMCShodan.py 25565 results.txt \"Minecraft\"\n```\n![image](https://github.com/user-attachments/assets/c6247038-87ec-433b-bd99-70c2fa9f3cd2)\n\n![image](https://github.com/user-attachments/assets/331b4e7c-b87e-4752-8509-d4fff61cb024)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeniuszly%2Fgenmcshodan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeniuszly%2Fgenmcshodan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeniuszly%2Fgenmcshodan/lists"}