# Music Scraper Workbench (Smart Mapper) - Documentation

## Overview

The **Music Scraper Workbench** is a sophisticated, single-page web application designed to extract, analyze, and organize music metadata from web pages. Built as a self-contained HTML file, it provides a complete workbench environment for scraping album information, artist details, tracklists, and other music-related metadata from various online sources.

### Key Capabilities

- **Proxy-Based Web Browsing** - Navigate to any URL via a CORS proxy
- **Smart Content Analysis** - Intelligent extraction using configurable patterns
- **Dynamic Field Mapping** - Map discovered content to customizable data fields
- **Local Data Persistence** - Store and manage a music metadata collection
- **Export Functionality** - Output data as Excel (XLSX) or JSON

---

## Documentation Index

| Document | Description |
|----------|-------------|
| [Architecture](./docs/architecture.md) | System architecture and component structure |
| [User Interface Guide](./docs/ui-guide.md) | Complete UI walkthrough and usage instructions |
| [Content Analyzer](./docs/content-analyzer.md) | Technical details of the scraping engine |
| [Configuration Guide](./docs/configuration.md) | Customizing extraction patterns and strategies |
| [API Reference](./docs/api-reference.md) | Internal functions and component documentation |
| [Dependencies](./docs/dependencies.md) | External libraries and CDN resources |
| [Workflow Guide](./docs/workflow-guide.md) | Step-by-step usage scenarios and troubleshooting |

---

## Quick Start

1. Open `win_at_all_costs_scraper_02.html` in a modern web browser
2. Enter a URL (e.g., iTunes, Discogs, Bandcamp) in the address bar
3. Click **Go** to load the page via proxy
4. Click **Smart Scrape** to analyze the content
5. Use the **Mapper Interface** to assign extracted values to fields
6. Click **Apply Data** to populate the editor form
7. Click **Save to DB** to store the entry locally

---

## System Requirements

- Modern web browser (Chrome, Firefox, Safari, Edge)
- JavaScript enabled
- Internet connection (for proxy access and CDN resources)
- LocalStorage enabled (for data persistence)

---

## Version

- **Current Version:** 2.0 (win_at_all_costs_scraper_02.html)
- **Codename:** Smart Mapper