cyberninja 1.0.0

CyberNinja: Advanced Social Media Intelligence Tool

Overview    |    Features    |    Installation    |    Usage    |    Docker    |    Contributing

Overview

CyberNinja is a powerful OSINT (Open Source Intelligence) tool designed for digital investigators, security researchers, and privacy enthusiasts. It enables rapid reconnaissance across multiple social media platforms to track digital footprints using usernames.

Features

• 🚀 Lightning Fast: Concurrent searching across hundreds of platforms
• 🛡️ Privacy First: Built-in Tor support for anonymous searching
• 🔍 Comprehensive Coverage: Search across major social networks, forums, and websites
• 📱 Phone Number Intelligence: Gather information about phone numbers including carrier, location, and associated services
• 📊 Flexible Output: Export results in JSON, CSV, or text formats
• 🌐 Proxy Support: Custom proxy configuration for enhanced privacy
• 🔧 Highly Configurable: Customize timeout, verbosity, and search parameters
• 🐳 Docker Ready: Easy deployment with containerization support

Installation

# Clone the repository
$ git clone https://github.com/omarkdev/cyberninja.git

# Navigate to the project directory
$ cd cyberninja

# Install required dependencies
$ python3 -m pip install -r requirements.txt

Usage

$ python3 cyberninja --help
usage: cyberninja [-h] [--version] [--verbose] [--folderoutput FOLDEROUTPUT]
                [--output OUTPUT] [--tor] [--unique-tor] [--csv]
                [--site SITE_NAME] [--proxy PROXY_URL] [--json JSON_FILE]
                [--timeout TIMEOUT] [--print-all] [--print-found] [--no-color]
                [--browse] [--local]
                USERNAMES [USERNAMES ...]

CyberNinja: Advanced Social Media Intelligence Tool (Version 1.0.0)

positional arguments:
  USERNAMES             One or more usernames to investigate

optional arguments:
  -h, --help            Show this help message and exit
  --version            Display version information
  --verbose, -v        Enable detailed debugging output
  --output OUTPUT      Save results to specified file
  --tor, -t           Enable Tor routing for anonymous searching
  --csv               Export results in CSV format
  --json JSON_FILE    Load custom site data from JSON file
  --timeout TIMEOUT   Custom request timeout in seconds

Basic Examples

# Search for a single username
$ python3 cyberninja username123

# Search multiple usernames
$ python3 cyberninja user1 user2 user3

# Search for phone number information
$ python3 cyberninja --phone +1234567890

# Search phone number with country code
$ python3 cyberninja --phone --country US 1234567890

# Enable Tor routing for anonymous searching
$ python3 cyberninja --tor username123

# Export results to CSV
$ python3 cyberninja --csv --output results.csv username123

Phone Number Search

CyberNinja includes powerful phone number intelligence capabilities:

• Carrier Information: Identify the telecommunications carrier
• Location Data: Get geographic information associated with the number
• Number Type: Determine if it's mobile, landline, or VoIP
• Risk Assessment: Check for spam or fraud reports
• Connected Services: Find linked social media and online accounts
• Historical Data: View past associations and usage patterns

Example phone number search output:

📱 Phone Number Analysis: +1234567890
----------------------------------
✓ Carrier: Example Telecom
✓ Location: New York, United States
✓ Type: Mobile
✓ Time Zone: EST (UTC-5)
✓ Format: Valid International

Docker

CyberNinja can be run using Docker for easy deployment and consistency across platforms.

# Build the Docker image
$ docker build -t cyberninja .

# Run CyberNinja in a container
$ docker run -it cyberninja username123

pull the Docker Image

$ docker pull vimald/cyberninja02:latest

#Run the Container

$ docker run -it vimald/cyberninja02:latest username123

Using Docker Compose:

$ docker-compose run cyberninja username123

Docker Hub Link vimald/cyberninja02:latest

Privacy and Security

CyberNinja is designed with privacy in mind:

• All requests can be routed through Tor
• Custom proxy support for enhanced anonymity
• No data collection or external API dependencies
• Local result storage only

Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to your branch
5. Create a Pull Request

Please ensure your code follows our style guidelines and includes appropriate tests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to all contributors who have helped shape CyberNinja
• Special thanks to the OSINT community for their valuable feedback
• Built with by the CyberNinja team