An eye on the ToR Browser network... get it, Onion Eye? 👁️🧅
OnionEye is a lightweight Python tool designed to skim and crawl the Tor network and regular websites, hunting down .onion and regular HTTP/HTTPS links. It’s built for cybersecurity enthusiasts, researchers, and curious minds who want to explore and analyze hidden services through the Tor proxy — all without the usual bloated overhead.
Warning
OnionEye fetches and scans URLs without executing any JavaScript, which helps keep you safer. However, some .onion sites may host malicious content.
Always keep JavaScript disabled in your Tor Browser when visiting unknown or scanned links!
Enabling JS on Tor can expose you to malware, tracking, and other attacks.
Caution
OnionEye does not filter or block dangerous content. It is intended for research and analysis only.
Visiting scanned links outside of Tor or with unsafe settings may expose your system to risks.
- Multi-seed crawling: Start from multiple seed URLs and explore links recursively.
- Tor SOCKS5 proxy support: Route all requests safely over your local Tor proxy.
- Link extraction: Parses HTML to find both regular and .onion links.
- JavaScript detection: Quickly detects if a page requires JS (for awareness).
- Configurable depth: Limit how deep the crawler dives.
- Modular and extensible: Clean Python modules to easily tweak or extend.
- Python 3.7+
- Requests
- BeautifulSoup4
- Tor running locally with SOCKS5 proxy enabled (usually on
127.0.0.1:9050)
- Install required Python packages:
pip install requests beautifulsoup4
Make sure you have Tor installed and running. On most systems:
sudo systemctl start tor
or launch the Tor Browser which provides the SOCKS proxy.
Update your seeds.json with your desired starting URLs.
To start scanning with OnionEye, run the provided setup script:
./startscript.sh
This script automates the following tasks:
Detects your operating system and installs the Tor client if it is not already installed.
Ensures the Tor service is enabled and running.
Checks for the presence of the Tor Browser and prompts you to install it if missing.
Creates and activates a Python virtual environment (venv) to isolate dependencies.
Installs all required Python packages as specified in requirements.txt.
Finally, launches the OnionEye crawler.
Note
You may have to chmod u+x startscript.sh first
OnionEye/
├── tor_skimmer/
│ ├── fetcher.py # Handles HTTP requests through Tor proxy
│ ├── parser.py # Extracts links and detects JS presence
│ ├── scanner.py # Core crawler logic
│ ├── storage.py # JSON export helpers (future use)
├── seeds.json # List of starting seed URLs
├── run.py # CLI entry point to launch scan
├── README.md # This file
Contributions are welcome! Feel free to open issues or pull requests for:
More efficient crawling
Better JS detection
Web UI integration
Exporting scan results
Anything else cool you dream up!
Important
Use OnionEye responsibly and legally. Do NOT scan or scrape sites without permission. The author(s) is not responsible for any misuse.
MIT License — See LICENSE for details.
Made with ❤️ by DrKel and the NetKnights Cybersecurity Club
Ready to get your eye on the onions? 🧅👁️