Leak Searcher Bot

Leak Searcher is a powerful Telegram bot engineered to seamlessly interact with Elasticsearch for the purpose of searching, retrieving, and managing large datasets of leaked information. This utility excels in providing robust querying capabilities and is designed to ensure that only authorized users can access its functionality, enhancing data security and management efficiency.

Key Features

• Authorization: Ensures that only authorized users can utilize the bot's features, enhancing security.
• Multi-Index Search: Perform searches across all Elasticsearch indices using the * wildcard.
• Scroll API Integration: Efficiently handles large datasets with Elasticsearch’s Scroll API, allowing for seamless navigation through extensive data.
• Result Export: Automatically saves matched search results to a .txt file and delivers them to users via Telegram for easy access and sharing.
• Command Help: Offers a comprehensive list of available commands, enhancing user experience and accessibility.

Available Commands

• /start: Initialize the bot and receive a welcome message.
• /authorize: Authorize a user for accessing the bot functionalities.
• /listleaks: Display all available Elasticsearch indices (authorization required).
• /search: Execute a keyword search across indices and retrieve results (authorization required).
• /help: Show all available commands along with descriptions for guidance.

How It Works

When a user interacts with the bot, they first authorize themselves using the /authorize command. Once authorized, users can perform searches using the /search command, where the bot retrieves relevant data from Elasticsearch indices and presents it in a user-friendly format.

System Requirements

• Python 3.8 or higher
• Elasticsearch
• Telegram Botfather API Token

Project Structure

.
├── bot.py               # Main script for the Telegram bot
├── elastic_manager.py   # Script for managing Elasticsearch operations
├── requirements.txt     # Python dependencies
├── README.md            # Project documentation

This repository offers a command-line interface to manage indexing and retrieval operations in Elasticsearch through easily manageable Telegram commands, making it an essential tool for data handling in environments where data leaks need strict monitoring. Contributions to improve functionality and features of the bot are welcomed, encouraging collaboration and enhancement of this utility.