Skip to content

QUICK_START.md

Latest commit

 

History

History
85 lines (59 loc) · 2.46 KB

QUICK_START.md

File metadata and controls

85 lines (59 loc) · 2.46 KB

🚀 Quick Start Guide - Dark Web Threat Intelligence Scraper

✅ INSTANT READY - NO SETUP NEEDED!

Your Dark Web Threat Intelligence Scraper is pre-configured and ready to use locally!

🔧 What's Already Set Up:

📍 30 Pre-loaded Keywords:

  • data breach, leaked data, stolen credentials
  • ransomware, cybercrime, hack, exploit
  • credit card, bank account, social security
  • identity theft, personal data, malware
  • And 18 more cybersecurity terms!

🌐 12 Pre-configured .onion Sites:

  • DuckDuckGo Tor - Privacy search engine
  • Facebook Tor - Social network mirror
  • SearchGO - Dark web search
  • Haystack - Another search engine
  • Torch - Popular dark web search
  • Ahmia - Surface web to dark web bridge
  • And 6 more legitimate, public sites!

🏃 How to Start (3 Simple Steps):

1. Start Tor Browser

2. Launch the Scraper

streamlit run main.py

3. Start Scanning

🎯 What Happens:

✅ Connects through Tor (anonymous & secure) ✅ Scans 12 legitimate .onion sites ✅ Searches for 30 cybersecurity keywords ✅ Shows results in real-time ✅ Saves everything to CSV files ✅ 100% local - no cloud/deployment needed

📊 Where to Find Results:

  • Live results: In the web interface
  • CSV file: results.csv in your folder
  • View in app: Go to "📊 View Results" page

🔍 Add Your Own Keywords:

  1. Go to "⚙️ Configuration" page
  2. Type your company name, products, etc.
  3. Click "➕ Add"
  4. Run another scan!

🛡️ 100% Safe & Legal:

  • ✅ Only accesses public .onion sites
  • ✅ No login attempts or illegal content
  • ✅ Educational use only
  • ✅ Runs completely on your laptop
  • ✅ No data sent to any servers

🚨 If Tor Connection Fails:

  1. Make sure Tor Browser is running
  2. Check if it's on port 9050 (default)
  3. Go to "🛠️ System Status" to test connection
  4. That's it! No complex setup needed.

🎉 You're Ready!

Everything is pre-configured for immediate use! Just start Tor Browser and click "Run Quick Scan" - no deployment, no cloud, no complex setup. It all runs locally on your laptop! 🌟