AayanSuleri/ScamVerifier

🛡️ Scam-Signal Verifier

A comprehensive web application that helps users identify potentially fraudulent messages, emails, and advertisements. Perfect for protecting students, elderly individuals, and anyone who wants to stay safe from online scams.

🌟 Features

Multi-Agent Analysis System

• —Claim Extractor: Parses messages for URLs, phone numbers, emails, and financial amounts
• —Pattern Verifier: Analyzes content against known scam patterns and suspicious keywords
• —Risk Calculator: Provides a comprehensive risk score (0-100) with clear classification
• —Human-Friendly Explainer: Generates actionable recommendations and reporting templates

Detection Capabilities

• —Phishing Emails: Bank, PayPal, Amazon verification scams
• —Job Offer Scams: Work-from-home and "easy money" schemes
• —Investment Fraud: Cryptocurrency and get-rich-quick schemes
• —Lottery/Prize Scams: Fake winnings and inheritance claims
• —Urgency Tactics: High-pressure language and artificial deadlines
• —Suspicious Domains: Known malicious and shortened URLs

User Experience

• —Clean, modern interface with gradient design
• —Real-time risk assessment with color-coded results
• —Pre-loaded example scams for testing
• —One-click report template generation
• —Mobile-responsive design

🚀 Quick Start

Local Development

# Clone the repository
git clone <repository-url>
cd scam-signal-verifier

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Docker Deployment

# Build the image
docker build -t scam-verifier .

# Run the container
docker run -p 7860:7860 scam-verifier

Hugging Face Spaces

This app is optimized for Hugging Face Spaces deployment:

1. 1.Upload all files to your Spaces repository
2. 2.Set the Space to use Python/Gradio environment
3. 3.The app will automatically start on port 7860

🎯 How It Works

1. Message Analysis

The system extracts key information from suspicious messages:

• —URLs and domain reputation
• —Contact information (phone, email)
• —Financial references and amounts
• —Suspicious keywords and phrases
• —Urgency indicators and pressure tactics

2. Risk Assessment

Multi-factor scoring algorithm considers:

• —Keyword Score (0-40 points): Suspicious language patterns
• —Urgency Score (0-25 points): High-pressure tactics
• —Domain Risk (0-20 points): Suspicious or shortened URLs
• —Contact Risk (0-10 points): Multiple contact methods
• —Financial Risk (0-15 points): Money-related content

3. Classification System

• —🔴 HIGH RISK (80-100): Obvious scam, avoid completely
• —🟡 MEDIUM RISK (50-79): Suspicious, verify independently
• —🟢 LOW RISK (25-49): Minor concerns, stay cautious
• —✅ MINIMAL RISK (0-24): Appears legitimate

📊 Example Results

High-Risk Phishing Email

Risk Score: 95/100 - HIGH RISK
Red Flags:
🚨 Contains 6 suspicious keywords/phrases
🚨 Uses high-pressure urgency tactics  
🚨 Uses suspicious domain: secure-bank-verify.net
🚨 Mentions money/financial transactions

Recommendations:
🚫 Do NOT click any links or provide personal information
📧 Report this message as spam/phishing
🛡️ Block the sender immediately

🛡️ Safety Features

• —No External API Calls: All analysis happens locally for privacy
• —Educational Focus: Teaches users to recognize scam patterns
• —Report Generation: Creates templates for reporting to authorities
• —Multiple Examples: Pre-loaded scenarios for learning

🔧 Technical Stack

• —Backend: Python Flask with modular analysis engine
• —Frontend: Responsive HTML/CSS/JavaScript
• —Deployment: Docker + Gunicorn for production
• —Security: No data persistence, privacy-focused design

📱 Mobile Support

The interface is fully responsive and works seamlessly on:

• —Desktop browsers
• —Mobile phones
• —Tablets
• —Touch devices

🤝 Contributing

This is an educational tool designed to help people stay safe online. Feel free to:

• —Report bugs or issues
• —Suggest new scam patterns to detect
• —Improve the UI/UX design
• —Add new analysis features

📄 License

Open source educational project. Use responsibly to help others stay safe from online scams.

⚠️ Disclaimer

This tool is for educational purposes and general guidance. It should not be the sole method for determining if something is a scam. Always use your best judgment and consult with relevant authorities when needed.

Stay Safe Online! 🛡️