🛡️ ScamShield AI

AI-Powered Scam Detection Platform

Detect phishing websites, scam messages, fraudulent emails, fake job offers and suspicious content using Google Gemini AI.

---

📸 Preview

---

✨ Features

🛡️ AI-powered Scam Detection

🔗 Detect Suspicious URLs

📩 Analyze Scam SMS & Emails

💼 Fake Job Offer Detection

💰 Lottery & Investment Scam Detection

⚠️ Risk Classification (Low / Medium / High)

📊 AI Confidence Score

📋 Detailed Scam Explanation

🛡️ Personalized Safety Recommendations

🌙 Modern Responsive UI

---

🧠 How It Works

User Input
      │
      ▼
React Frontend
      │
      ▼
FastAPI Backend
      │
      ▼
Google Gemini AI
      │
      ▼
Risk Analysis
      │
      ▼
AI Response

---

🛠 Tech Stack

Frontend

• React.js
• Vite
• JavaScript
• CSS3

Backend

• FastAPI
• Python
• Uvicorn

AI

• Google Gemini 2.5 Flash API

Deployment

• ▲ Vercel
• Render

---

📂 Project Structure

ScamShield-AI
│
├── frontend
│   ├── src
│   ├── public
│   ├── package.json
│   └── ...
│
├── backend
│   ├── main.py
│   ├── requirements.txt
│   ├── .env
│   └── ...
│
├── assets
│   └── preview.png
│
└── README.md

---

🚀 Live Demo

🌐 Frontend

https://scam-shield-ai-git-main-khutejakhans-projects.vercel.app/

⚙️ Backend API

https://scamshield-ai-1vy7.onrender.com/analyze

---

⚡ Installation

Clone Repository

git clone https://github.com/khutejakhan/ScamShield-AI.git

---

Backend Setup

cd backend

python -m venv venv

venv\Scripts\activate

pip install -r requirements.txt

uvicorn main:app --reload

Backend runs on

http://127.0.0.1:8000

---

Frontend Setup

cd frontend

npm install

npm run dev

Frontend runs on

http://localhost:5173

---

🔑 Environment Variables

Create a .env file inside the backend folder.

GEMINI_API_KEY=YOUR_GEMINI_API_KEY

---

🧪 API Endpoint

Analyze Scam

POST /analyze

Example Request

{
  "text":"Congratulations! You won ₹50,000. Click here to claim."
}

---

📊 Example Output

{
  "risk":"High Risk",
  "confidence":94,
  "category":"Phishing",
  "summary":"The message contains common phishing indicators.",
  "reasons":[
      "...",
      "...",
      "..."
  ],
  "advice":"Avoid clicking unknown links."
}

---

🚀 Future Improvements

• 🔐 User Authentication
• 📈 Dashboard Analytics
• 📄 PDF Report Download
• 📜 Scan History
• 🌍 Multi-language Support
• 🧩 Browser Extension
• 📱 Mobile App
• 📊 Advanced Threat Reports

---

💻 Developer

Khuteja Khan

Second Year BCA Student

Passionate about

• Artificial Intelligence
• Python Development
• Full Stack Development
• Cyber Security
• Machine Learning

---

🌐 Connect With Me

GitHub

https://github.com/khutejakhan

LinkedIn

https://www.linkedin.com/in/khuteja-khan

---

⭐ Support

If you like this project,

⭐ Star this repository

It motivates me to build more AI-powered open-source projects.

---

Made with ❤️ using React, FastAPI & Google Gemini AI