Advanced OSINT Tool for Username Reconnaissance
NebulaOSINT is a powerful, asynchronous username search tool designed for Open Source Intelligence (OSINT) investigations. Hunt down user profiles across 223+ social networks, coding platforms, gaming sites, and more.
- 🌐 223+ Platforms: Search across social media, coding sites, gaming platforms, professional networks, and more
- ⚡ Asynchronous: Lightning-fast concurrent requests for efficient scanning
- 🔍 Fuzzy Search: Generate username variations and permutations for comprehensive discovery
- 📊 Multiple Export Formats: Save results as CSV, JSON, or HTML reports
- 🎨 Beautiful CLI: Rich terminal interface with progress bars and colored output
- 🔒 Proxy Support: Route requests through proxy servers for privacy
- ⏱️ Configurable Timeouts: Adjust request timeouts based on your needs
- 🔌 Extensible: Easy-to-add new platforms via JSON configuration
- 🐍 Modern Python: Built with Python 3.10+ using async/await patterns
| Category | Count | Platforms |
|---|---|---|
| 💻 Coding & Development | 18 | GitHub, GitLab, Bitbucket, StackOverflow, CodePen, HackerRank, LeetCode, CodeForces, CodeChef, AtCoder, TopCoder, Exercism, Glitch, Observable, JSFiddle, Replit, Dev.to, Kaggle |
| 📱 Social Media | 30 | Twitter, Instagram, Facebook, TikTok, Pinterest, Tumblr, Reddit, Snapchat, Telegram, WhatsApp, Mastodon, VK, Odnoklassniki, Weibo, Douban, Xiaohongshu, Threads, Bluesky, Clubhouse, Discord, Viber, Line, Kik, MeWe, Parler, Gab, Truth Social, Gettr, Minds, Diaspora |
| 💼 Professional | 15 | LinkedIn, Medium, Behance, Dribbble, ProductHunt, AngelList, Wellfound, Xing, ResearchGate, Academia, ORCID, Crunchbase, Polywork, Contra, Hired |
| 🎮 Gaming | 18 | Steam, Xbox Live, PlayStation Network, Itch.io, Roblox, Epic Games, Chess.com, Lichess, Kongregate, Armor Games, Newgrounds, Minecraft, Fortnite Tracker, Osu!, Smite Guru, Paladins Guru, Game Jolt, Razer Cortex |
| 🎵 Music | 12 | Spotify, SoundCloud, Bandcamp, Last.fm, Mixcloud, Audiomack, ReverbNation, Apple Music, Deezer, Tidal, Genius, Musically |
| 🎬 Video & Streaming | 12 | YouTube, Vimeo, DailyMotion, Rumble, Bitchute, DTube, Trovo, Kick, Twitch, Livestream, Caffeine, BIGO LIVE |
| 📸 Photography | 7 | Flickr, 500px, Unsplash, VSCO, EyeEm, ViewBug, YouPic |
| 🎨 Art | 8 | DeviantArt, ArtStation, Pixiv, CGSociety, Sketchfab, Cara, Fur Affinity, Coroflot |
| 💰 Content Creation | 8 | Patreon, Ko-fi, BuyMeACoffee, OnlyFans, Fansly, Substack, Ghost, Gumroad |
| 💬 Forums & Communities | 10 | HackerNews, Quora, Stack Exchange, Lobsters, Slashdot, Disqus, Discourse, phpBB, Kongregate Forums, Fandom |
| 🔐 Security & Hacking | 8 | Keybase, HackerOne, Bugcrowd, TryHackMe, HackTheBox, Root-Me, Vulnhub, PentesterLab |
| 📚 Education | 8 | Duolingo, Coursera, Udemy, Khan Academy, edX, Skillshare, Udacity, Memrise |
| 📖 Books & Writing | 7 | Goodreads, Wattpad, Archive of Our Own, FanFiction.net, LibraryThing, Scribophile, BookBub |
| 💪 Fitness & Health | 7 | Strava, MyFitnessPal, Fitbit, MapMyRun, Nike Run Club, Garmin Connect, Peloton |
| 🛒 E-commerce | 8 | Etsy, eBay, Mercari, Poshmark, Depop, Vinted, Grailed, Reverb |
| 💼 Freelance | 6 | Fiverr, Upwork, Freelancer, Guru, PeoplePerHour, Toptal |
| 📝 Blogging | 6 | WordPress, Blogger, LiveJournal, Typepad, Weebly, Wix |
| 💎 Crypto & Blockchain | 10 | CoinBase, Binance, OpenSea, Rarible, Foundation, SuperRare, KnownOrigin, Nifty Gateway, Etherscan, Mirror.xyz |
| 💕 Dating | 8 | Match, OKCupid, Plenty of Fish, Badoo, Hinge, Bumble, Coffee Meets Bagel, eHarmony |
| 8 | TripAdvisor, Airbnb, Couchsurfing, Atlas Obscura, Booking.com, Hostelworld, Lonely Planet, Foursquare | |
| 🔗 Links & Profiles | 6 | Linktree, AboutMe, Carrd, Bio.link, Campsite, Beacons |
| 🖼️ Avatar & Identity | 3 | Gravatar, Libravatar, Identicon |
Total: 223 Platforms across 22 Categories
- Python 3.10 or higher
- pip package manager
# Clone the repository
git clone https://github.com/ismailtsdln/NebulaOSINT.git
cd NebulaOSINT
# Install dependencies
pip install -r requirements.txt
# Install in development mode (enables 'nebula' command)
pip install -e .After installation with pip install -e ., you can use the short command nebula instead of python -m nebula.cli.main
# Short command (after pip install -e .)
nebula username
# Or using Python module directly
python -m nebula.cli.main username# Fuzzy search with username variations
nebula username --fuzzy
# Custom timeout (default: 10 seconds)
nebula username --timeout 15
# Use proxy for privacy
nebula username --proxy http://127.0.0.1:8080
# Export results to different formats
nebula username --csv results.csv
nebula username --json results.json
nebula username --html report.html
# Combine multiple options
nebula username --fuzzy --timeout 20 --csv output.csv --html report.html
# Real-world example
nebula johndoe --fuzzy --timeout 25 --proxy http://127.0.0.1:8080 --html investigation.html| Option | Description |
|---|---|
USERNAME |
Target username to search (required) |
--fuzzy |
Enable fuzzy search with username permutations |
--timeout INTEGER |
Request timeout in seconds (default: 10) |
--proxy URL |
Proxy URL (e.g., http://127.0.0.1:8080) |
--csv FILE |
Export results to CSV file |
--json FILE |
Export results to JSON file |
--html FILE |
Export results to HTML file |
--help |
Show help message and exit |
After installing with pip install -e ., you can use:
- ✅
nebula username(short and clean) ⚠️ python -m nebula.cli.main username(also works, but longer)
┌─────────────────────────────────────────────────────────────┐
│ │
│ _ __ __ __ ____ _____ _____ │
│ | \ | | | | | | / __ \| ___|_ _| │
│ | \| | ___| |__ _ _ | | | | | | |___ | | │
│ | . ` |/ _ \ '_ \| | | | | | | | | |\___ \ | | │
│ | |\ | __/ |_) | |_| | | |___| |__| |____| || |_ │
│ |_| \_|\___|_.__/ \__,_| |______\____/|_____/_____| │
│ │
│ NebulaOSINT - Advanced User Reconnaissance Tool │
│ │
└─────────────────────────────────────────────────────────────┘
Search Results
┏━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┓
┃ Site ┃ Username ┃ Status ┃ URL ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━┩
│ GitHub │ johndoe │ FOUND │ https://github... │
│ Twitter │ johndoe │ FOUND │ https://twitter...│
│ Instagram │ johndoe │ FOUND │ https://instagr...│
└──────────────┴──────────┴─────────┴───────────────────┘
Success: Found 3 matches.
[
{
"site_name": "GitHub",
"username": "johndoe",
"url": "https://github.com/johndoe",
"found": true,
"response_time": 0.234,
"category": "coding"
},
{
"site_name": "Twitter",
"username": "johndoe",
"url": "https://twitter.com/johndoe",
"found": true,
"response_time": 0.412,
"category": "social"
}
]Edit data/sites.json to add new platforms:
{
"name": "NewPlatform",
"url": "https://newplatform.com/users/{}",
"error_type": "status_code",
"error_code": 404,
"category": "custom"
}Parameters:
name: Platform display nameurl: URL template (use{}as username placeholder)error_type: Detection method (status_code,response_text, etc.)error_code: Expected error code when user doesn't existcategory: Platform category for organization
NebulaOSINT/
├── data/
│ └── sites.json # Platform database
├── nebula/
│ ├── api/ # REST API module (future)
│ ├── cli/ # Command-line interface
│ │ └── main.py # CLI entry point
│ ├── core/ # Core functionality
│ │ ├── engine.py # Search orchestration
│ │ ├── permutation.py # Username variations
│ │ └── sites.py # Site management
│ ├── network/ # Network layer
│ │ └── requester.py # Async HTTP requests
│ ├── outputs/ # Export handlers
│ │ └── reporter.py # CSV/JSON/HTML export
│ └── plugins/ # Plugin system (future)
├── tests/ # Test suite
├── pyproject.toml # Project metadata
└── requirements.txt # Dependencies
# Run all tests
pytest
# Run with coverage
pytest --cov=nebula
# Run specific test file
pytest tests/test_engine.py# Format code with Black
black nebula/
# Sort imports with isort
isort nebula/
# Lint with flake8
flake8 nebula/Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- 🌐 Add more platforms to
sites.json - 🐛 Fix bugs and improve stability
- 📝 Improve documentation
- ✨ Add new features (API, GUI, plugins)
- 🧪 Write tests
- 🌍 Add internationalization
This project is licensed under the MIT License - see the LICENSE file for details.
NebulaOSINT is intended for legal security research and educational purposes only. Users are responsible for complying with all applicable laws and regulations. The developers assume no liability for misuse of this tool.
Ethical Use Guidelines:
- ✅ Obtain proper authorization before testing
- ✅ Respect privacy and terms of service
- ✅ Use for security research and OSINT investigations
- ❌ Do not use for harassment or malicious purposes
- ❌ Do not violate platform terms of service
- ❌ Do not perform unauthorized access attempts
- Built with ❤️ by Ismail Tasdelen
- Inspired by tools like Sherlock, Maigret, and WhatsMyName
- Special thanks to the OSINT community
- Author: Ismail Tasdelen
- GitHub: @ismailtasdelen
- Issues: Report a bug
If you find NebulaOSINT useful, please give it a ⭐!
Made with 🌌 for the OSINT community