🛡️ CyberShield URL Scanner

🚀 CyberShield

• is a real-time URL security scanner that helps users detect whether a website is safe or potentially harmful before visiting it.

🔗 Live Demo: https://mrinalray.github.io/Cybershield_URL/

---

📌 Features

• 🔍 Real-time URL scanning
• 🛡️ Detects phishing, malware, and social engineering threats
• ⚡ Fast and responsive UI
• 🌐 Uses Google Safe Browsing API
• ✅ Simple and user-friendly interface

---

🧠 How It Works

1. 🔗 Enter URL
   The user inputs a website link into the scanner.

2. ⚡ Send Request
   The application sends the URL to the security API.

3. 🛡️ Threat Analysis
   Google Safe Browsing analyzes the URL for:

   • Phishing attacks
   • Malware
   • Social engineering threats

4. 📊 Display Result
   The system shows a clear result:

   • ✅ Safe — No threats detected
   • ⚠️ Potential Threat — Risky or malicious content found

---

---

---

🧠 Tech Stack

Layer	Technology
Frontend	HTML5
Styling	CSS3 (Custom Properties, Responsive Design)
Logic	JavaScript (Vanilla JS)
Backend	Node.js (API Handling)
Security API	Google Safe Browsing API
Deployment	Render / Netlify / GitHub Pages

---

---

📸 Preview

---

🔑 API Integration

This project uses:

• Google Safe Browsing API
  • Detects malicious URLs
  • Requires API key from Google Cloud Console
  • To generate your API Key:
    1. Go to the Google Cloud Console.
    2. Create or select a project.
    3. Enable the Safe Browsing API.
    4. Go to APIs & Services > Credentials and generate an API key.
    5. Save the key in your local .env configuration file.

---

⚙️ Setup Instructions

1. Clone the repository:

git clone https://github.com/mrinalray/Cybershield_URL.git

2. Navigate to project folder:

cd Cybershield_URL

3. Create a .env file for backend configuration:

API_KEY=YOUR_API_KEY
CORS_ORIGINS=https://cybershield-url.netlify.app,http://localhost:5500
REQUEST_TIMEOUT_MS=5000
REQUEST_RETRIES=2

4. Start backend:

node server.js

5. Run frontend:

• Open index.html in browser

---

⚠️ Important Notes

• Do NOT expose your API key publicly
• Use environment variables for production
• This is a client-side demo (for hackathon/project use)

---

🚀 Future Improvements

• 🔐 Email breach checker integration (HIBP API)
• 📊 Threat analytics dashboard
  • View past scan results
  • Track phishing and malware detection trends
  • Visualize data with charts and logs
  • Export logs for offline analysis
• 🌍 Browser extension support
• 🤖 AI-based threat detection

---

📈 Threat Analytics Dashboard (Proposed)

CyberShield will be extended with a dedicated analytics dashboard for monitoring historical URL scans and threat patterns. This feature will allow users to:

• View past scan results and outcomes
• Track the frequency of phishing and malware detections
• Visualize trends using charts such as bar and line graphs
• Export scan logs for further analysis

Proposed implementation strategy:

• Create dashboard.html as a new dashboard page
• Use Chart.js or D3.js for interactive visualizations
• Store scan results in local storage for the demo
• Prepare backend database support for future persistence
• Add a navigation link from the main page to the dashboard

---

👨‍💻 Author

Mrinal Roy

• GitHub: https://github.com/mrinalray

Rahul Sah

• GitHub: https://github.com/real-rahul1

---

⭐ Support

If you like this project:

• ⭐ Star the repo
• 🍴 Fork it
• 📢 Share with others

---

📜 License

This project is for educational and demonstration purposes.