How amay-xd/reconmind works
ReconMind is an OSINT investigation tool for IPs, emails, domains, and usernames. Its principal workflow accepts a target, classifies it, gathers applicable intelligence from multiple sources, and produces an AI-authored threat report. Users can access a web dashboard and a REST API; the repository also includes a CLI workflow with terminal, JSON, and PDF output. The graph separates collection, analysis, and reporting. README documentation describes the dashboard and API, but the sampled frontend source did not establish its runtime connection to the backend, so that link is left out.
Main entry points: main.py CLI Scanner · app.py Flask Scan API · shodan_collector.py Shodan Collector · hibp_collector.py HIBP Collector
Components 21
User Interfaces
- Web Dashboard
Frontend/script.js - CLI Scanner
main.py
Scan Orchestration
- Flask Scan API
Backend/app.py
Intelligence Collection
- Shodan Collector
collectors/shodan_collector.py - HIBP Collector
collectors/hibp_collector.py - WHOIS Collector
collectors/whois_collector.py - GitHub Collector
collectors/github_collector.py - Google Dorks
collectors/google_collector.py - Social Scanner
collectors/social_scan_collectors.py
Analysis and Reporting
- Groq AI Analysis
ai_engine/groq_analysis.py - PDF Export
output/pdf_export.py - Terminal Report
output/terminal_report.py
Configuration
- API Key Config
config.py
Other components
- Investigator
- Shodan API
- HIBP API
- WHOIS Service
- GitHub API
- Google Search
- Social Platforms
- Groq API
Connections 31
- Investigator → Web Dashboard: enters target
README.md - Investigator → Flask Scan API: submits scan
README.md - Investigator → CLI Scanner: runs scan
main.py - Flask Scan API → Shodan Collector: routes target
Backend/app.py - Flask Scan API → HIBP Collector: routes target
Backend/app.py - Flask Scan API → WHOIS Collector: routes target
Backend/app.py - Flask Scan API → GitHub Collector: routes target
Backend/app.py - Flask Scan API → Google Dorks: routes target
Backend/app.py - Flask Scan API → Social Scanner: routes target
Backend/app.py - Flask Scan API → Groq AI Analysis: analyzes scan
Backend/app.py - Flask Scan API → PDF Export: exports report
Backend/app.py - CLI Scanner → Shodan Collector: collects data
main.py - CLI Scanner → HIBP Collector: collects data
main.py - CLI Scanner → WHOIS Collector: collects data
main.py - CLI Scanner → GitHub Collector: collects data
main.py - CLI Scanner → Google Dorks: collects data
main.py - CLI Scanner → Social Scanner: collects data
main.py - CLI Scanner → Groq AI Analysis: analyzes scan
main.py - CLI Scanner → Terminal Report: renders report
main.py - CLI Scanner → PDF Export: exports report
main.py - Shodan Collector → Shodan API: queries host
collectors/shodan_collector.py - HIBP Collector → HIBP API: checks breaches
collectors/hibp_collector.py - WHOIS Collector → WHOIS Service: looks up domain
collectors/whois_collector.py - GitHub Collector → GitHub API: queries profile
collectors/github_collector.py - Google Dorks → Google Search: searches dorks
collectors/google_collector.py - Social Scanner → Social Platforms: checks profiles
collectors/social_scan_collectors.py - Groq AI Analysis → Groq API: analyzes findings
README.md - Groq AI Analysis → API Key Config: reads API key
ai_engine/groq_analysis.py - Shodan Collector → API Key Config: reads API key
collectors/shodan_collector.py - HIBP Collector → API Key Config: reads API key
collectors/hibp_collector.py - GitHub Collector → API Key Config: reads API token
collectors/github_collector.py