LabelGrid Kommandozeilen-Tool (CLI)

Aktualisiert im Juli 2026.

LabelGrid veröffentlicht ein offizielles Kommandozeilen-Tool, damit Sie direkt vom Terminal oder aus einem Skript mit Ihrem Konto arbeiten können. Es ist das npm-Paket @labelgrid/cli, und die Installation fügt Ihrer Maschine einen labelgrid-Befehl hinzu.

Die CLI ist ein schlanker Wrapper um die öffentliche LabelGrid-API – dieselbe Oberfläche, dieselbe Validierung und dieselben Berechtigungen. Alles, was die öffentliche API erlaubt, kann die CLI; alles, was die API ablehnt, lehnt die CLI genau gleich ab. Wenn Sie lieber in natürlicher Sprache mit einem KI-Assistenten arbeiten, veröffentlicht LabelGrid auch einen MCP-Server, der auf derselben API aufbaut.

Was Sie tun können

Befehle sind in Gruppen organisiert. Von Ihrem Terminal aus können Sie:

• auth — sich anmelden, abmelden, prüfen, mit welchem Konto Sie angemeldet sind, und einen Token widerrufen
• catalog — Labels, Künstler, Autoren, Verlage, Releases und Tracks suchen, ansehen, erstellen, aktualisieren und löschen
• release — ein Release validieren, zum Vertrieb einreichen, zurückziehen, den Review bestätigen und seine Landingpage und seinen Kurzlink verwalten
• upload — Audio, Artwork, Songtexte und animiertes Artwork hinzufügen (jeder Typ akzeptiert nur seine zulässigen Dateiendungen)
• download, asset, license — Dateien abrufen und Lizenzen verwalten
• statement, transactions, royalties, analytics — Abrechnungen, Transaktionen, Royalty-Aufschlüsselungen und Streaming-Analysen abrufen
• review — Review-Beanstandungen ansehen, Qualitätsberichte lesen und Notizen hinzufügen
• webhook — Webhooks für asynchrone Benachrichtigungen registrieren und verwalten
• beatport — die Beatport-Aktivierung verwalten

---

Was Sie brauchen

1. Ein LabelGrid-Konto mit API-Zugang. API-Zugang ist Teil der API-Pläne von LabelGrid — siehe den API-Überblick, um zu erfahren, wie Sie ihn erhalten.
2. Einen API-Token. Erstellen Sie einen in Ihrem LabelGrid-Dashboard unter Profil → API-Tokens.
3. Node.js 20 oder neuer auf dem Computer, auf dem Sie die CLI ausführen.

---

Installation

Installieren Sie die CLI global mit npm:

npm install -g @labelgrid/cli

Dies fügt den Befehl labelgrid hinzu. Prüfen Sie mit folgendem Befehl, ob es geklappt hat:

labelgrid --version

---

Authentifizierung

Die CLI benötigt Ihren API-Token. Sie sucht einen an drei Stellen, in dieser Reihenfolge:

1. Die Umgebungsvariable LABELGRID_API_TOKEN — am besten für Skripte und CI.
2. Ein gespeichertes Token, das Sie einmalig mit labelgrid auth login sichern. Unter macOS wird es in Ihrem Schlüsselbund abgelegt; auf anderen Systemen in einer zugriffsbeschränkten Datei unter ~/.config/labelgrid/.
3. Die Option --token bei einem einzelnen Befehl.

Verweisen Sie die CLI auf eine Umgebungsvariable:

export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Oder speichern Sie den Token einmal und lassen Sie die CLI ihn wiederverwenden:

labelgrid auth login

Die CLI gibt Token-Werte niemals aus. Um den Zugang zu beenden, melden Sie sich mit labelgrid auth logout ab oder widerrufen Sie den Token in Ihrem Dashboard, was sofort wirksam wird.

Hinweis

Erstellen und verwalten Sie Tokens in Ihrem Dashboard unter Profil → API-Tokens. Wenn Sie diese Seite nicht sehen, hat Ihr Konto noch keinen API-Zugang — siehe den API-Überblick.

---

Ausgabe und Exit-Codes

Standardmäßig gibt die CLI eine klare, gut lesbare Ausgabe aus. Für Scripting fügen Sie einem beliebigen Befehl --json hinzu, und sie gibt die rohe API-Antwort aus, damit Sie sie an andere Tools weiterleiten können:

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

Befehle setzen standardisierte Exit-Codes, damit Ihre Skripte auf das Ergebnis reagieren können:

Exit-Code	Bedeutung
0	Erfolg
1	API-Fehler (die Anfrage erreichte LabelGrid und wurde abgelehnt)
2	Nutzungsfehler (ein Fehler im Befehl selbst)

---

Sicherheit

