Ghana scam SMS detector — paste any SMS, phone number, or MoMo reference to check if it's a scam
# 🛡️ MoMo Catcher
**Ghana Scam SMS Detector** — *spot mobile money fraud before it hurts you.*
A smart web app that analyzes suspicious SMS messages, phone numbers, MoMo transaction references, and links for scam indicators — powered by AI, built for Ghana.
**Accra Technical University · Project ATU 302**
---
## 📋 Table of Contents
- ✨ Features
- 🧠 How It Works
- 🛠️ Tech Stack
- 📁 Project Structure
- 🚀 Getting Started
- 📡 API Reference
- 🔒 Privacy
- 📚 References
---
## ✨ Features
### 🏠 Home — Three Ways to Check
| Mode | What it does |
|------|-------------|
| 💬 **SMS / Phone / MoMo Ref** | Paste any suspicious message, Ghanaian number (024, 055, 020, 027…), or MoMo reference (`MOMO12ABC345`) → instant risk assessment |
| 🔗 **Check Link** | Analyze URLs for phishing — suspicious TLDs, typosquatted brands (MTN, Vodafone, GCB…), shortened links, scam keywords |
| 📸 **Scan Screenshot** | Snap or upload a screenshot of a scam SMS — vision AI reads the text and analyzes it |
### 📊 Results
- Risk level (**low / medium / high**) with an animated confidence score
- Plain-language reasoning + the exact scam indicators found
- 🚨 **Report Scam** — flag confirmed scams to the community database
### 📚 Learn
- **Scam Categories** — deep dives into Ghana's 8 deadliest tricks: Agyapade fake lottery, MoMo PIN phishing, SIM swap, fake deposits, fake promos, romance scams, employment scams, ghost-salary scams — each with red flags & how to report
- **Quizzes** — 12 real-world scenarios, instant explanations, best-score tracking
### 📈 Dashboard
- **Scam statistics** — total checks, scam rate, average confidence
- **Report statistics** — live community reports by category
- **Common scam types** — top detected indicators, ranked
- 🗑️ **Clear local data** — full privacy control
### 🔒 Privacy
- Plain-language policy: what's stored on-device, what's sent to the AI, how reporting works
- **No accounts. No cookies. No tracking.**
---
## 🧠 How It Works
```
┌──── …