Find user accounts across 200+ platforms in seconds
- 200+ built-in sites across multiple categories
- Smart detection using status codes and content analysis
- Metadata extraction from found profiles
- Async/await architecture for maximum speed
- Concurrent requests with configurable thread count
- Intelligent rate limiting to avoid blocks
- Random User-Agents for each request
- Multiple search modes (Standard, Deep, Stealth, Aggressive)
- No data storage unless explicitly configured
- JSON - Structured data for APIs
- CSV - Spreadsheet compatible format
- HTML - Beautiful visual reports
- Excel - Professional multi-sheet workbooks
- SQLite - Database storage for large datasets
- Risk assessment based on found accounts
- Personalized recommendations
- Statistical analysis of results
- Category grouping of found accounts
# Clone the repository
git clone https://github.com/vazor-code/cyber-find.git
cd cyber-find
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate.bat # Windows
# Install dependencies
pip install -r requirements.txt
pip install .
# Make it executable (Linux/macOS)
chmod +x cyberfind# Quick search (25 most popular sites)
cyberfind username
# Search with specific category
cyberfind username --list social_media
cyberfind username --list programming
cyberfind username --list gaming
# Comprehensive search (200+ sites)
cyberfind username --list all
# Multiple users
cyberfind user1 user2 user3 --list quick# Quick check on popular platforms
cyberfind john_doe
# Russian-language platforms only
cyberfind username --list russian
# Gaming platforms only
cyberfind username --list gaming
# Blogs and publications
cyberfind username --list blogs# Deep search with HTML report
cyberfind target --mode deep --format html -o report
# Stealth mode for sensitive searches
cyberfind target --mode stealth --timeout 15
# Maximum speed (use with caution)
cyberfind target --mode aggressive --threads 100
# Custom sites file
cyberfind target -f custom_sites.txt# Save as JSON (default)
cyberfind username -o results
# Save as CSV for Excel
cyberfind username --format csv -o results
# Save as HTML report
cyberfind username --format html -o report
# Save to database
cyberfind username --format sqlite| List Name | Sites Count | Description |
|---|---|---|
| quick | 25 | Most popular platforms (default) |
| social_media | 70+ | All social networks |
| programming | 25+ | IT and development platforms |
| gaming | 20+ | Gaming platforms and communities |
| blogs | 20+ | Blogs and publication platforms |
| ecommerce | 20+ | Shopping and commerce sites |
| forums | 12+ | Discussion forums |
| russian | 18+ | Russian-language platforms |
| all | 200+ | All available platforms |
View all available lists:
cyberfind --show-listsCreate a config.yaml file for custom settings:
# config.yaml
general:
timeout: 30 # Request timeout in seconds
max_threads: 50 # Maximum concurrent requests
retry_attempts: 3 # Retry attempts on failure
retry_delay: 2 # Delay between retries
user_agents_rotation: true # Rotate User-Agents
rate_limit_delay: 0.5 # Delay between requests
proxy:
enabled: false # Enable proxy support
list: [] # List of proxies
rotation: true # Rotate proxies
database:
sqlite_path: 'cyberfind.db' # SQLite database path
output:
default_format: 'json' # Default output format
save_all_results: true # Save all results to DB
advanced:
metadata_extraction: true # Extract metadata from pages
cache_results: true # Cache results
verify_ssl: true # Verify SSL certificatescyberfind/
├── cyberfind_cli.py # Main CLI interface
├── core.py # Core search engine
├── gui.py # Graphical interface
├── api.py # REST API server
├── config.yaml # Configuration template
├── requirements.txt # Python dependencies
├── README.md # This file
└── sites/ # Site definition files
├── social_media.txt
├── programming.txt
├── gaming.txt
└── ...
# Install development dependencies
pip install pytest pytest-asyncio pytest-cov
# Run tests
pytest tests/
# With coverage
pytest --cov=cyberfind tests/# Install formatting tools
pip install black flake8 isort
# Format code
black cyberfind_cli.py core.py
# Check code style
flake8 cyberfind_cli.py core.py
# Sort imports
isort cyberfind_cli.py core.pyStart the API server:
cyberfind --api
# Server starts at http://localhost:8080Example API request:
import requests
import json
response = requests.post('http://localhost:8080/api/search', json={
'usernames': ['target_user'],
'list': 'social_media',
'mode': 'standard'
})
results = response.json()# Launch the GUI
cyberfind --guiThe GUI provides:
- Visual search interface
- Real-time progress tracking
- Interactive results display
- One-click report generation
$ cyberfind john_doe --list quick
🔍 CyberFind v1.0.0
Searching for: john_doe
📋 Using built-in list: quick (25 sites)
🔍 Searching: john_doe
Checking 25 sites...
✓ Found: GitHub
✓ Found: Twitter
✓ Found: LinkedIn
Done: 3 found, 2 errors
✅ SEARCH COMPLETED in 12.5 seconds
============================================================
📊 STATISTICS:
Total checks: 25
Accounts found: 3
Errors: 2
👤 USER: john_doe
✅ FOUND 3 accounts:
📁 PROGRAMMING:
1. GitHub
URL: https://github.com/john_doe
Status: 200, Time: 1.23s
📁 SOCIAL_MEDIA:
2. Twitter
URL: https://twitter.com/john_doe
Status: 200, Time: 0.89s
3. LinkedIn
URL: https://www.linkedin.com/in/john_doe
Status: 200, Time: 1.45s
💡 RECOMMENDATIONS:
1. LinkedIn profile found - check contacts and connections
2. GitHub profile found - review public repositories
💾 Results saved to: results.json- Security research and penetration testing (with permission)
- Personal digital footprint analysis
- Academic research on social media presence
- Bug bounty hunting and security audits
- Investigating your own online presence
- Harassment, stalking, or doxxing
- Unauthorized surveillance
- Privacy violations
- Commercial data scraping without permission
- Any illegal activities
By using this tool, you agree to use it responsibly and legally. The developers are not responsible for misuse.
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
- Adding new site definitions
- Improving detection algorithms
- Enhancing the GUI
- Writing documentation
- Performance optimizations
- Bug fixes
- For speed: Use
--mode aggressive --threads 50 - For stealth: Use
--mode stealth --timeout 30 - For reliability: Use
--mode standard --retry 3 - For specific needs: Create custom site lists
-
"No sites loaded" error
- Ensure you have internet connection
- Check if the sites directory exists
-
Slow performance
- Reduce thread count:
--threads 20 - Increase timeout:
--timeout 30 - Use a faster internet connection
- Reduce thread count:
-
Many errors
- The target platforms may be blocking requests
- Try using stealth mode
- Consider using proxies
- Check the GitHub Issues
- Review the example configurations
- Test with a simple search first
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with aiohttp for async HTTP requests
- Uses BeautifulSoup4 for HTML parsing
- Inspired by various OSINT tools in the security community
- GitHub: vazor-code
- Project: CyberFind
- Issues: Report a bug
CyberFind · Find accounts · Analyze presence · Stay informed
Remember: With great power comes great responsibility
