Skip to content
Fluffy-debugerPublic

About

A simple web pentesting toolkit that integrates a browser extension with a Docker-based backend to run security scans and generate summaries.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Scanly (Web Pentest Toolkit)

Scanly makes basic web security testing simple by letting users scan websites directly from the browser and view results instantly

Overview

Scanly is a browser-based vulnerability scanning toolkit built as a prototype.

It combines:

  • Chrome Extension
  • Flask Backend
  • Docker Container (Ubuntu + security tools)
  • Tools: Nmap, Nikto, Whois, WhatWeb, Gobuster, SQLMap, TestSSL, Subfinder.
  • Optional AI summarization (Gemini API)

This project is mainly for learning, demonstration, and academic use.


How It Works

  1. User opens a website
  2. Opens the extension popup
  3. Clicks a scan button
  4. Request goes to Flask backend (inside Docker)
  5. Backend runs security tools
  6. Output is processed
  7. AI generates a summary
  8. Result + Summary shown in UI

Screenshots

demoimg1 demoimg2 demoimg2

Project Structure

project_structure


Setup Instructions

Clone repository

git clone https://github.com/Fluffy-debuger/Scanly.git

Go to project directory

cd Scanly

1. Build Docker Image

Inside backend/:

with docker compose

docker-compose up --build

2. Alternative (Manual Docker)

docker build -t pentest-backend .
docker run -p 5000:5000 pentest-backend

Now backend will be running at:

http://localhost:5000

3. Update Backend URL in Extension

In popup.js, update:

const BACKEND = "http://172.17.0.2:5000";

Replace with:

const BACKEND = "http://localhost:5000";

(Use container IP only if needed)


4. Load Extension

  1. Open chrome://extensions
  2. Enable Developer Mode
  3. Click Load Unpacked
  4. Select frontend/

Features

  • Quick Scan (Nmap)
  • Custom Nmap scans (flags)
  • Nikto vulnerability scan
  • Whois lookup
  • CMS detection (WhatWeb)
  • Gobuster (directory brute force)
  • SQLMap (basic testing)
  • TestSSL (SSL/TLS check)
  • Subfinder (subdomain discovery)
  • Result display (raw output)
  • AI summary (Gemini and rule-based)
  • Export report (txt)
  • Copy results

Limitations

  • Prototype only (not production-ready)
  • Some tools require proper tuning
  • Output can be large and unfiltered
  • No authentication or access control
  • AI summary may not always be accurate

Security Notes

  • Run scans only on authorized targets
  • Tools like SQLMap and Gobuster can be aggressive

Future Improvements

  • Better UI (tabs, filters)
  • Background scanning (async)
  • Scan history
  • Multi-target scanning

Note

This project demonstrates:

  • Browser Extension development
  • Backend API design
  • Docker-based tool integration
  • Automation of security tools
  • Basic AI integration

About

A simple web pentesting toolkit that integrates a browser extension with a Docker-based backend to run security scans and generate summaries.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages