LabelGrid Komut Satırı Aracı (CLI)

Temmuz 2026’da güncellendi.

LabelGrid, hesabınızla doğrudan terminalden veya bir betikten çalışabilmeniz için resmi bir komut satırı aracı yayımlar. Bu araç @labelgrid/cli adlı npm paketidir ve kurulduğunda makinenize bir labelgrid komutu ekler.

CLI, LabelGrid herkese açık API’sinin ince bir sarmalayıcısıdır: aynı doğrulama, aynı izinler. Her komut bir API çağrısına karşılık gelir; bu nedenle API’nin reddettiği her şeyi CLI de tam olarak aynı şekilde reddeder ve hiçbir CLI komutu jetonunuzun yetkisi dışında bir işi yapamaz. CLI, API’nin yayımladığı her uç noktayı değil, aşağıda listelenen komut gruplarını kapsar; API’nin henüz karşılık gelen bir komutu bulunmayan bir köşesi için uç noktayı doğrudan çağırın. Bir yapay zeka asistanıyla gündelik dilde çalışmayı tercih ediyorsanız, LabelGrid aynı API üzerine kurulu bir MCP sunucusu da yayımlar.

Neler yapabilirsiniz

Komutlar gruplar halinde düzenlenmiştir. Terminalinizden şunları yapabilirsiniz:

• auth — oturum açma, oturum kapatma, hangi hesapla oturum açtığınızı görme ve bir jetonu iptal etme
• catalog — etiketleri, sanatçıları, söz yazarlarını, yayıncıları, yayınları ve parçaları arama, görüntüleme, oluşturma, güncelleme ve silme
• release — bir yayını doğrulama, dağıtıma gönderme, kaldırma, incelemeyi onaylama, açılış sayfasını ve kısa bağlantısını yönetme
• upload — ses, kapak görseli, şarkı sözü ve hareketli kapak ekleme (her tür yalnızca kendi izin verilen dosya uzantılarını kabul eder)
• download, asset, license — dosyaları alma ve lisansları yönetme
• statement, transactions, royalties, analytics — ekstreleri, işlemleri, telif geliri dökümlerini ve akış analizlerini çekme
• review — inceleme sorunlarını görüntüleme, kalite raporlarını okuma ve not ekleme
• webhook — asenkron bildirimler için webhook kaydetme ve yönetme
• beatport — Beatport etkinleştirmesini yönetme

---

Neye ihtiyacınız var

1. API erişimi olan bir LabelGrid hesabı. API erişimi, LabelGrid’in API planlarının bir parçasıdır; nasıl edineceğiniz için bkz. API’ye Genel Bakış.
2. Bir API jetonu. LabelGrid panonuzda Profil → API Jetonları altından oluşturun.
3. CLI’yi çalıştıracağınız bilgisayarda Node.js 20 veya üzeri.

---

Kurulum

CLI’yi npm ile global olarak kurun:

npm install -g @labelgrid/cli

Bu, labelgrid komutunu ekler. Kurulumun başarılı olduğunu şöyle doğrulayın:

labelgrid --version

---

Kimlik doğrulama

CLI, API jetonunuza ihtiyaç duyar. Jetonu şu üç yerde, bu sırayla arar:

1. LABELGRID_API_TOKEN ortam değişkeni — betikler ve CI için en uygunu; değer, CI sağlayıcınızın gizli bilgi deposundan gelir.
2. labelgrid auth login ile bir kez kaydettiğiniz saklanmış kimlik bilgisi. macOS’ta bu Anahtar Zinciri’nde tutulur; diğer sistemlerde ~/.config/labelgrid/ altında izinleri kısıtlanmış bir dosyaya kaydedilir.
3. Tek bir komuta eklenen --token bayrağı — en son başvurulacak seçenek.

Kendi makinenizde en güvenli yol, jetonu bir kez saklamaktır. labelgrid auth login komutunu argümansız çalıştırın; jetonu girişi gizlenmiş biçimde yapıştırmanızı ister, böylece değer ne ekranda ne de kabuk geçmişinizde görünür:

labelgrid auth login

Sonraki her komut saklanan kimlik bilgisini yeniden kullanır; jetonu bir daha hiç yazmanız gerekmez:

labelgrid auth whoami

Dikkat

Jetonu doğrudan komut satırına yazmaktan kaçının; ne bir --token değeri olarak ne de export LABELGRID_API_TOKEN=... içinde. Yazdığınız her şey kabuk geçmişi dosyanıza kaydedilir ve komut satırı argümanları, aynı makinedeki diğer kullanıcılara işlem listesi üzerinden görünür. Tercihen labelgrid auth login kullanın; CI’da ise LABELGRID_API_TOKEN değerini bir betiğin içine yazmak yerine sağlayıcının gizli bilgi deposundan enjekte edin.

Hiçbir şeyin soru soramayacağı gözetimsiz kurulumlarda jetonu argüman olarak geçirmek yerine, bir gizli bilgi yöneticisinden labelgrid auth login komutuna aktarın:

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

CLI jeton değerlerini hiçbir zaman ekrana yazdırmaz. Erişimi durdurmak için labelgrid auth logout ile oturumu kapatın — bu, saklanan kimlik bilgisini o makineden kaldırır — ya da jetonu panonuzdan iptal edin; iptal, o jetonun her yerde çalışmasını anında durdurur. Hesabınızdaki diğer jetonlar çalışmayı sürdürür; kullanımdan kaldırmak istediğiniz her jetonu ayrı ayrı iptal edin.

Not

Jetonları panonuzda Profil → API Jetonları altından oluşturup yönetin. Bu sayfayı göremiyorsanız hesabınızın henüz API erişimi yok demektir; bkz. API’ye Genel Bakış.

