How bkg10/phishshield_extension works
PhishShield is a Chrome extension backed by a FastAPI phishing classifier. Its main workflow watches page navigation, sends the URL for analysis, and presents a verdict in-page and in the popup. The backend extracts page/URL signals and classifies them with a scaler and XGBoost model; the extension also reuses recent same-domain scans and keeps local history. The graph reflects documented and excerpted wiring; popup HTML, manifest permissions, and model internals were not sampled.
Main entry points: background.js Scan orchestration · app.py Prediction API · popup.js Status and history UI · url_feature_extractor.py Feature extraction
Components 12
Browser extension
- Navigation monitor
Frontend/background.js - Scan orchestration
Frontend/background.js - Page indicators
Frontend/background.js - Local scan history
Frontend/background.js - Status and history UI
Frontend/popup.js
Detection backend
- Prediction API
backend/app.py - Feature extraction
backend/url_feature_extractor.py
Inference assets
- Feature scaler
backend/scaler.pkl - XGBoost classifier
backend/xgb_model.json
Other components
- Browser user
- Visited website
- Hosted inference service
Connections 13
- Browser user → Visited website: visits
README.md - Visited website → Navigation monitor: navigation event
Frontend/background.js - Navigation monitor → Scan orchestration: dispatches scan
Frontend/background.js - Scan orchestration → Hosted inference service: posts URL
Frontend/background.js - Hosted inference service → Prediction API: routes prediction
README.md - Prediction API → Feature extraction: extracts features
backend/app.py - Prediction API → Feature scaler: scales features
backend/app.py - Prediction API → XGBoost classifier: predicts verdict
backend/app.py - Scan orchestration → Local scan history: stores result
Frontend/background.js - Scan orchestration → Page indicators: shows verdict
Frontend/background.js - Browser user → Status and history UI: opens popup
- Status and history UI → Scan orchestration: requests status
Frontend/popup.js - Status and history UI → Local scan history: requests history
Frontend/popup.js