Shipping Cost Note Tracker

WHAT IT DOES

Shipping Cost Note Tracker is a browser extension that automatically scans the current webpage for shipping cost elements, delivery options, and shipping-related text. It detects shipping information by examining class names, IDs, data attributes, and text patterns that contain shipping-related keywords like "shipping", "delivery", "freight", "postage", or "carrier". For every detected shipping element, the extension adds a floating "track shipping" button (🚚) right next to it. Clicking this button opens a panel where you can capture the shipping cost, carrier name, delivery time estimate, and add custom notes about shipping terms, restrictions, conditions, or any other relevant details. The extension maintains a complete shipping cost database per product or URL, with full price history, carrier details, delivery estimates, and notes for each shipping option. The main panel displays all tracked shipping options, showing the latest cost, entry count, and any notes. Cost changes are highlighted and the extension calculates and displays the best and worst shipping options based on historical data, helping you make informed decisions. All data is stored locally in your browser using GM_setValue, ensuring your shipping intelligence persists across page reloads and browser sessions.

WHERE IT RUNS

This extension runs on any webpage that displays shipping costs or delivery information – including e-commerce websites, online marketplaces, retail stores, checkout pages, shipping calculators, and any other page showing shipping options or costs. It works wherever there is visible shipping information on the page. The extension intelligently adapts to different page structures and supports a wide range of common shipping display patterns. No manual configuration is required per site; the extension automatically detects shipping elements using a flexible pattern matching system. This makes it ideal for tracking shipping costs across multiple retailers, comparing delivery options, and analyzing shipping trends over time.

HOW TO USE

Simply install the extension and navigate to any product page, checkout page, or website showing shipping information. The extension automatically detects shipping elements and places a small "track shipping" button (🚚) next to each one. Click any of these buttons to open the tracking panel with shipping cost, carrier, and delivery time pre-filled. Add a note about shipping restrictions, conditions, tracking availability, or any other relevant detail, then click "Log Shipping Cost" to save it. A floating button (📦) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all tracked shipping options, sorted by most recent entry, with carrier name, latest cost, entry count, and latest note displayed. Click any shipping card to view detailed history, including all logged entries with timestamps, costs, delivery times, and notes. The detail view also shows the best and worst shipping costs for that option. Use the "Track Current Page Shipping" button to quickly log shipping from the current page, or "Add Manually" to enter shipping details for an option you're not currently viewing. The "Clear All Shipping Data" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies shipping information with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common shipping-related class patterns, IDs, and data attributes like "shipping", "delivery", "freight", "postage", and "carrier". Second, it uses a TreeWalker to examine text nodes for shipping-related text patterns, capturing shipping costs that may not be wrapped in typical shipping elements. The cost extraction algorithm parses currency values using pattern matching and handles "Free" shipping as zero cost. The carrier detection uses a weighted keyword matching system against a list of common carriers, while delivery time extraction uses regex patterns to identify time periods like "3 days" or "2 business weeks". Each tracked shipping option is assigned a unique ID based on a hash of the product URL and carrier name, ensuring that history stays correctly associated even when pages use different query strings. A MutationObserver detects dynamic content updates and re-scans only when new shipping elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The shipping tracking panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during checkout or research. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The shipping list and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your checkout or research workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause shipping detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all shipping data, cost history, timestamps, carrier details, delivery times, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. You are responsible for backing up your shipping tracking data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any payment processing, checkout functionality, or shipping system data – it operates solely on the static page content and stores only metadata (costs, carriers, delivery times, and notes) that you explicitly create. Use this tool responsibly for personal shipping cost tracking and analysis.