Trader Joe's Web Product Availability Community Overlay

WHAT IT DOES

This tool enables the Trader Joe's community to share real-time product availability information. It reads product data from Trader Joe's product pages including the product name, description, price, and dietary attributes (gluten-free, vegan, organic). The panel displays a crowd-sourced availability status—In Stock, Low Stock, or Out of Stock—based on community reports from local stores. Users can report current availability at their store with one-click buttons, building a shared knowledge base. An availability score (0-100%) shows the community consensus on whether the product is findable. The panel also shows the last report time and a history of recent reports, helping shoppers know what to expect before visiting.

WHERE IT RUNS

The script activates on Trader Joe's product pages (traderjoes.com), including product detail views and product listings. It automatically detects product data using multiple extraction strategies that work across different Trader Joe's page layouts. The panel appears as a draggable overlay that stays accessible as you browse products.

HOW TO USE

Navigate to a Trader Joe's product page. The panel will appear showing the current community availability status for that product. If no reports exist, you'll be prompted to be the first to report. Click "In Stock", "Low Stock", or "Out of Stock" to submit your report for your store. Your store location and nickname are saved in settings and automatically included with each report. The panel shows the availability score based on recent reports, the number of community reports, and a history of the last 10 reports with timestamps. The "Refresh" button updates the product data, and "Reset Data" clears all availability reports for the current product. Your store location and nickname can be configured in the panel settings.

THE TECHNICAL MECHANISM

The script uses a per-product storage system with GM_setValue, keyed by product ID. When a user reports availability, the report (status, store name, nickname, timestamp) is appended to the product's report history. The current availability status is calculated by aggregating the last 10 reports—the most common status becomes the displayed status. The availability score is a weighted average of recent reports: In Stock = 100, Low Stock = 50, Out of Stock = 0, providing a percentage confidence score. Reports are limited to 50 per product to manage storage size, and old reports are automatically trimmed. Product identification uses multiple strategies: extracting the numeric product ID from the URL, checking meta tags (product:retailer_item_id), looking for data-product-id attributes, or falling back to a hash of the product name. Dietary attributes are extracted from badges, tags, and text scanning for vegan, gluten-free, and organic keywords. Each product's data is isolated by its unique ID, allowing independent tracking across the product catalog. All user settings (store name, nickname) are persisted globally and applied to all reports.

THE PANEL

The panel is fully draggable by its header and remembers its position on the page across sessions. It can be collapsed to a small bubble using the minimize button, then restored by clicking the bubble. The panel resizes automatically to fit its content and can be closed with the Escape key or by clicking the close button. The panel's position and state persist globally, so it returns to the same location on subsequent visits.

PLEASE NOTE

Requires the free BotGentz extension to run. Trader Joe's may update its site structure, which could affect the script's ability to detect product data — updates will be released as needed. All availability data is stored locally in your browser and is never transmitted externally. This tool is community-driven and relies on user reports; availability information is not official and may not reflect current store inventory. The script does not modify your Trader Joe's account or perform any transactions. Always check with your local store for the most accurate availability information. The script provides a convenience layer for community sharing and should not be relied upon for critical shopping decisions.