Amazon Lightning Deal Notifier

WHAT IT DOES

This script transforms Amazon's Lightning Deals page into an interactive deal-tracking dashboard. When you visit the Lightning Deals page, the script identifies each deal card and extracts key information: product title, current price, original price, discount percentage, claim percentage (how many have already claimed the deal), and time remaining. It adds a live countdown timer to each deal showing hours, minutes, and seconds remaining. Deals are color-coded based on claim urgency—green for less than 50% claimed, yellow for 50-80% claimed, and red for over 80% claimed—so you can instantly spot deals that are about to sell out. A summary banner at the top shows total deals, how many are over 80% claimed, and how many are expiring soon. The script also includes a notification system: you set a claim threshold and a time threshold, and the script sends a desktop notification when any deal crosses those thresholds, ensuring you never miss a deal that's running out.

WHERE IT RUNS

The script runs on all major Amazon domains, including .com, .co.uk, .ca, .de, .fr, .it, .es, .com.au, and .co.jp. It works on the Lightning Deals page (/gp/lightning-deals/, /deals/, or /lightning-deals). It handles both desktop and mobile views, and updates dynamically as new deals load via scrolling.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Enable deal tracking" toggle enables or disables the script.

- Set a claim threshold (percentage) in the input field. When a deal's claim percentage reaches this threshold, you'll receive a notification.

- Set a time threshold (minutes). When a deal's remaining time drops below this threshold, you'll receive a notification.

- Click "Refresh deals" to manually re-scan the page for new deals.

- Click "Clear notifications" to reset the notification history so previously notified deals can trigger again.

The script works automatically—just visit the Lightning Deals page and the countdowns, badges, and color-coding will appear. Notifications are triggered in the background when thresholds are crossed.

TECHNICAL SECTION — REAL MECHANISM

The script detects Lightning Deals pages by checking the URL for patterns like /gp/lightning-deals/, /deals/, or /lightning-deals. It finds deal cards using selectors such as .deal-container, .deal-card, .dealTile, and [data-deal-id]. For each deal, the script extracts the title from .a-link-normal elements, the deal ID from data attributes or ASINs in URLs, and prices from .a-price elements (the lowest price is the current price, the highest is the original price). The discount percentage is calculated from these prices. The claim percentage is extracted from text like "X% claimed" found in .claimed-text or .percent-claimed elements, or by scanning the full text content. Time remaining is parsed from text like "2h 30m" or "3d 4h" using a regex that extracts days, hours, minutes, and seconds. The parsed time is stored as an end timestamp (Date.now() + remaining seconds). A countdown timer element is inserted next to each deal title using style properties and textContent (never innerHTML). All timers are updated every second using setInterval, recalculating remaining time from the stored end timestamp. The color-coding is applied via border-left styles, with colors determined by claim percentage thresholds. Notifications are triggered by comparing current claim percentages and remaining time against user-configured thresholds; each deal is tracked using a notifiedDeals object keyed by deal ID to prevent duplicate notifications. A summary banner is generated by counting deals and their attributes, displayed at the top of the page.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. Amazon frequently updates its Lightning Deals page structure, which may break the selectors used to find deals and extract data. If the script stops working, please check for updates. Notifications require the GM_notification grant and will only work if the BotGentz extension supports desktop notifications. The script stores only the enabled state, claim threshold, and time threshold via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.