🧩 Source Genius — Chrome Extension (MV3)

The core Manifest V3 Chrome Extension powering the Source Genius Amazon brand website discovery platform.

Overview • Features • Architecture • Installation • License

---

🌟 Overview

SourceGenius-Extension is the standalone client-side component of the Source Genius enterprise brand discovery suite. Operating natively within Google Chrome via the modern SidePanel API, it empowers Amazon wholesale sellers, private-label sourcers, and e-commerce researchers to extract verified brand names and locate official manufacturer domain websites in seconds.

---

🚀 Key Features

• 📑 Chrome Sidepanel Experience: Stays pinned alongside your active browser tab without obscuring Amazon search results or product details.
• ⚡ Multi-Tier Website Search Pipeline: Resolves extracted brand names to real domains via a sequential cascade:
  • Direct DNS probing & WHOIS verification
  • DuckDuckGo & DuckDuckGo Lite zero-telemetry queries
  • Yahoo & Mojeek search fallbacks
  • Brave Search API connectivity
• 🛡️ Anti-Fingerprint Stealth Layer (stealth.js): Injected into target tab contexts to mask automation flags, mock hardware concurrency, and avoid bot challenges.
• 🐕 Self-Healing Watchdog Daemon (watchdog.js): Detects stalled background requests, unfreezes UI states, and handles automatic service worker reconnection.
• ☁️ Google Apps Script Sync (user-livewrite.gs): Real-time streaming of discovered brands, ASINs, domains, and contact leads directly into collaborative Google Sheets.

---

🏗️ Extension Architecture

flowchart TD
    A[Amazon Product / Search Tab] -->|Active DOM Context| B[stealth.js: Mask Fingerprint]
    B --> C[sidepanel.js: UI Controller]
    C <-->|Runtime Messaging| D[background.js: MV3 Service Worker]
    D <-->|State & Health Checks| E[watchdog.js: Keep-Alive Daemon]
    D -->|Multi-Engine Search Cascade| F{Brand Domain Engine}
    F -->|Tier 1: Direct DNS / DDG| G[Official Brand Website Discovered]
    F -->|Tier 2: Yahoo / Mojeek| G
    G --> C
    D -->|HTTPS POST Stream| H[user-livewrite.gs: Google Sheets Sync]

Loading

---

📁 Repository Structure

SourceGenius-Extension/
├── manifest.json       # Manifest V3 configuration, permissions & declarative rules
├── background.js       # Core service worker managing search cascade & data streams
├── sidepanel.html      # Responsive sidepanel interface HTML
├── sidepanel.js        # UI events, table rendering & local state management
├── stealth.js          # Anti-bot fingerprint patching script
├── watchdog.js         # Service worker keep-alive & process watchdog
├── user-livewrite.gs   # Google Apps Script cloud sync integration
├── icons/              # High-resolution extension brand assets
├── .gitignore          # Packaging and runtime exclusions
└── LICENSE             # Open-source MIT License

---

⚡ Installation

1. Clone or download this repository:

   git clone https://github.com/Kamran5H/SourceGenius-Extension.git

2. Open Google Chrome and navigate to chrome://extensions/.
3. Enable Developer mode using the toggle switch in the top-right corner.
4. Click Load unpacked and select the SourceGenius-Extension directory.
5. Click the Source Genius extension icon in your toolbar to open the sidepanel!

---

📜 License

This project is open-source and released under the MIT License.
Copyright (c) 2024-2026 Kamran Ashraf.