Outil en ligne de commande de LabelGrid (CLI)

Mis à jour en juillet 2026.

LabelGrid publie un outil en ligne de commande officiel pour que vous puissiez travailler avec votre compte directement depuis le terminal ou depuis un script. C’est le paquet npm @labelgrid/cli, et son installation ajoute une commande labelgrid à votre machine.

La CLI est un wrapper léger autour de l’API publique de LabelGrid : la même surface, la même validation et les mêmes autorisations. Tout ce que l’API publique permet, la CLI peut le faire ; tout ce que l’API refuse, la CLI le refuse exactement de la même façon. Si vous préférez travailler en langage naturel avec un assistant IA, LabelGrid publie aussi un serveur MCP bâti sur la même API.

Ce que vous pouvez faire

Les commandes sont organisées en groupes. Depuis votre terminal, vous pouvez :

• auth — vous connecter, vous déconnecter, vérifier avec quel compte vous êtes connecté et révoquer un token
• catalog — rechercher, consulter, créer, mettre à jour et supprimer des labels, artistes, auteurs, éditeurs, sorties et pistes
• release — valider une sortie, la soumettre à la distribution, la retirer, confirmer la revue et gérer sa page de destination et son lien court
• upload — ajouter de l’audio, des pochettes, des paroles et des pochettes animées (chaque type n’accepte que ses extensions de fichier autorisées)
• download, asset, license — récupérer des fichiers et gérer des licences
• statement, transactions, royalties, analytics — récupérer relevés, transactions, détails des royalties et statistiques de streaming
• review — consulter les problèmes de revue, lire les rapports de qualité et ajouter des notes
• webhook — enregistrer et gérer les webhooks pour les notifications asynchrones
• beatport — gérer l’activation de Beatport

---

Ce qu’il vous faut

1. Un compte LabelGrid avec accès API. L’accès API fait partie des plans API de LabelGrid — voir l’aperçu de l’API pour savoir comment l’obtenir.
2. Un token d’API. Générez-en un dans votre tableau de bord LabelGrid sous Profil → Tokens API.
3. Node.js 20 ou une version plus récente sur l’ordinateur où vous exécutez la CLI.

---

Installation

Installez la CLI globalement avec npm :

npm install -g @labelgrid/cli

Cela ajoute la commande labelgrid. Vérifiez que tout fonctionne avec :

labelgrid --version

---

Authentification

La CLI a besoin de votre token d’API. Elle en cherche un à trois endroits, dans cet ordre :

1. La variable d’environnement LABELGRID_API_TOKEN — idéale pour les scripts et la CI.
2. Un identifiant enregistré que vous stockez une fois avec labelgrid auth login. Sur macOS, il est conservé dans votre trousseau ; sur les autres systèmes, il est enregistré dans un fichier à permissions restreintes sous ~/.config/labelgrid/.
3. L’option --token sur une commande individuelle.

Pointez la CLI vers une variable d’environnement :

export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Ou enregistrez le token une fois et laissez la CLI le réutiliser :

labelgrid auth login

La CLI n’affiche jamais la valeur du token. Pour couper l’accès, déconnectez-vous avec labelgrid auth logout ou révoquez le token depuis votre tableau de bord, ce qui prend effet immédiatement.

Note

Générez et gérez les tokens dans votre tableau de bord sous Profil → Tokens API. Si vous ne voyez pas cette page, votre compte n’a pas encore d’accès API — voir l’aperçu de l’API.

---

Sortie et codes de sortie

Par défaut, la CLI affiche une sortie claire et lisible. Pour le scripting, ajoutez --json à n’importe quelle commande et elle affiche la réponse brute de l’API afin que vous puissiez la transmettre à d’autres outils :

labelgrid catalog search releases --query "summer" --json

Les commandes définissent des codes de sortie standard pour que vos scripts puissent réagir au résultat :

Code de sortie	Signification
0	Succès
1	Erreur de l’API (la requête a atteint LabelGrid et a été refusée)
2	Erreur d’usage (une erreur dans la commande elle-même)

---

Sécurité

