Vinyl Record Marketplace Condition Grade Explainer

WHAT IT DOES

Vinyl Record Marketplace Condition Grade Explainer scans the current page for vinyl record listings, extracting album titles, artists, condition grades (media and sleeve), prices, and seller information from marketplace pages (Discogs, eBay, etc.). The floating panel displays a condition grade explainer showing the Goldmine grading standard (Mint, Near Mint, Very Good Plus, Very Good, Good, Poor) with visual indicators and detailed descriptions. Grade comparison across listings highlights the best condition-to-price ratio. Add custom condition notes and grading assessments. Export condition grade data as CSV or text for collection management.

WHERE IT RUNS

Works on any vinyl marketplace page, including Discogs, eBay, MusicStack, and other record selling platforms. The script detects record listings using common selectors and can also fall back to general item cards. It works best on pages with structured listings containing artist, title, grade, and price information.

HOW TO USE

The panel shows a Goldmine grade guide with expandable descriptions for each grade (Mint to Poor). The listings section displays all detected records with media and sleeve grades, prices, and sellers. Click "Scan Listings" to detect records from the current page. The best value listing is highlighted with a star badge based on condition-to-price ratio. Click the "📖" button on any listing to see the full grade description. Add condition notes to any record for personal tracking. Export the data as text for collection management or research.

MECHANISM — GOLDMINE GRADE PARSING WITH MEDIA/SLEEVE SEPARATION

The script extracts vinyl listings using a multi-strategy approach. It first attempts to find listing containers using common marketplace selectors (.listing, .item, .product). From each container, it extracts artist, title, price, seller, and grade text using targeted sub-selectors. The grade parser handles Goldmine standard grades (Mint, Near Mint, Very Good Plus, Very Good, Good, Poor) and common abbreviations (M, NM, VG+, VG, G, P). It also detects separate media and sleeve grades when both are present. Each grade is mapped to a value score (10 to 2) for comparison. The condition-to-price ratio is calculated as grade value / price, helping identify the best value listings. The grade guide provides detailed descriptions for each grade level, including media and sleeve-specific condition notes.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings and condition notes are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted record data, condition notes, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only album titles, artists, grades, prices, seller information, and user-entered notes from publicly visible page content. Listing detection depends on the page structure; if records are not detected, use the "Scan Listings" button to refresh extraction. The grade guide is for reference only and does not replace professional grading standards. Data persists across browser sessions and is isolated per browser profile.