ShadowScout

An AI-powered browser extension that uncovers and analyzes suspicious, hidden, or malicious links on any webpage to keep you safe online.

View on GitHub

Features

  • Real-time Link Detection: Scans pages for hidden links, tiny clickables, and other deceptive elements.
  • AI-Powered Analysis: Leverages a powerful language model to analyze suspicious links for phishing, malware, and other threats.
  • Browser Automation: Uses a headless browser on the backend to safely "detonate" links and analyze their true behavior.
  • Detailed Side Panel UI: View, filter, and inspect all potentially suspicious links found on a page.
  • Smart Caching: Caches analysis results to provide instant feedback on previously seen content.

Installation Guide

ShadowScout is not on the Chrome Web Store yet. You can install it directly from the source code by following these steps.

1. Get the Code

First, you need a copy of the project on your local machine. You can either download the ZIP file or clone the repository using Git. 

git clone https://github.com/your-username/shadowscout.git
cd shadowscout

2. Install the Extension in Chrome

  1. Open your Chrome browser and navigate to chrome://extensions.
  2. Enable "Developer mode" using the toggle switch in the top-right corner.
  3. Click the "Load unpacked" button that appears.
  4. In the file selection dialog, navigate to the cloned repository and select the extension folder inside it.

The ShadowScout icon (🔍) should now appear in your browser's toolbar!

3. Run the Backend Server

The extension needs its backend server to perform analysis. For complete instructions on setting up Python, Playwright, and Redis, please refer to the README.md file.

Once configured, start the server from the project's root directory: 

python app.py

With the backend running and the extension installed, you can now visit any webpage to start seeing ShadowScout in action.