browser-extension/README.md

Phishing Detector Browser Extension

ML-powered phishing detection extension for Chrome/Edge browsers.

Features

• 🔍 Real-time Detection: Check websites as you browse
• 🛡️ Manual URL Check: Test any URL before visiting
• 📊 Statistics: Track sites checked and threats blocked
• ⚠️ Visual Warnings: Clear alerts for dangerous sites
• 🎯 ML-Powered: Uses trained model from API

Installation

Chrome/Edge:

1. Open browser and go to chrome://extensions/ (or edge://extensions/)
2. Enable Developer mode (toggle in top-right)
3. Click Load unpacked
4. Select the browser-extension folder
5. Extension will appear in your toolbar!

Usage

Automatic Check:

1. Click the extension icon on any website
2. See instant safety status of current site

Manual Check:

1. Click extension icon
2. Enter any URL in "Check Any URL" field
3. Click "Check URL" button
4. Get instant results

Context Menu:

• Right-click any link
• Select "Check this link for phishing"

API Configuration

The extension connects to: https://kshitijk20-nss.hf.space

To change API URL:

1. Edit popup.js
2. Update API_URL constant
3. Reload extension

Features Extracted

The extension automatically extracts 30 URL features:

• IP address detection
• URL length analysis
• SSL/HTTPS verification
• Subdomain analysis
• Suspicious patterns (@ symbol, redirects)
• Domain characteristics
• And 20+ more security indicators

Statistics

The extension tracks:

• Sites Checked: Total websites analyzed
• Threats Blocked: Phishing sites detected

Development

File Structure:

browser-extension/
├── manifest.json      # Extension configuration
├── popup.html         # Extension popup UI
├── popup.js           # Popup logic
├── popup.css          # Popup styling
├── content.js         # Page content script
├── background.js      # Background service worker
└── icons/            # Extension icons

To Test Changes:

1. Make your changes
2. Go to chrome://extensions/
3. Click reload button on the extension
4. Test the extension

Privacy

• No data collection
• No tracking
• All checks go through your API
• Local statistics only

Troubleshooting

Extension not working:

• Check if API is running: https://kshitijk20-nss.hf.space
• Check browser console for errors
• Reload extension

False positives:

• Model is trained on specific dataset
• Can be improved with more training data

API errors:

• Ensure HF Space is awake (not sleeping)
• Check network connection
• Verify API URL is correct

Future Improvements

• Add settings page
• Enable/disable auto-check
• Whitelist trusted sites
• Export statistics
• Multi-language support
• Firefox version

Support

For issues or questions:

• GitHub: Your repository
• API: https://kshitijk20-nss.hf.space/docs

License

MIT License - Feel free to modify and distribute!