musicbrainzlisted
Install: claude install-skill SteveGrosbois/tidal-cli
# MusicBrainz API Skill
Accède aux métadonnées musicales de la base communautaire MusicBrainz.
## Configuration
**Aucune authentification requise** pour les requêtes en lecture.
**Obligatoire** : un header `User-Agent` identifiant le client, sinon MusicBrainz peut bloquer les requêtes (ils prennent ça très au sérieux). Format recommandé :
```
User-Agent: tidal-cli/0.1 ( steve@grosbois.fr )
```
**Rate limit** : 1 requête par seconde maximum par User-Agent. Pour des séries de requêtes, ajoute un `sleep 1` entre chaque appel.
**Base URL** : `https://musicbrainz.org/ws/2/`
**Docs** : https://musicbrainz.org/doc/MusicBrainz_API
**Format** : ajouter `&fmt=json` à chaque requête (sinon XML par défaut)
## Concepts clés
MusicBrainz distingue trois types de requêtes :
| Type | Usage | Exemple |
|---|---|---|
| **Lookup** | Récupérer une entité connue par son MBID | `/artist/<mbid>` |
| **Browse** | Lister les entités liées à une autre | `/release-group?artist=<mbid>` |
| **Search** | Recherche full-text (Lucene) | `/artist?query=architects` |
Et plusieurs niveaux d'entités à comprendre :
- **artist** : un groupe ou une personne
- **release-group** : une "œuvre" abstraite (ex : l'album *Holy Hell*), indépendamment des éditions
- **release** : une édition spécifique (CD UK 2018, vinyle US 2019, deluxe Japan…)
- **recording** : un enregistrement audio précis (apparaît sur une ou plusieurs releases)
- **work** : une composition (paroles + musique), distincte de ses enregistreme