---

Çıktı ve çıkış kodları

CLI varsayılan olarak temiz, insan tarafından okunabilir bir çıktı verir. Betik yazarken herhangi bir komuta --json ekleyin; ham API yanıtını yazdırır ve başka araçlara aktarabilirsiniz:

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

Komutlar standart çıkış kodları döndürür; böylece betikleriniz sonuca göre davranabilir:

Çıkış kodu	Anlamı
0	Başarılı
1	API hatası (istek LabelGrid’e ulaştı ve reddedildi)
2	Kullanım hatası (komutun kendisinde bir hata var)

---

Güvenlik

Kesin sonuç doğuran ve geri alınamayan komutlar, hiçbir şey gönderilmeden önce onay ister. Bir yayını dağıtıma gönderme, bir yayını kaldırma, incelemeyi onaylama, katalog ögelerini silme ve Beatport’u etkinleştirme işlemlerinin tümünde CLI, herhangi bir API çağrısı yapmadan önce onaylamanız için y yazmanızı ister.

Klavye başında kimsenin olmadığı otomasyonlarda, istemi atlamak için --yes ekleyin:

labelgrid release distribute REL123 --yes

Hesabınıza ilişkin tüm korumalar (doğrulama, plan limitleri ve hız sınırları) LabelGrid’in sunucularında uygulanır; dolayısıyla CLI’yi nasıl çalıştırırsanız çalıştırın bunları aşamaz.

---

Sorun giderme

• command not found: labelgrid — global kurulum tamamlanmamış veya PATH üzerinde değil. npm install -g @labelgrid/cli komutunu yeniden çalıştırın ve node --version ile Node.js 20 veya üzerini doğrulayın.
• Jeton geçersiz veya reddedildi — jetonu panonuzda Profil → API Jetonları altından yeniden oluşturun, ardından labelgrid auth login ile yeniden saklayın.
• “API Jetonları” sayfasını göremiyorsunuz — hesabınızın henüz API erişimi yok. Nasıl etkinleştireceğiniz için bkz. API’ye Genel Bakış.
• Bir komut betikte başarısız oluyor — çıkış kodunu kontrol edin (1 API hatası, 2 kullanım hatasıdır) ve tam yanıtı okumak için aynı komutu --json ile yeniden çalıştırın.

---

SSS

”LabelGrid’in bir komut satırı aracı var mı?”

Evet. LabelGrid, resmi CLI’yi @labelgrid/cli adlı npm paketi olarak yayımlar. npm install -g @labelgrid/cli komutuyla kurulur ve terminalinize bir labelgrid komutu ekler. Node.js 20 veya üzerini gerektirir ve LabelGrid herkese açık API’sinin ince bir sarmalayıcısıdır.

”Bununla neler yapabilirim?”

Oturum açma ve jeton yönetimi; etiketleri, sanatçıları, söz yazarlarını, yayıncıları, yayınları ve parçaları arama, görüntüleme, oluşturma, güncelleme ve silme; ses, kapak görseli, şarkı sözü ve hareketli kapak yükleme; yayınları doğrulama, dağıtıma gönderme ve kaldırma; ekstreleri, işlemleri, telif gelirlerini ve akış analizlerini çekme; inceleme sorunlarını ve kalite raporlarını görüntüleme; webhook’ları ve Beatport etkinleştirmesini yönetme.

”CLI’de kimlik doğrulamayı nasıl yaparım?”

Bir LabelGrid API jetonuyla. CLI jetonu şu üç yerde, bu sırayla arar: LABELGRID_API_TOKEN ortam değişkeni, ardından labelgrid auth login ile saklanan kimlik bilgisi, ardından --token bayrağı. Tercihen labelgrid auth login kullanın; bu komut jetonu girişi gizlenmiş biçimde ister, böylece değer kabuk geçmişinize veya işlem listesine hiç ulaşmaz. CLI jeton değerlerini hiçbir zaman ekrana yazdırmaz.

”Bir API planına ihtiyacım var mı?”

Evet. CLI, LabelGrid herkese açık API’si üzerinden bağlanır; bu nedenle hesabınızın API erişimi olmalıdır ve API erişimi LabelGrid’in API planlarının bir parçasıdır. Erişimi nasıl edineceğiniz için bkz. API’ye Genel Bakış.

”CLI ile MCP sunucusu arasındaki fark nedir?”

İkisi de aynı herkese açık API üzerine kurulu resmi LabelGrid araçlarıdır. CLI terminaliniz ve betikleriniz içindir; MCP sunucusu ise API çağrılarını sizin yerinize gündelik dille yapan Claude ve Cursor gibi yapay zeka asistanları içindir. İş akışınıza hangisi uyuyorsa onu, isterseniz her ikisini birden kullanın.

---

İlgili

• API’ye Genel Bakış ve Hızlı Başlangıç — API erişimini nasıl edinir ve kimlik doğrulamayı nasıl yaparsınız
• Yapay Zeka Asistanınızı LabelGrid’e Bağlayın (MCP) — aynı işlemler, gündelik dille
• Webhook’lar — asenkron olay bildirimleri
• npm üzerinde @labelgrid/cli
• GitHub’daki belgeler — CLI referansı packages/cli altında

Bir yapay zeka aracısı için yayın akışı mı kuruyorsunuz?

GitHub projesi ayrıca, bir yapay zeka asistanına MCP sunucusu ve CLI’yi kullanarak yayın iş akışının tamamını öğreten hazır bir aracı becerisi (agent skill) içerir; bkz. skills/labelgrid-release.

---

Yardıma mı ihtiyacınız var?

CLI hakkında sorularınız varsa destek ekibimizle iletişime geçin.