/**
* Musicku Complete Music Scraper
* Base Source: https://www.musicku.web.id
* Author: Vamz Spectre (VamxAPI)
*
* Features:
* - search(query): Pencarian lagu & metadata lengkap
* - play(idOrQuery): Link streaming player, fallback, embed, & stream audio
* - info / album(idOrQuery): Metadata lengkap lagu, album art multi-resolusi, & tracklist terkait
* - lyric(titleOrId, artist, duration): Lirik tersinkronisasi (synced timestamp) & plain text
*
* Download:
* curl -sL "https://code.vamxapi.my.id/snippet/raw/musicku-scraper" -o musicku-scraper.js
*
* Usage CLI:
* node musicku-scraper.js search "bercinta lewat kata"
* node musicku-scraper.js play "u7Bl_pFSkR8"
* node musicku-scraper.js info "u7Bl_pFSkR8"
* node musicku-scraper.js lyric "u7Bl_pFSkR8"
*/
const BASE_URL = "https://www.musicku.web.id";
const DEFAULT_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, text/plain, */*",
"Referer": "https://www.musicku.web.id/",
"Origin": "https://www.musicku.web.id"
};
function formatDuration(seconds) {
if (!seconds || isNaN(seconds)) return "00:00";
const sec = parseInt(seconds, 10);
const m = Math.floor(sec / 60);
const s = sec % 60;
return `${m.toString().padStart(2, "0")}:${s.toString().padStart(2, "0")}`;
}
function cleanTitle(str) {
if (!str) return "";
return str
.replace(/\s*\([^)]*official[^)]*\)/gi, "")
.replace(/\s*\[[^\]]*official[^\]]*\]/gi, "")
.replace(/\s*\([^)]*video[^)]*\)/gi, "")
.replace(/\s*\[[^\]]*video[^\]]*\]/gi, "")
.replace(/\s*\([^)]*audio[^)]*\)/gi, "")
.replace(/\s*\[[^\]]*audio[^\]]*\]/gi, "")
.replace(/\s*\([^)]*lyric[^)]*\)/gi, "")
.replace(/\s*\[[^\]]*lyric[^\]]*\]/gi, "")
.trim();
}
function cleanArtist(str) {
if (!str) return "";
return str.replace(/\s*-\s*Topic$/i, "").trim();
}
function getArtwork(thumbUrl, videoId, size = 512) {
if (thumbUrl && thumbUrl.includes("googleusercontent.com")) {
return thumbUrl.replace(/=[wsh]\d+.*$/, `=w${size}-h${size}-l90-rj`);
}
if (videoId) {
if (size >= 1080) return `https://i.ytimg.com/vi/${videoId}/maxresdefault.jpg`;
if (size >= 512) return `https://i.ytimg.com/vi/${videoId}/sddefault.jpg`;
return `https://i.ytimg.com/vi/${videoId}/hqdefault.jpg`;
}
return thumbUrl || null;
}
/**
* 1. SEARCH MUSIC
*/
async function search(query) {
if (!query || typeof query !== "string") {
throw new Error("Parameter query pencarian wajib diisi.");
}
const endpoint = `${BASE_URL}/api/a?op=search&q=${encodeURIComponent(query.trim())}`;
const res = await fetch(endpoint, {
method: "GET",
headers: DEFAULT_HEADERS
});
if (!res.ok) {
throw new Error(`Gagal mencari musik: HTTP ${res.status}`);
}
const raw = await res.json();
if (!Array.isArray(raw)) return [];
return raw.map(item => ({
id: item.id,
title: item.title,
artist: item.artist,
duration: {
seconds: item.dur || 0,
formatted: formatDuration(item.dur)
},
thumbnail: item.thumb,
artworks: {
small: getArtwork(item.thumb, item.id, 96),
medium: getArtwork(item.thumb, item.id, 512),
large: getArtwork(item.thumb, item.id, 1080)
},
url: `https://www.youtube.com/watch?v=${item.id}`,
embedUrl: `https://www.youtube.com/embed/${item.id}`
}));
}
/**
* 2. PLAY MUSIC
*/
async function play(idOrQuery) {
if (!idOrQuery) {
throw new Error("Parameter idOrQuery wajib diisi.");
}
let videoId = idOrQuery.trim();
let trackData = null;
const isVideoId = /^[a-zA-Z0-9_-]{11}$/.test(videoId);
if (!isVideoId) {
const searchResults = await search(videoId);
if (!searchResults || searchResults.length === 0) {
throw new Error(`Musik dengan kata kunci "${videoId}" tidak ditemukan.`);
}
trackData = searchResults[0];
videoId = trackData.id;
} else {
try {
const oembedRes = await fetch(`https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=${videoId}&format=json`);
if (oembedRes.ok) {
const oe = await oembedRes.json();
trackData = {
title: oe.title,
artist: oe.author_name,
thumbnail: oe.thumbnail_url
};
}
} catch {}
}
const streamEndpoint = `${BASE_URL}/api/a?op=stream&id=${encodeURIComponent(videoId)}`;
return {
status: true,
creator: "Vamz Spectre",
id: videoId,
title: trackData ? trackData.title : null,
artist: trackData ? trackData.artist : null,
playback: {
streamApiUrl: streamEndpoint,
streamWebmUrl: `${streamEndpoint}&f=webm`,
embedUrl: `https://www.youtube.com/embed/${videoId}?autoplay=1&enablejsapi=1`,
watchUrl: `https://www.youtube.com/watch?v=${videoId}`,
playerIframe: ``
},
artworks: {
thumbnail: trackData?.thumbnail || `https://i.ytimg.com/vi/${videoId}/hqdefault.jpg`,
hd: `https://i.ytimg.com/vi/${videoId}/maxresdefault.jpg`
}
};
}
/**
* 3. ALBUM / INFO MUSIC
*/
async function info(idOrQuery) {
if (!idOrQuery) {
throw new Error("Parameter idOrQuery wajib diisi.");
}
let videoId = idOrQuery.trim();
let baseTrack = null;
const isVideoId = /^[a-zA-Z0-9_-]{11}$/.test(videoId);
if (!isVideoId) {
const searchResults = await search(videoId);
if (!searchResults || searchResults.length === 0) {
throw new Error(`Lagu "${videoId}" tidak ditemukan.`);
}
baseTrack = searchResults[0];
videoId = baseTrack.id;
}
const [oembedRes, radioRes] = await Promise.allSettled([
fetch(`https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=${videoId}&format=json`).then(r => r.ok ? r.json() : null),
fetch(`${BASE_URL}/api/a?op=radio&id=${encodeURIComponent(videoId)}`, { headers: DEFAULT_HEADERS }).then(r => r.ok ? r.json() : [])
]);
const oembed = oembedRes.status === "fulfilled" ? oembedRes.value : null;
const radioRaw = radioRes.status === "fulfilled" && Array.isArray(radioRes.value) ? radioRes.value : [];
const title = (baseTrack && baseTrack.title) || (oembed && oembed.title) || null;
const artist = (baseTrack && baseTrack.artist) || (oembed && oembed.author_name) || null;
const durationSec = baseTrack ? baseTrack.duration.seconds : (radioRaw.find(r => r.id === videoId)?.dur || 0);
const albumTracks = radioRaw.slice(0, 15).map(item => ({
id: item.id,
title: item.title,
artist: item.artist,
duration: {
seconds: item.dur || 0,
formatted: formatDuration(item.dur)
},
thumbnail: item.thumb,
url: `https://www.youtube.com/watch?v=${item.id}`
}));
return {
status: true,
creator: "Vamz Spectre",
id: videoId,
title,
artist,
author: {
name: oembed ? oembed.author_name : artist,
channelUrl: oembed ? oembed.author_url : null
},
duration: {
seconds: durationSec,
formatted: formatDuration(durationSec)
},
artworks: {
thumbnail: oembed ? oembed.thumbnail_url : `https://i.ytimg.com/vi/${videoId}/hqdefault.jpg`,
medium: getArtwork(baseTrack?.thumbnail, videoId, 512),
large: getArtwork(baseTrack?.thumbnail, videoId, 1080),
maxres: `https://i.ytimg.com/vi/${videoId}/maxresdefault.jpg`
},
links: {
watchUrl: `https://www.youtube.com/watch?v=${videoId}`,
embedUrl: `https://www.youtube.com/embed/${videoId}`,
streamApiUrl: `${BASE_URL}/api/a?op=stream&id=${videoId}`
},
relatedTracksCount: albumTracks.length,
relatedTracks: albumTracks
};
}
/**
* 4. LYRIC MUSIC
*/
async function lyric(titleOrId, artist = "", duration = 0) {
if (!titleOrId) {
throw new Error("Parameter titleOrId wajib diisi.");
}
let title = titleOrId.trim();
let artistName = (artist || "").trim();
let dur = parseInt(duration, 10) || 0;
const isVideoId = /^[a-zA-Z0-9_-]{11}$/.test(title);
if (isVideoId) {
const infoData = await info(title);
title = cleanTitle(infoData.title || "");
artistName = cleanArtist(infoData.artist || "");
dur = infoData.duration.seconds || 0;
}
async function fetchLyric(t, a, d) {
const params = new URLSearchParams({
op: "lyrics",
title: t,
artist: a,
d: String(d || 0)
});
const res = await fetch(`${BASE_URL}/api/a?${params.toString()}`, {
method: "GET",
headers: DEFAULT_HEADERS
});
if (!res.ok) return null;
return await res.json().catch(() => null);
}
let data = await fetchLyric(title, artistName, dur);
if ((!data || (!data.synced && !data.plain)) && title.includes("(")) {
const simplifiedTitle = title.replace(/\s*\([^)]*\)/g, "").trim();
const fallbackData = await fetchLyric(simplifiedTitle, artistName, dur);
if (fallbackData && (fallbackData.synced || fallbackData.plain)) {
data = fallbackData;
title = simplifiedTitle;
}
}
if (!data || (!data.synced && !data.plain)) {
return {
status: false,
creator: "Vamz Spectre",
message: `Lirik tidak ditemukan untuk "${title}"`,
title,
artist: artistName,
lyrics: { synced: null, plain: null, parsed: [] }
};
}
const synced = data.synced || null;
const plain = data.plain || null;
let parsedLines = [];
if (synced) {
const rawLines = synced.split("\n");
for (const line of rawLines) {
const match = line.match(/^\[(\d{2}):(\d{2}\.\d{2})\]\s*(.*)$/);
if (match) {
const minutes = parseInt(match[1], 10);
const seconds = parseFloat(match[2]);
const timeSec = parseFloat((minutes * 60 + seconds).toFixed(2));
const text = match[3].trim();
if (text) {
parsedLines.push({
time: `${match[1]}:${match[2]}`,
timestamp: timeSec,
text
});
}
}
}
}
return {
status: true,
creator: "Vamz Spectre",
title,
artist: artistName,
hasSynced: Boolean(synced),
hasPlain: Boolean(plain),
totalLines: parsedLines.length,
lyrics: {
synced,
plain,
parsed: parsedLines
}
};
}
module.exports = {
search,
play,
info,
album: info,
lyric
};
// Real-Time CLI Runner
if (require.main === module) {
const args = process.argv.slice(2);
const action = (args[0] || "search").toLowerCase();
const query = args[1] || "bercinta lewat kata";
async function run() {
switch (action) {
case "search": {
const results = await search(query);
return { action: "search", count: results.length, results };
}
case "play": {
return await play(query);
}
case "info":
case "album": {
return await info(query);
}
case "lyric":
case "lyrics": {
const artist = args[2] || "";
const dur = args[3] || 0;
return await lyric(query, artist, dur);
}
default: {
return {
error: "Action tidak dikenal",
usage: "node musicku-scraper.js [artist] [durasi]"
};
}
}
}
run()
.then(data => {
console.log(JSON.stringify(data, null, 2));
process.exit(0);
})
.catch(err => {
console.error(JSON.stringify({ status: false, error: err.message }, null, 2));
process.exit(1);
});
}