/MARe

MARe - Multi-Agent Recon Framework > 🔍 Dynamic Information Gathering Toolkit powered by modular recon agents and AI-assisted suggestions. Built for Termux, Linux, and modern offensive recon.

Primary LanguagePythonMIT LicenseMIT

🕵️‍♂️ MARe - Multi-Agent Recon Framework

🔍 Dynamic Information Gathering Toolkit powered by modular recon agents and AI-assisted suggestions. Built for Termux, Linux, and modern offensive recon.

✨ Features

  • 🔍 Google Dorking with rotating user-agents
  • 🌐 Subdomain Enumeration (passive and active)
  • 🛁 Port Scanning using sockets (Nmap-compatible)
  • 🕵️ OSINT Lookup (WHOIS, leaks, geo-IP, and more)
  • 🤖 AI Assistant (GPT-style recon tips & dork generation)
  • 🧠 Smart CLI + Interactive Menu — choose how you recon
  • 📁 Auto-logs everything by timestamp in data/<target>/
  • 💡 Designed for both root and non-root users (Termux-ready)

📆 Modules

Module Emoji Function
dork.py 🔍 Google/Searx scraping + user-agents
subdomains.py 🌐 Passive/active subdomain finder
ports.py 🛁 Socket scanner (top ports)
osint.py 🕵️ WHOIS, leaks, basic geo-IP info
ai_assist.py 🤖 GPT-based suggestions (offline/local)

🚀 Installation

If you're using Termux:

pkg update && pkg install git python curl wget -y
git clone https://github.com/GbeshMod/MARe.git
cd MARe
chmod +x install.sh
./install.sh

💼 Menu Mode (default)

python3 mare.py

🧠 Command-Line Mode

mare --target example.com --dork --subdomains
mare --target 1.1.1.1 --full

🚀 Features

  • ✅ Works in rootless environments (Termux, WSL, etc.)
  • 🐧 Linux (root or non-root)
  • 🐚 Termux (no root)
  • 🪟 WSL (Windows Subsystem for Linux)
  • ✅ Auto-installs dependencies where possible
  • ✅ Python-based modular framework
  • ✅ Adds mare as a global command
  • ✅ Supports shortcut creation and $PATH export
  • ✅ Built-in user agent rotation file
  • ✅ Optional post-i
  • ✅ Works on Linux, Termux, WSL, Kali, Parrot
  • ❌ No sudo required – fully user-space

🛠 Usage

🤝 Contributing

  • Suggest a module
  • Fork & pull requests welcome
  • Use responsibly – for educational and legal testing only

⚠️ Disclaimer

This tool is provided for educational and research purposes only. Use responsibly and only against systems you own or are authorized to test. nstall launch

🧼 Uninstall
rm -rf ~/.mare
rm ~/.local/bin/mare
# Optional: remove from your ~/.bashrc or ~/.zshrc if added
---

📁 Folder Structure
.mare/
├── mare.py            # Main tool
├── data/
│   ├── example.com/   # Default scan target dir
│   └── user_agents.txt

🖼️ Screenshot