🛡️ CyberShield URL Scanner

Real-time URL security scanner — detect phishing, malware, and social engineering threats before you click.

---

✨ Features

Feature	Description
🔍 Real-time URL Scanning	Instant analysis against Google's threat database
📸 Screenshot Scanner	Drag & drop screenshots — Gemini AI extracts URLs via OCR
💬 AI Scam Detector Chat	Analyze suspicious emails, messages, or job pitches
🛡️ Threat Detection	Phishing, malware, and social engineering threats
⚡ Fast & Responsive UI	Clean interface with instant results

---

🖼️ Preview

---

🧠 How It Works

 ┌─────────────────┐    ┌──────────────────┐    ┌──────────────────┐    ┌────────────────┐
 │  1. Enter URL   │───▶│  2. Send Request │───▶│  3. Threat Scan  │───▶│  4. Result     │
 │  or Screenshot  │    │  to Security API │    │  (Safe Browsing) │    │  ✅ Safe        │
 └─────────────────┘    └──────────────────┘    └──────────────────┘    │  ⚠️ Threat     │
                                                                          └────────────────┘

1. Enter URL or Upload Screenshot — Manually type a URL or drag & drop a screenshot. Gemini AI extracts the URL automatically via OCR.
2. Send Request — The app securely forwards the URL to Google Safe Browsing.
3. Threat Analysis — Scanned for phishing, malware, and social engineering in real time.
4. Clear Result — ✅ Safe (no threats) or ⚠️ Threat (malicious content found).

---

🧰 Tech Stack

---

🔑 API Setup

🌐 Google Safe Browsing API

1. Go to Google Cloud Console
2. Enable the Safe Browsing API
3. Navigate to APIs & Services → Credentials and generate a key
4. Save it as API_KEY in your .env file

🤖 Gemini API

1. Go to Google AI Studio
2. Click Get API Key and create a new key
3. Save it as GEMINI_API_KEY in your .env file

---

⚙️ Setup & Installation

# 1. Clone the repository
git clone https://github.com/mrinalray/Cybershield_URL.git
cd Cybershield_URL

# 2. Configure environment variables
cp .env.example .env
# Open .env and fill in API_KEY and GEMINI_API_KEY

# 3. Start the backend
node server.js

# 4. Open frontend
# Open index.html in your browser

⚠️ Never expose your API keys publicly. Always use environment variables in production.

---

🚀 Roadmap

• 🔐 Email breach checker (HIBP API)
• 📊 Threat analytics dashboard with charts
• 🌍 Browser extension
• 🤖 AI-based threat detection
• 📤 Export scan logs for offline analysis

---

🤝 Contributors

A huge thank you to all the amazing people who have contributed to CyberShield! 💙

Want to contribute?
Check out our Contributing Guidelines and submit a PR — your avatar gets added automatically! 🚀

---

👨‍💻 Authors

Mrinal Roy

Rahul Sah

---

⭐ Support

If CyberShield helped you or you think it's cool:

---

_{📜 This project is for educational and demonstration purposes.}