Alat Baris Perintah LabelGrid (CLI)

Q: Apakah LabelGrid punya alat baris perintah?

Ya. LabelGrid menerbitkan alat baris perintah resmi sebagai paket npm @labelgrid/cli. Pasang dengan npm install -g @labelgrid/cli dan perintah labelgrid akan tersedia di terminal Anda. Alat ini memerlukan Node.js 20 atau yang lebih baru. CLI adalah lapisan tipis di atas API publik LabelGrid, jadi ia bekerja dengan katalog, file, analitik, dan tindakan distribusi yang sama seperti yang ditawarkan API.

Q: Apa saja yang bisa saya lakukan dengan CLI LabelGrid?

Anda bisa masuk dan mengelola token; mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track; mengunggah audio, artwork, lirik, dan motion artwork; memvalidasi rilis, mengirimnya untuk distribusi, dan menariknya kembali; menarik laporan, transaksi, royalti, dan analitik streaming; melihat masalah tinjauan dan laporan kualitas; mengelola webhook; serta mengelola pengaktifan Beatport. Apa pun yang diizinkan API publik LabelGrid bisa dilakukan CLI; apa pun yang ditolak API akan ditolak CLI dengan cara yang sama.

Q: Bagaimana cara mengautentikasi CLI?

CLI memakai token API LabelGrid. Token dicari di tiga tempat secara berurutan: variabel lingkungan LABELGRID_API_TOKEN, lalu kredensial yang Anda simpan dengan labelgrid auth login (tersimpan di Keychain macOS, atau di file dengan izin terbatas di bawah ~/.config/labelgrid pada sistem lain), lalu flag --token. CLI tidak pernah mencetak nilai token.

Q: Apa bedanya CLI dengan server MCP?

Keduanya adalah alat resmi LabelGrid yang dibangun di atas API publik yang sama. CLI ditujukan untuk terminal dan skrip Anda: Anda mengetik perintah atau menjalankannya dalam otomatisasi. Server MCP ditujukan untuk asisten AI seperti Claude dan Cursor, yang memanggil API untuk Anda lewat bahasa sehari-hari. Pakai yang paling cocok dengan alur kerja Anda, atau keduanya.

Diperbarui Juli 2026.

LabelGrid menerbitkan alat baris perintah resmi agar Anda bisa mengelola akun langsung dari terminal atau dari sebuah skrip. Alat ini adalah paket npm @labelgrid/cli, dan memasangnya akan menambahkan perintah labelgrid ke komputer Anda.

CLI adalah lapisan tipis di atas API publik LabelGrid: permukaan yang sama, validasi yang sama, dan izin yang sama. Apa pun yang diizinkan API publik bisa dilakukan CLI; apa pun yang ditolak API akan ditolak CLI dengan cara yang persis sama. Jika Anda lebih suka bekerja dengan bahasa sehari-hari lewat asisten AI, LabelGrid juga menerbitkan server MCP yang dibangun di atas API yang sama.

Apa saja yang bisa Anda lakukan

Perintah disusun dalam beberapa kelompok. Dari terminal Anda bisa:

auth — masuk, keluar, memeriksa sedang masuk sebagai siapa, dan mencabut token
catalog — mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track
release — memvalidasi rilis, mengirimnya untuk distribusi, menariknya kembali, mengonfirmasi tinjauan, serta mengelola landing page dan tautan pendeknya
upload — menambahkan audio, artwork, lirik, dan motion artwork (tiap jenis hanya menerima ekstensi file yang diizinkan untuknya)
download, asset, license — mengambil file dan mengelola lisensi
statement, transactions, royalties, analytics — menarik laporan, transaksi, rincian royalti, dan analitik streaming
review — melihat masalah tinjauan, membaca laporan kualitas, dan menambahkan catatan
webhook — mendaftarkan dan mengelola webhook untuk notifikasi asinkron
beatport — mengelola pengaktifan Beatport

Yang Anda butuhkan

Akun LabelGrid dengan akses API. Akses API adalah bagian dari paket API LabelGrid; lihat Ikhtisar API untuk cara mendapatkannya.
Token API. Buat satu di dashboard LabelGrid Anda di bawah Profile → API Tokens.
Node.js 20 atau yang lebih baru di komputer tempat Anda menjalankan CLI.

Pemasangan

Pasang CLI secara global dengan npm:

npm install -g @labelgrid/cli

Ini menambahkan perintah labelgrid. Pastikan pemasangannya berhasil dengan:

labelgrid --version

Autentikasi

CLI membutuhkan token API Anda. Token dicari di tiga tempat, dengan urutan berikut:

Variabel lingkungan LABELGRID_API_TOKEN — paling cocok untuk skrip dan CI.
Kredensial tersimpan yang Anda simpan sekali dengan labelgrid auth login. Di macOS kredensial ini disimpan di Keychain; di sistem lain disimpan ke file dengan izin terbatas di bawah ~/.config/labelgrid/.
Flag --token pada satu perintah tertentu.

Arahkan CLI ke sebuah variabel lingkungan:

export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Atau simpan tokennya sekali dan biarkan CLI memakainya kembali:

