Metadata-Version: 2.4
Name: artistscraper
Version: 1.2.0
Summary: Fetch artists from YouTube Music and Spotify with MusicBrainz IDs
License: MIT
License-File: LICENSE
Keywords: spotify,youtube-music,musicbrainz,lidarr,music,artists,scraper
Author: lennarddevries
Author-email: lennard.devries@me.com
Requires-Python: >=3.12
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Environment :: Console
Classifier: Typing :: Typed
Requires-Dist: musicbrainzngs (>=0.7.1)
Requires-Dist: python-dotenv (>=1.0.0)
Requires-Dist: requests (>=2.31.0)
Requires-Dist: rich (>=13.7.0)
Requires-Dist: spotipy (>=2.23.0)
Requires-Dist: typer (>=0.12.0)
Requires-Dist: ytmusicapi (>=1.11.2,<2.0.0)
Project-URL: Homepage, https://github.com/lennarddevries/artistscraper
Project-URL: Issues, https://github.com/lennarddevries/artistscraper/issues
Project-URL: Repository, https://github.com/lennarddevries/artistscraper
Description-Content-Type: text/markdown

# Artist Scraper

[![Build](https://github.com/lennarddevries/artistscraper/actions/workflows/ci.yml/badge.svg)](https://github.com/lennarddevries/artistscraper/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/artistscraper.svg)](https://pypi.org/project/artistscraper/) [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow?logo=buy-me-a-coffee)](https://www.buymeacoffee.com/lennarddevries)

A production-ready tool to fetch artists from YouTube Music and Spotify, look up their MusicBrainz IDs, and optionally add them to Lidarr for monitoring.

## Features

- Fetch artists from **Spotify** (liked tracks, followed artists, playlists) and **YouTube Music** (liked videos, subscriptions, playlists)
- Look up MusicBrainz IDs for all artists
- Track play counts and export to CSV
- Import to Lidarr with optional filtering by play count
- Beautiful CLI with progress bars and clear feedback

## Quick Start

```bash
# Install
pip install artistscraper

# Create config file
artistscraper print-config > config.json

# Edit config.json with your API credentials

# Run
artistscraper scrape
```

## Documentation

📚 **[Full Documentation](https://lennarddevries.github.io/artistscraper/)** - Installation, configuration, usage guides

🛠️ **[Developer Wiki](https://github.com/lennarddevries/artistscraper/wiki)** - Contributing, development setup, architecture

## License

MIT License - see the LICENSE file for details.

