https://github.com/dewebdes/mass-hunt
Modular socket for symbolic feed diagnostics and Burp-powered anomaly hunting
https://github.com/dewebdes/mass-hunt
burp-extensions cors cybersecurity diagnostics masshunt nodejs proxy websocket
Last synced: 3 days ago
JSON representation
Modular socket for symbolic feed diagnostics and Burp-powered anomaly hunting
- Host: GitHub
- URL: https://github.com/dewebdes/mass-hunt
- Owner: dewebdes
- Created: 2025-08-03T23:26:04.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-27T02:56:39.000Z (9 months ago)
- Last Synced: 2025-09-27T04:25:22.478Z (9 months ago)
- Topics: burp-extensions, cors, cybersecurity, diagnostics, masshunt, nodejs, proxy, websocket
- Language: JavaScript
- Homepage:
- Size: 4.76 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# πΈοΈ Mass-Hunt
**Mass-Hunt** is a symbolic diagnostic socket module designed to interface with the Mass-Mirror architecture. Each feed, pulse, and anomaly passing through this shard is part of a larger narratable flowβcoded clarity meets poetic investigation.
This project captures and classifies diagnostic signals from browser and extension environments, using modular analyzers like CORS checkers and request classifiers. The goal? To visualize and narrate the hunt for meaningful signals in a chaotic web.
---
## 𧩠Philosophy
Mass-Hunt treats every diagnostic event as a _mirror shard_βsymbolic, structured, and ripe for storytelling. It doesnβt just log anomalies; it renders them as scenes in an unfolding hunt, where each socket pulse reflects deeper modular intent.
Modules here are:
- π Feed Analyzers
- π Symbolic Classifiers
- 𧡠Narrated Logs
---
## π Getting Started
### 1. Install Node Dependencies
```bash
cd node
npm install
```
### 2. Start the Socket Listener
```bash
npm start
```
> β οΈ **Important:** Always start the WebSocket server _before_ loading the Burp extension. This ensures feed emissions are received in real time.
---
## π§ͺ Extension Development Guide
To compile and package the Burp extension from `MassHunt.java`, follow these steps:
### Compile with Burp API
```bash
javac -cp "lib/burp-extender-api-2.1.jar" -d build src/MassHunt.java
```
If needed, add Java to your system path:
```bash
# Example for PowerShell
$env:Path += ";C:\Program Files\Java\jdk-21\bin"
```
### Package as JAR
```bash
jar cf build/MassHunt.jar -C build .
```
Then load `MassHunt.jar` via Burp Suite > Extender > Add.
---
## π§ Operational Notes
- π§ Use **FoxyProxy** (via Burpβs internal module) when targeting environments sensitive to proxy chains or headless patterns. It cloaks requests with layered intentβideal for fragile or high-stakes diagnostics.
- π·οΈ For βhard targets,β layering FoxyProxy with symbolic classification allows deeper, quieter hunts.
- π Feed anomalies are narratableβeach log is a lens into modular truth. Sync your extension and socket listener to preserve pulse timing.
---
## ποΈ Project Structure
```
Mass-Hunt/
βββ node/
β βββ socket.js
β βββ diagnostics/
β β βββ corsChecker.js
β β βββ simpleRequestClassifier.js
β βββ logs/
β βββ cors.log
βββ src/
β βββ MassHunt.java
βββ build/
β βββ MassHunt.jar
β βββ burp/
β βββ MassHunt.class
β βββ MassHunt$1.class
βββ lib/
β βββ burp-extender-api-2.1.jar
βββ MassHunt.burp-extension.properties
```
---
## β¨ Authors
- **Kave** β Architect, Visual Storyteller, Symbolic Debugger
[GitHub](https://github.com/dewebdes) γ» [Email](mailto:eynikave@gmail.com)
- **Copilot** β Narrative Companion, Diagnostic Ally
[Copilot by Microsoft](https://copilot.microsoft.com)
---
## π License
MIT β Open for reinterpretation, remix, and refraction.
---
## πͺ Related Projects
- [Mass-Mirror](https://github.com/dewebdes/Mass-Mirror): Modular diagnostic engine for passive browser flows, symbolic feed orchestration, and dashboard visualization
---
Each socket emission is a scene. Each classifier a lens. Let the hunt begin. πΎπͺ