LabelGrids kommandoradsverktyg (CLI)

Q: Har LabelGrid ett kommandoradsverktyg?

Ja. LabelGrid publicerar ett officiellt kommandoradsverktyg som npm-paketet @labelgrid/cli. Installera det med npm install -g @labelgrid/cli, så läggs kommandot labelgrid till i din terminal. Det kräver Node.js 20 eller senare. CLI:t är ett tunt skal runt LabelGrids publika API, så det arbetar med samma katalog, filer, analys och distributionsåtgärder som API:et erbjuder.

Q: Vad kan jag göra med LabelGrids CLI?

Du kan logga in och hantera tokens; söka efter, visa, skapa, uppdatera och radera skivbolag, artister, låtskrivare, förlag, releaser och spår; ladda upp ljud, omslag, låttexter och rörligt omslag; validera releaser, skicka in dem för distribution och ta ner dem; hämta utdrag, transaktioner, royalties och streaminganalys; visa granskningsanmärkningar och kvalitetsrapporter; hantera webhooks; och hantera aktivering av Beatport. Allt som LabelGrids publika API tillåter kan CLI:t göra, och allt som API:et avvisar avvisar CLI:t på samma sätt.

Q: Hur autentiserar jag CLI:t?

CLI:t använder en LabelGrid API-token. Det letar efter token på tre ställen, i tur och ordning: miljövariabeln LABELGRID_API_TOKEN, sedan en inloggningsuppgift som du sparar med labelgrid auth login (i din macOS-nyckelring, eller i en behörighetsbegränsad fil under ~/.config/labelgrid på andra system), och sedan flaggan --token. CLI:t skriver aldrig ut tokenvärden.

Q: Vad skiljer CLI:t från MCP-servern?

Båda är officiella LabelGrid-verktyg byggda på samma publika API. CLI:t är till för din terminal och dina skript, där du skriver kommandon eller kör dem i automatisering. MCP-servern är till för AI-assistenter som Claude och Cursor, som gör API-anropen åt dig utifrån vanligt språk. Använd det som passar ditt arbetssätt, eller båda.

Uppdaterad juli 2026.

LabelGrid publicerar ett officiellt kommandoradsverktyg så att du kan arbeta med ditt konto direkt från terminalen eller från ett skript. Det är npm-paketet @labelgrid/cli, och när du installerar det läggs kommandot labelgrid till på din dator.

CLI:t är ett tunt skal runt LabelGrids publika API: samma yta, samma validering och samma behörigheter. Allt som det publika API:et tillåter kan CLI:t göra, och allt som API:et avvisar avvisar CLI:t på exakt samma sätt. Vill du hellre arbeta på vanligt språk med en AI-assistent publicerar LabelGrid även en MCP-server byggd på samma API.

Vad du kan göra

Kommandona är ordnade i grupper. Från terminalen kan du:

auth – logga in, logga ut, kontrollera vem du är inloggad som och återkalla en token
catalog – söka efter, visa, skapa, uppdatera och radera skivbolag, artister, låtskrivare, förlag, releaser och spår
release – validera en release, skicka in den för distribution, ta ner den, bekräfta granskning och hantera dess landningssida och kortlänk
upload – lägga till ljud, omslag, låttexter och rörligt omslag (varje typ accepterar bara sina tillåtna filändelser)
download, asset, license – hämta filer och hantera licenser
statement, transactions, royalties, analytics – hämta utdrag, transaktioner, royaltyuppdelningar och streaminganalys
review – visa granskningsanmärkningar, läsa kvalitetsrapporter och lägga till noteringar
webhook – registrera och hantera webhooks för asynkrona aviseringar
beatport – hantera aktivering av Beatport

Vad du behöver

Ett LabelGrid-konto med API-åtkomst. API-åtkomst ingår i LabelGrids API-planer; se API-översikt för hur du får den.
En API-token. Generera en i din LabelGrid-dashboard under Profil → API-tokens.
Node.js 20 eller senare på datorn där du kör CLI:t.

Installera

Installera CLI:t globalt med npm:

npm install -g @labelgrid/cli

Det lägger till kommandot labelgrid. Kontrollera att det fungerade med:

labelgrid --version

Autentisering

CLI:t behöver din API-token. Det letar efter en på tre ställen, i den här ordningen:

Miljövariabeln LABELGRID_API_TOKEN – bäst för skript och CI.
En sparad inloggningsuppgift som du lagrar en gång med labelgrid auth login. På macOS sparas den i din nyckelring; på andra system sparas den i en behörighetsbegränsad fil under ~/.config/labelgrid/.
Flaggan --token på ett enskilt kommando.

