Skip to content

gl0bal01/discord-osint-assistant

Repository files navigation

Discord OSINT Assistant v2.0

MIT License Node.js Version Discord.js Version DOI

OSINT Security Intelligence Discord Bot Blockchain Analysis AI Powered

PRs Welcome

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.

🌟 Features Overview

Core OSINT Intelligence Capabilities

  • 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

Advanced Analysis Tools

  • 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

Specialized OSINT Features

  • 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

πŸ› οΈ Complete Command Reference

Domain & Network Intelligence

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

Identity & Social Intelligence

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

Image & Media Analysis

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

Blockchain & Cryptocurrency

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

Transportation & Aviation

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

Business & Corporate 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

AI & Analysis Tools

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

Utilities & Support

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

πŸš€ Quick Installation Guide

Prerequisites

  • 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)

Basic Setup

# 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

βš™οΈ Configuration

Required Environment Variables

# 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

External Tool Integration

  • ExifTool: Image metadata extraction with GPS mapping
  • Sherlock: Username investigation across 400+ platforms
  • Maigret: Enhanced username reconnaissance
  • Nuclei: Most reliable username search

πŸ“Š Usage Examples

Basic Domain Investigation

/bob-dns domain:example.com
/bob-whoxy type:domain domain:example.com
/bob-hostio domain:example.com

Identity Investigation

/bob-sherlock username:target_user
/bob-generate-usernames firstname:John lastname:Doe
/bob-ghunt email:[email protected]

Image Analysis

/bob-exif image_url:https://example.com/image.jpg privacy:true
/bob-rekognition image_url:https://example.com/photo.jpg

Blockchain Investigation

/bob-blockchain address btc 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
/bob-blockchain-detect text:"Check this address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

AI-Powered Analysis

/bob-chat ask message:"Analyze this OSINT data" context:osint
/bob-chat code request:"Generate Python script for data parsing" language:python

πŸ—οΈ Architecture

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

πŸ”’ Security & Privacy

Built-in Security Features

  • 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

Privacy Considerations

  • Configurable privacy modes for sensitive operations
  • Automatic cleanup of temporary files
  • Secure API key management
  • GDPR-compliant data handling practices

πŸ“ˆ Performance & Scalability

System Requirements

  • Minimum: 2GB RAM, Node.js 16.9.0+, 1GB storage
  • Recommended: 4GB+ RAM, SSD storage, stable internet
  • Production: Load balancing, monitoring, log rotation

Performance Features

  • Asynchronous processing for concurrent operations
  • Intelligent timeout handling for long-running tasks
  • Memory-efficient file processing
  • Optimized API request patterns

🀝 Contributing

Development Setup

# Development mode with auto-restart
npm run dev

# Linting
npm run lint

# Cleanup temporary files
npm run clean

Adding New Commands

  1. Create command file in /commands/ directory
  2. Follow established patterns and documentation standards
  3. Include comprehensive error handling and validation
  4. Add JSDoc documentation
  5. Update README and related documentation

πŸ“„ Legal & Compliance

Usage Guidelines

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

Disclaimer

The authors are not responsible for misuse of this software. Users bear full responsibility for ensuring legal compliance in their jurisdiction.

πŸ†˜ Support & Resources

Documentation

  • Complete Setup Guide: docs/INSTALLATION.md
  • Command Reference: Individual command help available via Discord
  • Configuration Guide: Environment setup and API integration

Health Monitoring

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

Community & Support

  • GitHub Issues: Bug reports and feature requests
  • Documentation: Comprehensive guides and examples
  • Discord Support: Community assistance and updates

πŸš€ Version Information

Current Version: 2.0.0
Author: gl0bal01
License: MIT
Node.js: >=16.9.0 required

Key Features in v2.0

  • 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

GitHub