labelgrid auth login

CLI tidak pernah mencetak nilai token. Untuk menghentikan akses, keluar dengan labelgrid auth logout atau cabut tokennya dari dashboard Anda, yang langsung berlaku saat itu juga.

Keluaran dan kode keluar

Secara default CLI mencetak keluaran yang rapi dan mudah dibaca manusia. Untuk keperluan skrip, tambahkan --json pada perintah apa pun dan CLI akan mencetak respons API mentah sehingga Anda bisa menyalurkannya ke alat lain:

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

Perintah menetapkan kode keluar standar agar skrip Anda bisa menanggapi hasilnya:

Kode keluar	Arti
`0`	Berhasil
`1`	Kesalahan API (permintaan sampai ke LabelGrid dan ditolak)
`2`	Kesalahan penggunaan (ada kekeliruan pada perintahnya sendiri)

Keamanan

Perintah yang bersifat final dan destruktif meminta konfirmasi Anda sebelum apa pun dikirim. Mengirim rilis untuk distribusi, menarik kembali sebuah rilis, mengonfirmasi tinjauan, menghapus item katalog, dan mengaktifkan Beatport semuanya meminta Anda mengetik y untuk mengonfirmasi sebelum CLI melakukan panggilan API apa pun.

Untuk otomatisasi tanpa ada orang yang mengawasi, tambahkan --yes untuk melewati permintaan konfirmasi:

labelgrid release distribute REL123 --yes

Setiap perlindungan akun, mulai dari validasi, batas paket, sampai batas laju permintaan, diberlakukan oleh server LabelGrid, jadi CLI tidak bisa menghindarinya dengan cara apa pun Anda menjalankannya.

Pemecahan masalah

command not found: labelgrid — pemasangan global belum selesai atau tidak ada di PATH Anda. Jalankan ulang npm install -g @labelgrid/cli dan pastikan Node.js 20 atau yang lebih baru dengan node --version.
Token tidak valid atau ditolak — buat ulang tokennya di dashboard Anda di bawah Profile → API Tokens, lalu tetapkan lagi dengan export LABELGRID_API_TOKEN=... atau labelgrid auth login.
Anda tidak melihat halaman “API Tokens” — akun Anda belum memiliki akses API. Lihat Ikhtisar API untuk cara mengaktifkannya.
Sebuah perintah gagal di dalam skrip — periksa kode keluarnya (1 berarti kesalahan API, 2 berarti kesalahan penggunaan) lalu jalankan ulang perintah yang sama dengan --json untuk membaca respons lengkapnya.

FAQ

”Apakah LabelGrid punya alat baris perintah?”

Ya. LabelGrid menerbitkan CLI resmi sebagai paket npm @labelgrid/cli. Pasang dengan npm install -g @labelgrid/cli dan perintah labelgrid akan tersedia di terminal Anda. Alat ini memerlukan Node.js 20 atau yang lebih baru dan merupakan lapisan tipis di atas API publik LabelGrid.

”Apa saja yang bisa saya lakukan dengannya?”

Masuk dan mengelola token; mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track; mengunggah audio, artwork, lirik, dan motion artwork; memvalidasi rilis, mengirimnya untuk distribusi, dan menariknya kembali; menarik laporan, transaksi, royalti, dan analitik streaming; melihat masalah tinjauan dan laporan kualitas; mengelola webhook; serta mengelola pengaktifan Beatport.

”Bagaimana cara mengautentikasi CLI?”

Dengan token API LabelGrid. CLI mencarinya di tiga tempat secara berurutan: variabel lingkungan LABELGRID_API_TOKEN, lalu kredensial yang tersimpan lewat labelgrid auth login, lalu flag --token. CLI tidak pernah mencetak nilai token.

”Apakah saya perlu paket API?”

Ya. CLI terhubung melalui API publik LabelGrid, jadi akun Anda memerlukan akses API, yang merupakan bagian dari paket API LabelGrid. Lihat Ikhtisar API untuk cara mendapatkan aksesnya.

”Apa bedanya CLI dengan server MCP?”

Keduanya adalah alat resmi LabelGrid di atas API publik yang sama. CLI ditujukan untuk terminal dan skrip Anda; server MCP ditujukan untuk asisten AI seperti Claude dan Cursor yang memanggil API untuk Anda lewat bahasa sehari-hari. Pakai yang paling cocok dengan alur kerja Anda, atau keduanya.

Terkait

Ikhtisar API dan Panduan Cepat — cara mendapatkan akses API dan mengautentikasi
Hubungkan Asisten AI Anda ke LabelGrid (MCP) — tindakan yang sama, lewat bahasa sehari-hari
Webhooks — notifikasi peristiwa asinkron
@labelgrid/cli di npm
Dokumentasi di GitHub — referensi CLI ada di bawah packages/cli

Butuh bantuan?

Jika Anda punya pertanyaan tentang CLI, hubungi tim dukungan kami.

Belum menggunakan LabelGrid?

Semua yang baru saja Anda baca tersedia di platform kami.

Lihat kemampuan LabelGrid →