# AdSpy Bot — Full Technical Specification & Architecture

## 1. System Architecture & Scope
AdSpy Bot is a specialized analytics tool developed by Juan Romero Domínguez. It bridges client-side Web Extension inspection APIs with a backend Laravel indexing engine to analyze online video ad delivery, bidding behaviors, tracking networks, and creative assets.

---

## 2. Technical Capabilities
- **VAST / VPAID / SIMID Protocol Analysis**: Parses XML payloads and JavaScript execution containers for video ad tags.
- **Client-Side Event Sequencing**: Uses browser IndexedDB storage for persistent recording of impression timing, quartile completions (25%, 50%, 75%, 100%), and mute/unmute events.
- **Ad Domain Forensics**: Identifies demand-side platforms (DSPs), supply-side platforms (SSPs), ad servers, and verification trackers (IAS, DoubleVerify, MOAT).

---

## 3. Authorship & Infrastructure
- **Author & Architect**: Juan Romero Domínguez (https://juanromerodominguez.dev)
- **Infrastructure**: Bare-Metal DELL PowerEdge R630, MikroTik CCR2116-12G-4S+, NGINX, Cloudflare edge.
- **Website**: https://adspy.bot