Les commandes finales et destructrices vous demandent de confirmer avant tout envoi. Soumettre une sortie à la distribution, retirer une sortie, confirmer la revue, supprimer des éléments du catalogue et activer Beatport vous demandent tous de saisir y pour confirmer avant que la CLI ne fasse le moindre appel à l’API.

Pour l’automatisation où personne n’est au clavier, ajoutez --yes pour sauter la confirmation :

labelgrid release distribute REL123 --yes

Chaque protection du compte — validation, limites du plan et limites de débit — est appliquée par les serveurs de LabelGrid ; la CLI ne peut donc pas les contourner, quelle que soit la façon dont vous l’exécutez.

---

Dépannage

• command not found: labelgrid — l’installation globale ne s’est pas terminée ou n’est pas dans votre PATH. Relancez npm install -g @labelgrid/cli et vérifiez Node.js 20 ou une version plus récente avec node --version.
• Token invalide ou refusé — recréez le token dans votre tableau de bord sous Profil → Tokens API, puis définissez-le à nouveau avec export LABELGRID_API_TOKEN=... ou labelgrid auth login.
• Vous ne voyez pas de page « Tokens API » — votre compte n’a pas encore d’accès API. Voir l’aperçu de l’API pour savoir comment l’activer.
• Une commande échoue dans un script — vérifiez le code de sortie (1 est une erreur de l’API, 2 une erreur d’usage) et relancez la même commande avec --json pour lire la réponse complète.

---

FAQ

« LabelGrid propose-t-il un outil en ligne de commande ? »

Oui. LabelGrid publie une CLI officielle sous forme du paquet npm @labelgrid/cli. Installez-la avec npm install -g @labelgrid/cli et elle ajoute une commande labelgrid à votre terminal. Elle nécessite Node.js 20 ou une version plus récente et est un wrapper léger autour de l’API publique de LabelGrid.

« Que puis-je faire avec ? »

Vous connecter et gérer des tokens ; rechercher, consulter, créer, mettre à jour et supprimer des labels, artistes, auteurs, éditeurs, sorties et pistes ; importer de l’audio, des pochettes, des paroles et des pochettes animées ; valider des sorties, les soumettre à la distribution et les retirer ; récupérer relevés, transactions, royalties et statistiques de streaming ; consulter les problèmes de revue et les rapports de qualité ; gérer les webhooks ; et gérer l’activation de Beatport.

« Comment authentifier la CLI ? »

Avec un token d’API LabelGrid. La CLI le cherche à trois endroits, dans cet ordre : la variable d’environnement LABELGRID_API_TOKEN, puis un identifiant enregistré avec labelgrid auth login, et enfin l’option --token. La CLI n’affiche jamais la valeur du token.

« Ai-je besoin d’un plan API ? »

Oui. La CLI se connecte via l’API publique de LabelGrid, votre compte a donc besoin d’un accès API, qui fait partie des plans API de LabelGrid. Voir l’aperçu de l’API pour savoir comment obtenir l’accès.

« Quelle est la différence entre la CLI et le serveur MCP ? »

Les deux sont des outils officiels de LabelGrid sur la même API publique. La CLI est destinée à votre terminal et à vos scripts ; le serveur MCP est destiné aux assistants IA comme Claude et Cursor, qui appellent l’API pour vous en langage naturel. Utilisez celui qui convient à votre workflow, ou les deux.

---

Voir aussi

• Aperçu de l’API — comment obtenir l’accès API et s’authentifier
• Connectez votre assistant IA à LabelGrid (MCP) — les mêmes actions, en langage naturel
• Webhooks — notifications d’événements asynchrones
• @labelgrid/cli sur npm
• Documentation sur GitHub — référence de la CLI sous packages/cli

Vous construisez un flux de sortie pour un agent IA ?

Le projet GitHub inclut aussi une skill d’agent prête à l’emploi qui enseigne à un assistant IA tout le flux de sortie avec le serveur MCP et la CLI — voir skills/labelgrid-release.

---

Besoin d’aide ?

Pour toute question sur la CLI, contactez notre équipe support.