NYXBAM/OsintRat
GitHub: NYXBAM/OsintRat
通过 Telegram 机器人界面提供基于 Meilisearch 的大规模数据搜索能力的技术演示项目,支持按姓名、电话、邮箱、Telegram ID 等字段进行超快速查询。
Stars: 1 | Forks: 1
# 📇 OsintRat 🐀 搜索机器人
一个简单的 Telegram 机器人,通过 **[Meilisearch](https://www.meilisearch.com/)** 驱动的大规模合成数据集(高达 **100M+ 条记录**)执行超快速搜索。
最初作为大数据索引和搜索优化的作品集实验而创建。
🔒 数据免责声明
本项目使用的所有记录均为合成生成。任何与真实人物的相似性,无论是健在还是已故,纯属巧合。数据集和机器人响应中不包含任何刻意真实的个人数据。
### 👉 [在 Telegram 上试用机器人](https://t.me/FirstRatHobot)
## 🚀 功能
- 支持按 **姓名**、**电话号码**、**电子邮件**、**Telegram ID** 或 **Telegram 用户名** 进行搜索
- 采用 **Meilisearch** 实现闪电般的索引和查询
- 自动 **查询队列**:如果数据库离线,所有用户请求将被存储并在恢复在线后处理
- 基于 [aiogram2.25](https://docs.aiogram.dev/) 构建的简洁 **Telegram 机器人界面**
- 可选的 **管理面板和日志记录**
## 🧠 架构概览
用户 → Telegram 机器人 → Meilisearch API → JSON 数据集(约 1 亿条记录)
- **机器人** 负责处理请求、排队查询和格式化响应
- **Meilisearch** 作为独立服务运行(不包含在本仓库中)
- **SQLite** 用于本地队列和元数据存储
## ⚙️ 环境要求
- **Python** 3.10 或更高版本
- 运行中的 **Meilisearch** 实例(需单独配置)
## 🧩 安装步骤
克隆仓库并安装依赖:
```
git clone https://github.com/NYXBAM/OsintRat
cd OsintRat
pip install -r requirements.txt
```
🔑 环境变量
在项目根目录创建 .env 文件,参考以下示例:
```
BOT_TOKEN=8123
ADMIN_IDS=1,2,3
CLIENT_URL= # URL of your Meilisearch instance
ADMIN_USERNAME= # Telegram @username of the main admin
CHANNEL_USERNAME= # Telegram channel username
```
🏃 运行机器人
确保 Meilisearch 已启动并可通过 CLIENT_URL 访问,然后直接启动机器人:
```
python main.py
```
# ⚠️ 注意事项
实际数据集(约 200 GB)不包含在内。
请使用您自己的 JSON 数据并在 Meilisearch 中单独建立索引。
内存使用量根据记录复杂程度,大约每 100 万条文档占用 1 GB 内存。
本项目主要是一个用于测试 Meilisearch 规模化性能的技术演示。
标签:aiogram, Bot开发, Homebrew安装, Meilisearch, OSINT工具, Python, SQLite, Telegram机器人, 人物搜索, 大数据, 快速搜索, 搜索引擎, 数据检索, 数据索引, 无后门, 无线安全, 目录扫描, 联系方式查询, 逆向工具