A comprehensive Discord bot designed for Open Source Intelligence (OSINT) gathering and analysis. This professional-grade bot provides investigators, researchers, and security professionals with a complete suite of intelligence gathering tools directly from Discord.
- Domain & Network Analysis: DNS lookups, WHOIS history, subdomain enumeration, and web technology detection
- Identity Investigation: Multi-platform username searches, profile enumeration, and social media reconnaissance
- Image Intelligence: EXIF metadata extraction with GPS coordinate mapping and facial recognition
- Blockchain Analysis: Cryptocurrency address investigation, transaction analysis, and address detection
- Transportation Intelligence: Aviation tracking, airport data, flight information, and maritime vessel tracking
- Business Intelligence: Company information gathering, corporate data analysis, and registry searches
- AI-Powered Analysis: Multi-model AI integration for data interpretation and report generation
- Document Processing: JWT token analysis, document metadata extraction, and file analysis
- Network Reconnaissance: Vulnerability scanning, port analysis, and security assessment
- Link Analysis: URL investigation, redirect chain analysis, and favicon reconnaissance
- Geospatial Intelligence: GPS coordinate analysis, location mapping, and geographic correlation
- Social Engineering Tools: Username generation, profile discovery, and account enumeration
- Search Intelligence: Google dorking assistance, advanced search query generation
- Monitoring Capabilities: Target monitoring, real-time alerts, and continuous surveillance
- Data Extraction: Link extraction, pattern recognition, and automated data parsing
Command | Description | Features |
---|---|---|
/bob-dns |
Comprehensive DNS analysis | Records analysis, security detection, nameserver info |
/bob-whoxy |
WHOIS history and reverse lookups | Historical data, registrant tracking, change analysis |
/bob-hostio |
Domain hosting intelligence | Infrastructure analysis, hosting details, technology stack |
/bob-recon-web |
Web reconnaissance | Technology detection, service enumeration, security headers |
/bob-redirect-chain |
URL redirect analysis | Redirect tracking, destination analysis, security assessment |
/bob-favicons |
Website favicon analysis | Icon extraction, hash analysis, brand identification |
Command | Description | Features |
---|---|---|
/bob-nuclei |
Username investigation | Most reliable tool, no false/positive |
/bob-sherlock |
Multi-platform username search | 400+ platforms, real-time tracking, results export |
/bob-maigret |
Enhanced username investigation | Advanced reconnaissance, deep profile analysis |
/bob-linkook |
Username investigation | Discover linked social accounts |
/bob-generate-usernames |
Username variation generation | Pattern creation, format variations, enumeration lists |
/bob-ghunt |
Google account investigation | Gmail analysis, profile discovery, account correlation |
Command | Description | Features |
---|---|---|
/bob-exif |
Image metadata extraction | GPS coordinates, camera data, privacy mode, map integration |
/bob-rekognition |
AWS facial recognition | Face detection, celebrity recognition, demographic analysis |
Command | Description | Features |
---|---|---|
/bob-blockchain |
Cryptocurrency address analysis | Multi-network support, transaction history, risk assessment |
/bob-blockchain-detect |
Crypto address detection | Format identification, confidence scoring, explorer links |
Command | Description | Features |
---|---|---|
/bob-aviation |
Aviation intelligence | Flight tracking, aircraft data, airline operations |
/bob-airport |
Airport information lookup | Facility data, runway information, operational status |
/bob-flight-number |
Specific flight tracking | Real-time status, route analysis, delay information |
/bob-vessels |
Maritime vessel tracking | Ship information, location tracking, maritime intelligence |
Command | Description | Features |
---|---|---|
/bob-pappers |
Business registry | Company information, corporate structure, legal status |
/bob-nike |
Look up email address or a name | On Nike Run Club (NRC) fitness app |
/bob-vpic |
Vehicle identification by VIN | Car details, manufacturer data, specification lookup |
Command | Description | Features |
---|---|---|
/bob-chat |
AI-powered analysis assistant | Multi-model support, OSINT analysis, code generation |
/bob-jwt |
JWT token analysis | Token decoding, security analysis, payload extraction |
/bob-xeuledoc |
Document analysis | Metadata extraction, content analysis, file intelligence |
Command | Description | Features |
---|---|---|
/bob-extract-links |
URL extraction from text | Pattern matching, validation, bulk processing |
/bob-dork |
Google dorking assistance | Query generation, search optimization, target enumeration |
/bob-monitor |
Target monitoring setup | Continuous surveillance, alert configuration |
/bob-health |
System health monitoring | Bot status, API connectivity, performance metrics |
- Node.js v16.9.0 or higher
- Discord Bot Token
- External Tools: ExifTool, Sherlock, Maigret, Nuclei (optional)
- API Keys: Various services for full functionality (see Configuration)
# Clone repository
git clone https://github.com/gl0bal01/discord-osint-assistant.git
cd discord-osint-assistant
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your tokens and API keys
# Deploy commands
npm run deploy
# Start bot
npm start
# Discord Configuration (Required)
DISCORD_TOKEN=your_discord_bot_token
CLIENT_ID=your_application_client_id
GUILD_ID=your_development_server_id
# Notification Channel for Monitored Websites
MONITOR_CHANNEL_ID=your_monitor_notification_discord_channel_id
# Core API Keys (Recommended)
WHOXY_API_KEY=your_whoxy_api_key
DNSDUMPSTER_TOKEN=your_dnsdumpster_token
HOSTIO_API_KEY=your_hostio_api_key
AVIATIONSTACK_API_KEY=your_aviationstack_api_key
AIRPORTDB_API_KEY=your_airportdb_api_key
# Advanced Features (Optional)
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
AWS_REGION=us-east-1
PAPPERS_API_KEY=your_pappers_api_key
# 1MIN AI
AI_API_KEY=your_ai_api_key
# Tool Paths (Optional - if not in PATH)
EXIFTOOL_PATH=exiftool
SHERLOCK_PATH=sherlock
NUCLEI_PATH=nuclei
NUCLEI_TEMPLATE_PATH=/username/nuclei-templates/http/osint/user-enumeration
MAIGRET_PATH=maigret
- ExifTool: Image metadata extraction with GPS mapping
- Sherlock: Username investigation across 400+ platforms
- Maigret: Enhanced username reconnaissance
- Nuclei: Most reliable username search
/bob-dns domain:example.com
/bob-whoxy type:domain domain:example.com
/bob-hostio domain:example.com
/bob-sherlock username:target_user
/bob-generate-usernames firstname:John lastname:Doe
/bob-ghunt email:[email protected]
/bob-exif image_url:https://example.com/image.jpg privacy:true
/bob-rekognition image_url:https://example.com/photo.jpg
/bob-blockchain address btc 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
/bob-blockchain-detect text:"Check this address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
/bob-chat ask message:"Analyze this OSINT data" context:osint
/bob-chat code request:"Generate Python script for data parsing" language:python
discord-osint-assistant/
βββ README.md # Project documentation
βββ package.json # Dependencies and scripts
βββ index.js # Main bot entry point
βββ deploy-commands.js # Command deployment utility
βββ .env.example # Environment template
βββ
βββ commands/ # Complete command suite
β βββ dns.js # DNS analysis and reconnaissance
β βββ whoxy.js # WHOIS history and reverse lookup
β βββ nuclei.js # Most reliable username search
β βββ exif.js # Image metadata with GPS mapping
β βββ blockchain.js # Cryptocurrency investigation
β |ββ chat.js # AI-powered analysis assistant
β βββ hostio.js # Domain hosting intelligence
β βββ recon-web.js # Web reconnaissance
β βββ redirect-chain.js # URL redirect analysis
β βββ favicons.js # Website favicon analysis
β βββ aviation.js # Aviation intelligence
β βββ airport.js # Airport information
β βββ flight-number.js # Flight tracking
β βββ vessels.js # Maritime tracking
β βββ pappers.js # Business registry
β βββ nike.js # Product authentication
β βββ vpic.js # Vehicle identification
β βββ sherlock.js # Multi-platform username search
β βββ maigret.js # Enhanced username investigation
β βββ linkook.js # Discover linked/connected social accounts
β βββ ghunt.js # Google account investigation
β βββ extract-links.js # URL extraction
β βββ jwt.js # Token analysis
β βββ dork.js # Google dorking
β βββ xeuledoc.js # Document analysis
β βββ blockchain-detect.js # Crypto address detection
β βββ generate-usernames.js # Username generation
β βββ rekognition.js # AWS facial recognition
β βββ monitor.js # Target monitoring
β βββ health.js # System monitoring
β β
βββ utils/ # Utility functions
β βββ validation.js # Input validation and sanitization
β
βββ addons/ # Configuration files
β βββ GPS2MapUrl.config # ExifTool GPS mapping
β
βββ docs/ # Documentation
βββ INSTALLATION.md # Detailed setup guide
βββ [Additional guides] # Usage and configuration guides
- Input Validation: Comprehensive sanitization prevents injection attacks
- Privacy Modes: Sensitive data handling for investigations
- Rate Limiting: API quota management and abuse prevention
- Audit Logging: Complete activity tracking for accountability
- Error Handling: Secure error responses prevent information disclosure
- Configurable privacy modes for sensitive operations
- Automatic cleanup of temporary files
- Secure API key management
- GDPR-compliant data handling practices
- Minimum: 2GB RAM, Node.js 16.9.0+, 1GB storage
- Recommended: 4GB+ RAM, SSD storage, stable internet
- Production: Load balancing, monitoring, log rotation
- Asynchronous processing for concurrent operations
- Intelligent timeout handling for long-running tasks
- Memory-efficient file processing
- Optimized API request patterns
# Development mode with auto-restart
npm run dev
# Linting
npm run lint
# Cleanup temporary files
npm run clean
- Create command file in
/commands/
directory - Follow established patterns and documentation standards
- Include comprehensive error handling and validation
- Add JSDoc documentation
- Update README and related documentation
This tool is designed for legitimate OSINT research, security testing, and educational purposes. Users must:
- Comply with applicable laws and regulations
- Respect platform terms of service
- Obtain proper authorization for investigations
- Use responsibly and ethically
The authors are not responsible for misuse of this software. Users bear full responsibility for ensuring legal compliance in their jurisdiction.
- Complete Setup Guide: docs/INSTALLATION.md
- Command Reference: Individual command help available via Discord
- Configuration Guide: Environment setup and API integration
Use /bob-health detailed:true check-apis:true check-tools:true
to verify:
- System status and performance
- API connectivity and quotas
- External tool availability
- Configuration validation
- GitHub Issues: Bug reports and feature requests
- Documentation: Comprehensive guides and examples
- Discord Support: Community assistance and updates
Current Version: 2.0.0
Author: gl0bal01
License: MIT
Node.js: >=16.9.0 required
- Comprehensive OSINT commands
- Multi-AI model integration
- Advanced blockchain analysis
- Enhanced privacy controls
- Professional documentation
- Production-ready architecture
Discord OSINT Assistant - Professional intelligence gathering made accessible through Discord.
Empowering investigators, researchers, and security professionals with comprehensive OSINT capabilities.
π Made with β€οΈ for the Osint community