/** * ======================================================== * Name: Get Lyrics - Song Lyrics & Synced Karaoke Extractor Engine * * Cara Download: * curl -sL "https://code.vamxapi.my.id/snippet/raw/get-lyrics-scraper" -o get-lyrics-scraper.js * * Cara Eksekusi: * node get-lyrics-scraper.js "Bohemian Rhapsody" * node get-lyrics-scraper.js "Komang Raim Laode" * node get-lyrics-scraper.js search "Coldplay" * node get-lyrics-scraper.js id 16232 * * Author: Vamz Spectre * Source: https://vamxapi.my.id * ======================================================== */ const API_BASE = "https://lrclib.net/api"; const USER_AGENT = "VamxAPI/1.0 (https://vamxapi.my.id; contact@vamxapi.my.id)"; /** * Parser format LRC (Timecoded Synced Lyrics) ke structured format * Mengonversi baris [00:15.20] Lyric line -> { time: "00:15.20", timestamp: 15.2, text: "Lyric line" } * @param {string} lrcText * @returns {Array<{time: string, timestamp: number, text: string}>} */ function parseLRC(lrcText) { if (!lrcText || typeof lrcText !== "string") return []; const lines = lrcText.split("\n"); const parsed = []; const regex = /^\[(\d{2}):(\d{2}(?:\.\d+)?)\]\s?(.*)$/; for (const line of lines) { const trimmed = line.trim(); const match = trimmed.match(regex); if (match) { const min = parseInt(match[1], 10); const sec = parseFloat(match[2]); const timestamp = parseFloat((min * 60 + sec).toFixed(2)); const text = match[3] ? match[3].trim() : ""; parsed.push({ time: `${match[1]}:${match[2]}`, timestamp, text }); } } return parsed; } /** * 1. Cari Daftar Lagu Berdasarkan Judul, Artis, atau Kata Kunci * @param {string} query * @returns {Promise} */ async function searchSongs(query) { const q = (query || "").trim(); if (!q) { throw new Error("Parameter query pencarian lagu wajib diisi!"); } const url = `${API_BASE}/search?q=${encodeURIComponent(q)}`; const res = await fetch(url, { headers: { "User-Agent": USER_AGENT, Accept: "application/json" } }); if (!res.ok) { throw new Error(`Gagal mencari lagu: HTTP ${res.status} ${res.statusText}`); } const items = await res.json(); if (!Array.isArray(items) || items.length === 0) { return { status: false, creator: "Vamz Spectre", message: `Tidak ditemukan lagu dengan kata kunci: "${q}"`, results: [] }; } const results = items.map((item) => ({ id: item.id, trackName: item.trackName, artistName: item.artistName, albumName: item.albumName || null, duration: item.duration || null, instrumental: Boolean(item.instrumental), hasSyncedLyrics: Boolean(item.syncedLyrics), hasPlainLyrics: Boolean(item.plainLyrics) })); return { status: true, creator: "Vamz Spectre", query: q, total: results.length, results }; } /** * 2. Ambil Lirik Berdasarkan ID Rekaman LRCLIB * @param {number|string} id * @returns {Promise} */ async function getLyricsById(id) { const cleanId = String(id || "").trim(); if (!cleanId) { throw new Error("Parameter ID lagu wajib disertakan!"); } const url = `${API_BASE}/get/${encodeURIComponent(cleanId)}`; const res = await fetch(url, { headers: { "User-Agent": USER_AGENT, Accept: "application/json" } }); if (!res.ok) { if (res.status === 404) { return { status: false, creator: "Vamz Spectre", message: `Lagu dengan ID ${cleanId} tidak ditemukan.` }; } throw new Error(`Gagal mengambil lirik: HTTP ${res.status} ${res.statusText}`); } const data = await res.json(); const parsedSynced = data.syncedLyrics ? parseLRC(data.syncedLyrics) : []; return { status: true, creator: "Vamz Spectre", id: data.id, trackName: data.trackName, artistName: data.artistName, albumName: data.albumName || null, duration: data.duration || null, instrumental: Boolean(data.instrumental), plainLyrics: data.plainLyrics || null, syncedLyrics: data.syncedLyrics || null, lines: parsedSynced }; } /** * 3. Ambil Lirik Lagu Lengkap (Plain + Synced Karaoke + Structured Lines) * @param {string} query - Judul lagu atau kata kunci * @param {string} [artist=""] - Nama artis opsional untuk pencocokan presisi * @returns {Promise} */ async function getLyrics(query, artist = "") { const cleanQuery = (query || "").trim(); const cleanArtist = (artist || "").trim(); if (!cleanQuery) { throw new Error("Judul lagu atau kata kunci pencarian wajib disertakan!"); } // Jika nama lagu & artis keduanya disediakan, coba endpoint direct match if (cleanArtist) { try { const directUrl = `${API_BASE}/get?track_name=${encodeURIComponent(cleanQuery)}&artist_name=${encodeURIComponent(cleanArtist)}`; const directRes = await fetch(directUrl, { headers: { "User-Agent": USER_AGENT, Accept: "application/json" } }); if (directRes.ok) { const directData = await directRes.json(); if (directData && (directData.plainLyrics || directData.syncedLyrics)) { return { status: true, creator: "Vamz Spectre", id: directData.id, trackName: directData.trackName, artistName: directData.artistName, albumName: directData.albumName || null, duration: directData.duration || null, instrumental: Boolean(directData.instrumental), hasSyncedLyrics: Boolean(directData.syncedLyrics), plainLyrics: directData.plainLyrics || null, syncedLyrics: directData.syncedLyrics || null, lines: directData.syncedLyrics ? parseLRC(directData.syncedLyrics) : [] }; } } } catch (_) { // Abaikan dan lanjut ke pencarian universal } } // Pencarian universal via query search const searchQuery = cleanArtist ? `${cleanQuery} ${cleanArtist}` : cleanQuery; const searchUrl = `${API_BASE}/search?q=${encodeURIComponent(searchQuery)}`; const res = await fetch(searchUrl, { headers: { "User-Agent": USER_AGENT, Accept: "application/json" } }); if (!res.ok) { throw new Error(`Gagal mencari lirik lagu: HTTP ${res.status} ${res.statusText}`); } const items = await res.json(); if (!Array.isArray(items) || items.length === 0) { return { status: false, creator: "Vamz Spectre", message: `Lirik tidak ditemukan untuk lagu: "${searchQuery}"` }; } // Prioritaskan item yang memiliki syncedLyrics atau plainLyrics const bestMatch = items.find((i) => i.syncedLyrics || i.plainLyrics) || items[0]; if (!bestMatch.plainLyrics && !bestMatch.syncedLyrics) { return { status: false, creator: "Vamz Spectre", message: `Tersedia data lagu (${bestMatch.trackName} - ${bestMatch.artistName}), namun lirik belum dipublikasikan atau instrumental.` }; } const parsedLines = bestMatch.syncedLyrics ? parseLRC(bestMatch.syncedLyrics) : []; return { status: true, creator: "Vamz Spectre", id: bestMatch.id, trackName: bestMatch.trackName, artistName: bestMatch.artistName, albumName: bestMatch.albumName || null, duration: bestMatch.duration || null, instrumental: Boolean(bestMatch.instrumental), hasSyncedLyrics: Boolean(bestMatch.syncedLyrics), plainLyrics: bestMatch.plainLyrics || null, syncedLyrics: bestMatch.syncedLyrics || null, lines: parsedLines }; } // Router & Controller Utama async function lyrics(command, ...args) { const sub = (command || "").toLowerCase().trim(); switch (sub) { case "search": return await searchSongs(args[0]); case "id": return await getLyricsById(args[0]); case "get": return await getLyrics(args[0], args[1]); default: // Default: langsung cari lirik lagu return await getLyrics(command, args[0]); } } // CLI Runner Support const cliArgs = process.argv.slice(2); const firstArg = cliArgs[0] ? cliArgs[0].trim() : null; async function runCli() { if (!firstArg) { console.log( JSON.stringify( { status: false, creator: "Vamz Spectre", message: "Parameter judul lagu atau sub-command belum ditentukan.", usage: { get_lyrics: "node get-lyrics-scraper.js \"\" [nama artis]", search_songs: "node get-lyrics-scraper.js search \"\"", get_by_id: "node get-lyrics-scraper.js id " }, examples: [ 'node get-lyrics-scraper.js "Bohemian Rhapsody"', 'node get-lyrics-scraper.js "Separuh Aku" "Noah"', 'node get-lyrics-scraper.js "Komang Raim Laode"', 'node get-lyrics-scraper.js search "Adele"', 'node get-lyrics-scraper.js id 16232' ] }, null, 2 ) ); process.exit(1); } try { const res = await lyrics(firstArg, ...cliArgs.slice(1)); console.log(JSON.stringify(res, null, 2)); } catch (err) { console.error( JSON.stringify( { status: false, creator: "Vamz Spectre", message: err.message }, null, 2 ) ); process.exit(1); } } if (process.argv[1] && process.argv[1].includes("get-lyrics-scraper")) { runCli().catch((err) => { console.error( JSON.stringify( { status: false, creator: "Vamz Spectre", error: err.message }, null, 2 ) ); process.exit(1); }); } if (typeof module !== "undefined" && module.exports) { module.exports = { getLyrics, searchSongs, getLyricsById, parseLRC, lyrics }; }