Ai-je besoin d'un plan API pour utiliser la CLI ?

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. Consultez l'aperçu de l'API pour savoir comment obtenir l'accès. Il vous faut aussi un token d'API et Node.js 20 ou une version plus récente.

Outil en ligne de commande de LabelGrid (CLI)

Q: LabelGrid propose-t-il un outil en ligne de commande ?

Oui. LabelGrid publie un outil en ligne de commande officiel sous forme du paquet npm @labelgrid/cli. Installez-le avec npm install -g @labelgrid/cli et il ajoute une commande labelgrid à votre terminal. Il nécessite Node.js 20 ou une version plus récente. La CLI est un wrapper léger autour de l'API publique de LabelGrid, elle fonctionne donc avec les mêmes actions de catalogue, de fichiers, de statistiques et de distribution que l'API.

Q: Que puis-je faire avec la CLI de LabelGrid ?

Vous pouvez 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. Chaque commande passe par l'API publique de LabelGrid : tout ce que l'API refuse, la CLI le refuse de la même façon.

Q: Comment authentifier la CLI ?

La CLI utilise un token d'API LabelGrid. Elle le cherche à trois endroits, dans cet ordre : la variable d'environnement LABELGRID_API_TOKEN, puis un identifiant que vous enregistrez avec labelgrid auth login (dans le trousseau macOS, ou dans un fichier à permissions restreintes sous ~/.config/labelgrid sur les autres systèmes), et enfin l'option --token. Préférez labelgrid auth login, qui demande le token en masquant la saisie, afin qu'il n'atterrisse jamais dans l'historique de votre shell ni dans la liste des processus. La CLI n'affiche jamais la valeur du token.

Q: Quelle est la différence entre la CLI et le serveur MCP ?

Les deux sont des outils officiels de LabelGrid bâtis sur la même API publique. La CLI est destinée à votre terminal et à vos scripts : vous saisissez des commandes ou les exécutez en automatisation. 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.

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 validation et les mêmes autorisations. Chaque commande correspond à un appel d’API : tout ce que l’API refuse, la CLI le refuse exactement de la même façon, et aucune commande de la CLI ne peut faire ce que votre token n’a pas le droit de faire. Elle couvre les groupes de commandes listés ci-dessous, et non chaque endpoint publié par l’API ; pour un recoin de l’API qui n’a pas encore de commande correspondante, appelez directement l’endpoint. 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

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.
Un token d’API. Générez-en un dans votre tableau de bord LabelGrid sous Profil → Tokens API.
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 :

La variable d’environnement LABELGRID_API_TOKEN — idéale pour les scripts et la CI, où la valeur provient du magasin de secrets de votre fournisseur de CI.
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/.
L’option --token sur une commande individuelle — la solution de dernier recours.

Sur votre propre machine, le plus sûr est d’enregistrer le token une fois pour toutes. Lancez labelgrid auth login sans argument : la CLI vous invite à coller le token en masquant la saisie, si bien que la valeur n’apparaît ni à l’écran ni dans l’historique de votre shell :

labelgrid auth login

Chaque commande ultérieure réutilise l’identifiant enregistré : vous ne saisissez donc plus jamais le token :

labelgrid auth whoami

Pour une installation sans surveillance, où rien ne peut afficher d’invite, transmettez le token à labelgrid auth login depuis un gestionnaire de secrets au lieu de le passer en argument :

my-secret-manager read labelgrid-token | labelgrid auth login

La CLI n’affiche jamais la valeur du token. Pour couper l’accès, déconnectez-vous avec labelgrid auth logout — ce qui supprime l’identifiant enregistré sur cette machine — ou révoquez le token depuis votre tableau de bord, ce qui empêche immédiatement ce token de fonctionner partout. Les autres tokens de votre compte continuent de fonctionner ; révoquez un par un ceux que vous voulez retirer.

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 enregistrez-le à nouveau avec 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. Préférez labelgrid auth login — il demande le token en masquant la saisie, de sorte que la valeur n’atteint jamais l’historique de votre shell ni la liste des processus. 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

Besoin d’aide ?

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

Vous n’utilisez pas encore LabelGrid ?

Tout ce que vous venez de lire est disponible sur notre plateforme.

Découvrez ce que LabelGrid peut faire →