The Intelligent Real-Time Price Discovery Engine
Stop chasing deals. Let them come to you with a multithreaded Core Java backend and a premium Chrome Extension experience.
In an era of dynamic pricing and "Big Billion" sales, manual price checking is a waste of time. Price Scout is a performance-first tool designed by The Avengers to deliver real-time product data directly from the source. No more old, cached prices—just the absolute latest truth from Amazon and Flipkart, delivered in milliseconds.
Traditional trackers often show prices that are hours or even days old. Price Scout is different:
- Zero Latency: We don't use a "middleman" API. The scraping happens locally on your machine.
- Privacy First: Your search data stays in your local SQLite database, not on our servers.
- Pure Performance: Multi-threaded execution means we check multiple stores at the exact same time.
- 💨 Concurrent Engine: Powered by Java
ExecutorService, our engine spawns multiple workers to race for the best price. - 🔍 4-Byte Native Protocol: Uses the high-speed Chrome Native Messaging bridge to communicate between Java and JS.
- 📦 Zero-Configuration SQL: Leverages SQLite for a portable, file-based history that requires no server setup.
- 🎭 Intelligent Selectors: Advanced Jsoup implementation that adapts to e-commerce site structures.
- 📊 Trend Awareness: Logs every lookup with precision timestamps to help you identify price drops over time.
graph TD
A[Browser Popup UI] <-->|Native Messaging Bridge| B(Java Host Launcher)
B <-->|System.in / Out| C{Price Scout Engine}
C -->|Dispatch| D[Thread Pool: 3 Workers]
D -->|Worker 1| E[Amazon Scraper: Jsoup]
D -->|Worker 2| F[Flipkart Scraper: Jsoup]
D -->|Worker 3| G[Future Scrapers...]
E & F & G -->|Results| H[Cheapest Price Selector]
H -->|Save Trend| I[(SQLite DB: price_history)]
H -->|Return JSON| B
| Layer | Tools & Technologies |
|---|---|
| Backend Core |   |
| Parsing Engine |  (HTML DOM / CSS Selectors) |
| Concurrency | java.util.concurrent (ExecutorService, Async Future) |
| Database |  (Zero-Configuration Persistent Storage) |
| Messaging | Chrome Native Messaging (4-Byte Byte-Stream Protocol) |
| Frontend UI |    |
Running Price Scout requires a quick one-time handshake between your browser and your machine.
- JDK 17+ & Maven installed.
- Google Chrome browser.
For a complete walkthrough, see the Detailed Setup Guide.
- Build the Engine: Run
mvn clean packageinside thebackendfolder. - Register Host: Link your registry via the
host-config/scripts. - Install Extension: Load the
extension/folder in Chrome Developer Mode.
| Hero | Role | Focus | GitHub |
|---|---|---|---|
| 🛡️ Purvansh Joshi | Architect | UI/UX & Native Messaging | @PurvanshJoshi |
| ⚡ Parth Nailwal | Backend Lead | Multithreading & Logic | @parthnailwal |
| 🏹 Vansh Singh | Data Lead | Scrapers & SQLite | @vanshsingh |
To maintain high standards, every Pull Request is automatically vetted by our "Avengers Guard" suite:
- Build & Test: Maven-based compilation checks.
- Style Guard: Automated Checkstyle verification.
- Security: Automated vulnerability scanning for all dependencies.
- Hygiene: Semantic PR title linting.
"The power of Java, the reach of the Browser."