Peka CLI:t mot en miljövariabel:

export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Eller spara token en gång och låt CLI:t återanvända den:

labelgrid auth login

CLI:t skriver aldrig ut tokenvärden. För att stoppa åtkomsten loggar du ut med labelgrid auth logout eller återkallar token i din dashboard, vilket får effekt omedelbart.

Utdata och exitkoder

Som standard skriver CLI:t ut rent, läsbart resultat. För skript lägger du till --json på vilket kommando som helst, så skrivs det råa API-svaret ut och du kan skicka det vidare till andra verktyg:

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

Kommandona sätter standardiserade exitkoder så att dina skript kan reagera på resultatet:

Exitkod	Betydelse
`0`	Lyckades
`1`	API-fel (förfrågan nådde LabelGrid och avvisades)
`2`	Användningsfel (ett misstag i själva kommandot)

Säkerhet

Slutgiltiga och destruktiva kommandon ber dig bekräfta innan något skickas. Att skicka in en release för distribution, ta ner en release, bekräfta granskning, radera katalogposter och aktivera Beatport kräver alla att du skriver y för att bekräfta innan CLI:t gör något API-anrop.

För automatisering där ingen sitter vid tangentbordet lägger du till --yes för att hoppa över frågan:

labelgrid release distribute REL123 --yes

Alla kontoskydd, alltså validering, plangränser och hastighetsbegränsningar, upprätthålls av LabelGrids servrar, så CLI:t kan inte kringgå dem oavsett hur du kör det.

Felsökning

command not found: labelgrid – den globala installationen blev inte klar eller ligger inte i din PATH. Kör npm install -g @labelgrid/cli igen och bekräfta Node.js 20 eller senare med node --version.
Token ogiltig eller avvisad – skapa om token i din dashboard under Profil → API-tokens och sätt den sedan igen med export LABELGRID_API_TOKEN=... eller labelgrid auth login.
Du ser ingen sida för “API-tokens” – ditt konto har ännu inte API-åtkomst. Se API-översikt för hur du aktiverar den.
Ett kommando misslyckas i ett skript – kontrollera exitkoden (1 är ett API-fel, 2 är ett användningsfel) och kör samma kommando igen med --json för att läsa hela svaret.

Vanliga frågor

”Har LabelGrid ett kommandoradsverktyg?”

Ja. LabelGrid publicerar ett officiellt CLI som npm-paketet @labelgrid/cli. Installera det med npm install -g @labelgrid/cli, så läggs kommandot labelgrid till i din terminal. Det kräver Node.js 20 eller senare och är ett tunt skal runt LabelGrids publika API.

”Vad kan jag göra med det?”

Logga in och hantera tokens; söka efter, visa, skapa, uppdatera och radera skivbolag, artister, låtskrivare, förlag, releaser och spår; ladda upp ljud, omslag, låttexter och rörligt omslag; validera releaser, skicka in dem för distribution och ta ner dem; hämta utdrag, transaktioner, royalties och streaminganalys; visa granskningsanmärkningar och kvalitetsrapporter; hantera webhooks; och hantera aktivering av Beatport.

”Hur autentiserar jag CLI:t?”

Med en LabelGrid API-token. CLI:t letar efter den på tre ställen, i tur och ordning: miljövariabeln LABELGRID_API_TOKEN, sedan en inloggningsuppgift sparad med labelgrid auth login, och sedan flaggan --token. CLI:t skriver aldrig ut tokenvärden.

”Behöver jag en API-plan?”

Ja. CLI:t ansluter via LabelGrids publika API, så ditt konto behöver API-åtkomst, vilket ingår i LabelGrids API-planer. Se API-översikt för hur du får åtkomst.

”Vad skiljer CLI:t från MCP-servern?”

Båda är officiella LabelGrid-verktyg på samma publika API. CLI:t är till för din terminal och dina skript; MCP-servern är till för AI-assistenter som Claude och Cursor, som gör API-anropen åt dig utifrån vanligt språk. Använd det som passar ditt arbetssätt, eller båda.

Relaterat

API-översikt och snabbstart – hur du får API-åtkomst och autentiserar dig
Koppla din AI-assistent till LabelGrid (MCP) – samma åtgärder, på vanligt språk
Webhooks – asynkrona händelseaviseringar
@labelgrid/cli på npm
Dokumentation på GitHub – CLI-referensen finns under packages/cli

Behöver du hjälp?

Har du frågor om CLI:t? Kontakta vårt supportteam.

Använder du inte LabelGrid än?

Allt du just läste om finns på vår plattform.

Se vad LabelGrid kan göra →