Skip to content

Modern dark web threat intelligence scraper with sleek Streamlit UI - Monitor .onion sites for cybersecurity threats through Tor. Educational use only.

License

Notifications You must be signed in to change notification settings

uzaif-lab/darksearch

Repository files navigation

🕵️‍♂️ DarkSearch - Dark Web Threat Intel Scraper

"Because sometimes you gotta know what's lurking in the shadows"

TL;DR: A sleek web app that lets you monitor the dark web for cybersecurity threats. Built with Python + Streamlit, connects through Tor, and looks absolutely fire 🔥

Python Streamlit License

🤔 What's This About?

Ever wondered what cybercriminals are chatting about? This tool helps cybersecurity researchers and students monitor dark web sites for:

  • 💀 Data breach discussions
  • 🏴‍☠️ Ransomware activity
  • 🎭 Identity theft markets
  • 🔐 Stolen credentials chatter
  • 🚨 General cyber threat intelligence

Legal disclaimer: This is 100% for educational/research purposes. Don't be that person who uses this for sketchy stuff 😤

✨ Features That Hit Different

🎨 Modern UI - None of that 2010 terminal BS. Beautiful purple gradients and smooth animations
🧅 Tor Integration - Auto-connects through Tor (because privacy matters)
🔍 Smart Scraping - Monitors legit .onion sites only (DuckDuckGo, Facebook, etc.)
📊 Real-time Dashboard - Live metrics, charts, and progress bars
💾 Data Export - CSV exports for all your findings
Zero Config - Pre-loaded with 30+ keywords and 12 target sites

🚀 Quick Start (Like, Really Quick)

Step 1: Clone & Install

git clone https://github.com/yourusername/darksearch.git
cd darksearch
pip install -r requirements.txt

Step 2: Launch The Beauty

streamlit run main.py

Step 3: Open Browser

Navigate to http://localhost:8501 and boom 💥 You're in!

📱 Screenshots

The interface is actually gorgeous - modern purple gradients, smooth animations, and a cyberpunk vibe that just hits different

🎯 How To Use

  1. Home Page - Check your dashboard metrics and recent activity
  2. Configure - Add keywords you wanna monitor (already got 30 loaded)
  3. Scan - Hit that scan button and watch the magic happen
  4. Results - View findings, export to CSV, analyze patterns
  5. Analytics - Fancy charts because data visualization is chef's kiss 👌

⚙️ What's Under The Hood

  • Backend: Python 3.8+ (requests, BeautifulSoup, pandas)
  • Frontend: Streamlit with custom CSS (those gradients tho 🌈)
  • Networking: SOCKS5 proxy through Tor
  • Data: CSV storage (keeping it simple)
  • Security: Everything runs locally (your data stays yours)

🔧 Customization

Add Your Own Keywords

Hit the "Configuration" tab and add whatever terms you're tracking:

"zero-day exploit", "corporate breach", "leaked database"

Monitor New Sites

Drop new .onion URLs in the target sites list. Stick to public/legal ones obvs.

Export Your Data

One-click CSV export. Import into Excel, Tableau, or whatever floats your boat.

🛡️ Security & Legal Stuff

Real Talk: This tool is designed for:

  • ✅ Cybersecurity research
  • ✅ Academic studies
  • ✅ Threat intelligence gathering
  • ✅ Educational purposes

Hard No's:

  • ❌ Illegal activities
  • ❌ Accessing private/illegal content
  • ❌ Harassment or stalking
  • ❌ Anything that breaks laws

We only scrape PUBLIC sites that are already indexed. Think of it like Google but for the dark web's public square.

🐛 Troubleshooting

Tor connection failed?

  • Hit the "Auto-Connect to Tor" button
  • Make sure Tor Browser is installed
  • Check if your VPN is blocking Tor

App won't start?

pip install --upgrade streamlit
streamlit run main.py --server.port 8502

Scans not working?

  • Check your internet connection
  • Some .onion sites are just down (it happens)
  • Try different keywords

🤝 Contributing

Found a bug? Got ideas? PRs are welcome! Just:

  1. Fork it
  2. Create a feature branch
  3. Make your changes
  4. Submit a PR with a decent description

📜 License

MIT License - do whatever you want, just don't blame me if something breaks 🤷‍♂️

🙏 Credits

Shoutout to:

  • Streamlit team for making web apps stupid easy
  • Tor Project for keeping the internet free
  • Coffee ☕ for keeping me awake during late-night coding sessions

🔗 Links


Built with 💜 by a cybersecurity student who got tired of ugly terminal tools

P.S. - If this helped your research, drop a ⭐ on the repo. It literally costs nothing but means everything to developers like me!


🚨 Final Reminder

This tool is for educational and research purposes only. Use responsibly, follow your local laws, and don't be a script kiddie. The cybersecurity community is about protection, not exploitation.

Stay safe out there! 🛡️✨

About

Modern dark web threat intelligence scraper with sleek Streamlit UI - Monitor .onion sites for cybersecurity threats through Tor. Educational use only.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published