/** * NanzMusify - YouTube Music & Synced Lyrics Scraper Engine * Author: Vamz Spectre (VamxAPI) * License: MIT * Description: Scraper client untuk mengekstrak data katalog YouTube Music (Innertube) * dan Synced Karaoke Lyrics (LRCLIB) dari endpoint platform NanzMusify. */ const axios = require('axios'); class NanzMusify { constructor(baseURL = 'https://nanzz-music.netlify.app/api') { this.client = axios.create({ baseURL, timeout: 20000, headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36', 'Accept': 'application/json' } }); } /** * Cari Lagu, Artis, Playlist, atau Album * @param {string} query - Kata kunci pencarian * @param {'songs'|'artists'|'playlists'|'albums'|'all'} type - Tipe pencarian (default: 'songs') */ async search(query, type = 'songs') { if (!query || typeof query !== 'string') { throw new Error('Parameter query pencarian wajib diisi.'); } try { const { data } = await this.client.get('/search', { params: { query: query.trim(), type } }); if (!data || !data.status || !data.result) { return { status: false, creator: 'Vamz Spectre', message: data?.message || 'Tidak ada hasil ditemukan.' }; } const res = data.result; const songs = (res.songs || []).map((s) => ({ videoId: s.videoId, title: s.title, artist: s.artist, artistId: s.artistId || null, album: s.album || null, albumId: s.albumId || null, duration: s.duration || null, thumbnail: s.thumbnail || `https://i.ytimg.com/vi/${s.videoId}/hqdefault.jpg`, url: s.url || `https://music.youtube.com/watch?v=${s.videoId}` })); const artists = (res.artists || []).map((a) => ({ artistId: a.browseId || a.artistId, name: a.name, subscribers: a.subscribers || null, thumbnail: a.thumbnail || (a.thumbnails && a.thumbnails[0]?.url) || null })); const playlists = (res.playlists || []).map((p) => ({ playlistId: p.browseId || p.playlistId, title: p.title || p.name, author: p.author || p.artist, trackCount: p.trackCount || null, thumbnail: p.thumbnail || (p.thumbnails && p.thumbnails[0]?.url) || null })); return { status: true, creator: 'Vamz Spectre', query, type, totalSongs: songs.length, songs, artists, playlists }; } catch (err) { return { status: false, creator: 'Vamz Spectre', message: err.response?.data?.message || err.message }; } } /** * Ambil Lirik Lagu Sinkron (Karaoke Timecoded) & Plain Text * @param {string} videoId - YouTube Music Video ID (misal: 'FttRJLIoqyA') */ async getLyrics(videoId) { if (!videoId) throw new Error('Parameter videoId wajib disertakan.'); try { const { data } = await this.client.get('/lyrics', { params: { id: videoId.trim() } }); if (!data || !data.status || !data.result?.lyrics) { return { status: false, creator: 'Vamz Spectre', message: data?.message || 'Lirik untuk lagu ini tidak tersedia.' }; } const info = data.result; return { status: true, creator: 'Vamz Spectre', videoId: info.videoId, title: info.title, artist: info.artist, album: info.album || null, source: info.source || 'LRCLIB / timedtext', lyricsType: info.lyrics.type, lines: (info.lyrics.lines || []).map((l) => ({ time: l.time, text: l.text })) }; } catch (err) { return { status: false, creator: 'Vamz Spectre', message: err.response?.data?.message || err.message }; } } /** * Ambil Detail Profil & Diskografi Artis Lengkap * @param {string} artistId - YouTube Channel Browse ID (misal: 'UCukBv_7AJU7AZHcidF0HIvQ') */ async getArtist(artistId) { if (!artistId) throw new Error('Parameter artistId wajib disertakan.'); try { const { data } = await this.client.get('/artist', { params: { id: artistId.trim() } }); if (!data || !data.status || !data.result) { return { status: false, creator: 'Vamz Spectre', message: data?.message || 'Data artis tidak ditemukan.' }; } return { status: true, creator: 'Vamz Spectre', artistId, data: data.result }; } catch (err) { return { status: false, creator: 'Vamz Spectre', message: err.response?.data?.message || err.message }; } } /** * Ambil Saran Kata Kunci Otomatis (Search Auto-Suggestions) * @param {string} query - Keyword awalan */ async getSuggestions(query) { if (!query) return { status: true, suggestions: [] }; try { const { data } = await this.client.get('/suggest', { params: { query: query.trim() } }); return { status: true, creator: 'Vamz Spectre', suggestions: Array.isArray(data) ? data : (data?.suggestions || []) }; } catch (err) { return { status: false, creator: 'Vamz Spectre', message: err.message }; } } } const musify = new NanzMusify(); if (require.main === module) { const args = process.argv.slice(2); const cmd = args[0] ? args[0].toLowerCase().trim() : ""; const param = args.slice(1).join(" ").trim(); if (!cmd || !param) { console.log(` ============================================================= NANZMUSIFY YOUTUBE MUSIC ENGINE (CLI) ============================================================= ❌ Error: Perintah atau parameter tidak boleh kosong! 📖 CARA PENGGUNAAN LENGKAP: node nanzz-music-scraper.js 📌 DAFTAR COMMAND TERSEDIA: node nanzz-music-scraper.js search (Cari lagu di YouTube Music) node nanzz-music-scraper.js lyrics (Ambil lirik karaoke sinkron) node nanzz-music-scraper.js suggest (Auto-complete suggestions) node nanzz-music-scraper.js artist (Diskografi & top tracks artis) 📌 CONTOH PENGGUNAAN: node nanzz-music-scraper.js search "Hindia Secukupnya" node nanzz-music-scraper.js lyrics "FttRJLIoqyA" node nanzz-music-scraper.js suggest "himawari" node nanzz-music-scraper.js artist "UCukBv_7AJU7AZHcidF0HIvQ" 💡 INTEGRASI MODULAR (Node.js / Express / Baileys): const { musify } = require("./nanzz-music-scraper"); const songs = await musify.search("Secukupnya", "songs"); console.log(songs); ============================================================= `); process.exit(1); } (async () => { try { console.log(`⏳ Memproses perintah [${cmd}] untuk: "${param}"...`); if (cmd === "search") { const res = await musify.search(param, "songs"); console.log(JSON.stringify(res, null, 2)); } else if (cmd === "lyrics") { const res = await musify.getLyrics(param); console.log(JSON.stringify(res, null, 2)); } else if (cmd === "suggest") { const res = await musify.getSuggestions(param); console.log(JSON.stringify(res, null, 2)); } else if (cmd === "artist") { const res = await musify.getArtist(param); console.log(JSON.stringify(res, null, 2)); } else { console.log("❌ Perintah tidak dikenal! Pilihan yang valid: search | lyrics | suggest | artist"); } } catch (err) { console.error("❌ Terjadi Kesalahan:", err.message); } })(); } if (typeof module !== "undefined" && module.exports) { module.exports = { NanzMusify, musify }; }