Endgültige und destruktive Befehle bitten Sie um Bestätigung, bevor etwas gesendet wird. Ein Release zum Vertrieb einreichen, ein Release zurückziehen, den Review bestätigen, Katalogelemente löschen und Beatport aktivieren fordern Sie alle auf, y zum Bestätigen einzugeben, bevor die CLI einen API-Aufruf macht.

Für Automatisierung, bei der niemand an der Tastatur sitzt, fügen Sie --yes hinzu, um die Abfrage zu überspringen:

labelgrid release distribute REL123 --yes

Jeder Kontoschutz — Validierung, Plan-Limits und Rate-Limits — wird von den Servern von LabelGrid durchgesetzt, sodass die CLI ihn nicht umgehen kann, wie auch immer Sie sie ausführen.

---

Fehlerbehebung

• command not found: labelgrid — die globale Installation wurde nicht abgeschlossen oder ist nicht in Ihrem PATH. Führen Sie npm install -g @labelgrid/cli erneut aus und bestätigen Sie mit node --version, dass Node.js 20 oder neuer installiert ist.
• Token ungültig oder abgelehnt — erstellen Sie den Token in Ihrem Dashboard unter Profil → API-Tokens neu und setzen Sie ihn erneut mit export LABELGRID_API_TOKEN=... oder labelgrid auth login.
• Sie sehen keine Seite „API-Tokens” — Ihr Konto hat noch keinen API-Zugang. Siehe den API-Überblick, um zu erfahren, wie Sie ihn aktivieren.
• Ein Befehl schlägt in einem Skript fehl — prüfen Sie den Exit-Code (1 ist ein API-Fehler, 2 ein Nutzungsfehler) und führen Sie denselben Befehl mit --json erneut aus, um die vollständige Antwort zu lesen.

---

FAQ

„Hat LabelGrid ein Kommandozeilen-Tool?”

Ja. LabelGrid veröffentlicht eine offizielle CLI als npm-Paket @labelgrid/cli. Installieren Sie sie mit npm install -g @labelgrid/cli, und sie fügt Ihrem Terminal einen labelgrid-Befehl hinzu. Sie benötigt Node.js 20 oder neuer und ist ein schlanker Wrapper um die öffentliche LabelGrid-API.

„Was kann ich damit machen?”

Sich anmelden und Tokens verwalten; Labels, Künstler, Autoren, Verlage, Releases und Tracks suchen, ansehen, erstellen, aktualisieren und löschen; Audio, Artwork, Songtexte und animiertes Artwork hochladen; Releases validieren, zum Vertrieb einreichen und zurückziehen; Abrechnungen, Transaktionen, Royalties und Streaming-Analysen abrufen; Review-Beanstandungen und Qualitätsberichte einsehen; Webhooks verwalten; und die Beatport-Aktivierung verwalten.

„Wie authentifiziere ich die CLI?”

Mit einem LabelGrid-API-Token. Die CLI sucht ihn an drei Stellen, in dieser Reihenfolge: die Umgebungsvariable LABELGRID_API_TOKEN, dann ein mit labelgrid auth login gespeichertes Token und schließlich die Option --token. Die CLI gibt Token-Werte niemals aus.

„Brauche ich einen API-Plan?”

Ja. Die CLI verbindet sich über die öffentliche LabelGrid-API, daher benötigt Ihr Konto API-Zugang, der Teil der API-Pläne von LabelGrid ist. Siehe den API-Überblick, um zu erfahren, wie Sie Zugang erhalten.

„Wie unterscheidet sich die CLI vom MCP-Server?”

Beide sind offizielle LabelGrid-Tools auf derselben öffentlichen API. Die CLI ist für Ihr Terminal und Ihre Skripte gedacht; der MCP-Server ist für KI-Assistenten wie Claude und Cursor gedacht, die die API in natürlicher Sprache für Sie aufrufen. Nutzen Sie, was zu Ihrem Workflow passt, oder beides.

---

Verwandte Themen

• API-Überblick — wie Sie API-Zugang erhalten und sich authentifizieren
• KI-Assistenten mit LabelGrid verbinden (MCP) — dieselben Aktionen, in natürlicher Sprache
• Webhooks — asynchrone Ereignisbenachrichtigungen
• @labelgrid/cli auf npm
• Dokumentation auf GitHub — CLI-Referenz unter packages/cli

Bauen Sie einen Release-Ablauf für einen KI-Agenten?

Das GitHub-Projekt enthält auch eine einsatzbereite Agent-Skill, die einem KI-Assistenten den gesamten Release-Ablauf mit dem MCP-Server und der CLI beibringt — siehe skills/labelgrid-release.

---

Brauchen Sie Hilfe?

Bei Fragen zur CLI kontaktieren Sie unser Support-Team.