@kuriyona/cecilia 0.2.0 → 1.0.0

package/dist/index.mjs

@@ -1,3 +1,643 @@
+import { constants, createCipheriv, createHash, createPublicKey, publicEncrypt, randomBytes, randomInt } from "node:crypto";
+//#region src/cookies.ts
+const LOWERCASE = "abcdefghijklmnopqrstuvwxyz";
+const randomLowercase = (length) => {
+	let out = "";
+	for (let i = 0; i < length; i++) out += LOWERCASE[Math.floor(Math.random() * 26)];
+	return out;
+};
+const cookieToObject = (cookie) => {
+	if (!cookie) return {};
+	if (typeof cookie !== "string") return { ...cookie };
+	const result = {};
+	for (const part of cookie.split(";")) {
+		const index = part.indexOf("=");
+		if (index === -1) continue;
+		const key = part.slice(0, index).trim();
+		if (!key) continue;
+		result[key] = part.slice(index + 1).trim();
+	}
+	return result;
+};
+const cookieToString = (cookie) => Object.entries(cookie).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join("; ");
+const buildCookieObject = (cookie) => {
+	const input = cookieToObject(cookie);
+	const nuid = input._ntes_nuid || randomBytes(32).toString("hex");
+	const timestamp = Date.now();
+	return {
+		_ntes_nuid: nuid,
+		_ntes_nnid: `${nuid},${timestamp}`,
+		WNMCID: `${randomLowercase(6)}.${timestamp}.01.0`,
+		__remember_me: "true",
+		ntes_kaola_ad: "1",
+		WEVNSM: "1.0.0",
+		os: "pc",
+		appver: "3.1.17.204416",
+		osver: "Microsoft-Windows-10-Professional-build-19045-64bit",
+		channel: "netease",
+		deviceId: randomBytes(32).toString("hex").toUpperCase(),
+		...input
+	};
+};
+//#endregion
+//#region src/crypto/constants.ts
+const PRESET_KEY = "0CoJUm6Qyw8W8jud";
+const IV = "0102030405060708";
+const BASE62 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+const EAPI_KEY = "e82ckenh8dichen8";
+const EAPI_SEP = "-36cd479b6b5-";
+const WEAPI_DOMAIN = "https://music.163.com";
+const EAPI_DOMAIN = "https://interfacepc.music.163.com";
+const API_DOMAIN = "https://interface.music.163.com";
+const WEAPI_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
+MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDgtQn2JZ34ZC28NWYpAUd98iZ37BUrX/aKzmFbt7clFSs6sXqHauqKWqdtLkF2KexO40H1YTX8z2lSgBBOAxLsvaklV8k4cBFK9snQXE9/DDaFt6Rr7iVZMldczhC0JNgTz+SHXT6CBHuX3e9SdB1Ua44oncaTWz7OBGLbCiK45wIDAQAB
+-----END PUBLIC KEY-----`;
+//#endregion
+//#region src/crypto/eapi.ts
+const eapiEncrypt = (uri, data) => {
+	const text = JSON.stringify(data);
+	const digest = createHash("md5").update(`nobody${uri}use${text}md5forencrypt`, "utf8").digest("hex");
+	const cipher = createCipheriv("aes-128-ecb", EAPI_KEY, null);
+	const plain = `${uri}${EAPI_SEP}${text}${EAPI_SEP}${digest}`;
+	return Buffer.concat([cipher.update(plain, "utf8"), cipher.final()]).toString("hex");
+};
+//#endregion
+//#region src/crypto/weapi.ts
+const aes128Cbc = (text, key, iv) => {
+	const cipher = createCipheriv("aes-128-cbc", Buffer.from(key, "utf8"), Buffer.from(iv, "utf8"));
+	return Buffer.concat([cipher.update(text, "utf8"), cipher.final()]).toString("base64");
+};
+const randomSecretKey = () => {
+	let out = "";
+	for (let i = 0; i < 16; i++) out += BASE62[randomInt(62)];
+	return out;
+};
+const rsaEncryptNoPadding = (text) => {
+	const key = createPublicKey(WEAPI_PUBLIC_KEY);
+	const modulusLength = key.asymmetricKeyDetails?.modulusLength;
+	const size = modulusLength ? modulusLength / 8 : 128;
+	const message = Buffer.from(text, "utf8");
+	const padded = Buffer.concat([Buffer.alloc(Math.max(0, size - message.length)), message]);
+	return publicEncrypt({
+		key,
+		padding: constants.RSA_NO_PADDING
+	}, padded).toString("hex");
+};
+const weapiEncrypt = (data, options) => {
+	const secretKey = options?.secretKey ?? randomSecretKey();
+	return {
+		params: aes128Cbc(aes128Cbc(JSON.stringify(data), PRESET_KEY, IV), secretKey, IV),
+		encSecKey: rsaEncryptNoPadding([...secretKey].reverse().join(""))
+	};
+};
+//#endregion
+//#region src/errors.ts
+const pickDetail = (body) => {
+	if (typeof body !== "object" || body === null) return void 0;
+	if ("msg" in body && typeof body.msg === "string" && body.msg.length > 0) return body.msg;
+	if ("message" in body && typeof body.message === "string" && body.message.length > 0) return body.message;
+};
+var NeteaseApiError = class extends Error {
+	code;
+	uri;
+	status;
+	body;
+	constructor(uri, code, status, body) {
+		const detail = pickDetail(body);
+		super(`${uri} 请求失败: code ${code}${detail ? ` ${detail}` : ""}`);
+		this.name = "NeteaseApiError";
+		this.code = code;
+		this.uri = uri;
+		this.status = status;
+		this.body = body;
+	}
+};
+//#endregion
+//#region src/http.ts
+const getSetCookies = (res) => {
+	try {
+		return res.headers.getSetCookie();
+	} catch {
+		return [];
+	}
+};
+async function postForm(url, body, headers, timeout) {
+	const res = await fetch(url, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/x-www-form-urlencoded",
+			...headers
+		},
+		body,
+		signal: AbortSignal.timeout(timeout)
+	});
+	const text = await res.text();
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		json = void 0;
+	}
+	return {
+		json,
+		setCookies: getSetCookies(res),
+		status: res.status,
+		text
+	};
+}
+async function getText(url, timeout, headers = {}) {
+	const res = await fetch(url, {
+		headers,
+		signal: AbortSignal.timeout(timeout)
+	});
+	const text = await res.text();
+	return {
+		json: void 0,
+		setCookies: getSetCookies(res),
+		status: res.status,
+		text
+	};
+}
+//#endregion
+//#region src/utils/num.ts
+const num = (v) => {
+	if (v === null || v === void 0 || v === "") return void 0;
+	const n = Number(v);
+	return Number.isNaN(n) ? void 0 : n;
+};
+//#endregion
+//#region src/client.ts
+const generateRequestId = () => `${Date.now()}_${String(randomInt(1e3)).padStart(4, "0")}`;
+const readCode = (body) => {
+	if (typeof body !== "object" || body === null || !("code" in body)) return;
+	return num(body.code);
+};
+async function request(uri, data, crypto, options, acceptCodes = [200]) {
+	const timeout = options?.timeout ?? 1e4;
+	const cookie = buildCookieObject(options?.cookie);
+	const csrf = cookie.__csrf ?? "";
+	const payload = {
+		...data,
+		e_r: false
+	};
+	const headers = {};
+	let url;
+	let body;
+	if (crypto === "eapi") {
+		const header = {
+			osver: cookie.osver ?? "",
+			deviceId: cookie.deviceId ?? "",
+			os: cookie.os ?? "",
+			appver: cookie.appver ?? "",
+			versioncode: "140",
+			mobilename: "",
+			buildver: String(Date.now()).slice(0, 10),
+			resolution: "1920x1080",
+			__csrf: csrf,
+			channel: cookie.channel ?? "",
+			requestId: generateRequestId()
+		};
+		if (cookie.MUSIC_U) header.MUSIC_U = cookie.MUSIC_U;
+		payload.header = header;
+		url = EAPI_DOMAIN + uri.replace(/^\/api/, "/eapi");
+		headers["User-Agent"] = options?.ua ?? "NeteaseMusic 9.0.90/5038 (iPhone; iOS 16.2; zh_CN)";
+		headers.Cookie = cookieToString(header);
+		body = new URLSearchParams({ params: eapiEncrypt(uri, payload) }).toString();
+	} else if (crypto === "weapi") {
+		payload.csrf_token = csrf;
+		url = `${WEAPI_DOMAIN}/weapi/${uri.slice(5)}`;
+		headers.Referer = WEAPI_DOMAIN;
+		headers["User-Agent"] = options?.ua ?? "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.0";
+		headers.Cookie = cookieToString(cookie);
+		body = new URLSearchParams({ ...weapiEncrypt(payload) }).toString();
+	} else {
+		const form = new URLSearchParams();
+		for (const [key, value] of Object.entries(payload)) form.append(key, String(value));
+		url = API_DOMAIN + uri;
+		headers.Referer = WEAPI_DOMAIN;
+		headers["User-Agent"] = options?.ua ?? "NeteaseMusic 9.0.90/5038 (iPhone; iOS 16.2; zh_CN)";
+		headers.Cookie = cookieToString(cookie);
+		body = form.toString();
+	}
+	if (options?.realIP) {
+		headers["X-Real-IP"] = options.realIP;
+		headers["X-Forwarded-For"] = options.realIP;
+	}
+	let res;
+	try {
+		res = await postForm(url, body, headers, timeout);
+	} catch (error) {
+		throw new NeteaseApiError(uri, -1, 0, {
+			code: -1,
+			msg: error instanceof Error ? error.message : String(error)
+		});
+	}
+	if (res.json === void 0) throw new NeteaseApiError(uri, res.status, res.status, res.text);
+	const code = readCode(res.json);
+	if (code !== void 0) {
+		if (!acceptCodes.includes(code)) throw new NeteaseApiError(uri, code, res.status, res.json);
+		return {
+			status: res.status,
+			body: res.json,
+			cookies: res.setCookies
+		};
+	}
+	if (res.status < 200 || res.status >= 300) throw new NeteaseApiError(uri, res.status, res.status, res.json);
+	return {
+		status: res.status,
+		body: res.json,
+		cookies: res.setCookies
+	};
+}
+//#endregion
+//#region src/apis/adapters.ts
+const toArtistRef = (raw) => ({
+	id: num(raw.id) ?? 0,
+	name: raw.name ?? ""
+});
+const toUserRef = (raw) => ({
+	id: num(raw.userId ?? raw.id) ?? 0,
+	name: raw.nickname ?? raw.name ?? ""
+});
+const toAlbumRef = (raw) => ({
+	id: num(raw.id) ?? 0,
+	name: raw.name ?? "",
+	coverUrl: raw.picUrl ?? raw.coverImgUrl ?? ""
+});
+/** id/duration 缺失的条目返回 undefined，由调用方丢弃。 */
+const toSong = (raw) => {
+	const id = num(raw.id);
+	const duration = num(raw.dt ?? raw.duration);
+	if (id === void 0 || duration === void 0) return void 0;
+	const album = raw.al ?? raw.album;
+	const alias = raw.alia ?? raw.alias;
+	const fee = num(raw.fee);
+	const state = num(raw.st);
+	return {
+		id,
+		name: raw.name ?? "",
+		artists: (raw.ar ?? raw.artists ?? []).map(toArtistRef),
+		album: album ? toAlbumRef(album) : {
+			id: 0,
+			name: "",
+			coverUrl: ""
+		},
+		duration,
+		...alias?.length ? { alias } : {},
+		...fee !== void 0 ? { fee } : {},
+		...state !== void 0 ? { available: state >= 0 } : {}
+	};
+};
+const toSongs = (raws) => {
+	const songs = [];
+	for (const raw of raws ?? []) {
+		const song = toSong(raw);
+		if (song) songs.push(song);
+	}
+	return songs;
+};
+const toArtist = (raw) => {
+	const albumCount = num(raw.albumSize);
+	const songCount = num(raw.musicSize);
+	const mvCount = num(raw.mvSize);
+	const avatarUrl = raw.picUrl ?? raw.img1v1Url ?? raw.avatar;
+	return {
+		id: num(raw.id) ?? 0,
+		name: raw.name ?? "",
+		...raw.alias?.length ? { alias: raw.alias } : {},
+		...avatarUrl ? { avatarUrl } : {},
+		...raw.briefDesc ? { briefDesc: raw.briefDesc } : {},
+		...albumCount !== void 0 ? { albumCount } : {},
+		...songCount !== void 0 ? { songCount } : {},
+		...mvCount !== void 0 ? { mvCount } : {},
+		...raw.followed !== void 0 ? { followed: raw.followed } : {}
+	};
+};
+const toArtists = (raws) => (raws ?? []).map(toArtist);
+const toAlbum = (raw) => {
+	const publishTime = num(raw.publishTime);
+	const size = num(raw.size);
+	const description = raw.description ?? raw.desc;
+	const artists = raw.artists ?? raw.ar;
+	return {
+		id: num(raw.id) ?? 0,
+		name: raw.name ?? "",
+		coverUrl: raw.picUrl ?? raw.coverImgUrl ?? "",
+		...artists?.length ? { artists: artists.map(toArtistRef) } : {},
+		...publishTime !== void 0 ? { publishTime } : {},
+		...raw.company ? { company: raw.company } : {},
+		...description ? { description } : {},
+		...size !== void 0 ? { size } : {}
+	};
+};
+const toAlbums = (raws) => (raws ?? []).map(toAlbum);
+const toPlaylistSummary = (raw) => {
+	const trackCount = num(raw.trackCount);
+	const playCount = num(raw.playCount);
+	const updateTime = num(raw.updateTime);
+	return {
+		id: num(raw.id) ?? 0,
+		name: raw.name ?? "",
+		coverUrl: raw.coverImgUrl ?? "",
+		...trackCount !== void 0 ? { trackCount } : {},
+		...playCount !== void 0 ? { playCount } : {},
+		...raw.creator ? { creator: toUserRef(raw.creator) } : {},
+		...raw.description ? { description: raw.description } : {},
+		...updateTime !== void 0 ? { updateTime } : {},
+		...raw.tags?.length ? { tags: raw.tags } : {}
+	};
+};
+const toPlaylistSummaries = (raws) => (raws ?? []).map(toPlaylistSummary);
+const toMvRef = (raw) => {
+	const playCount = num(raw.playCount);
+	const duration = num(raw.duration);
+	return {
+		id: num(raw.id) ?? 0,
+		name: raw.name ?? "",
+		coverUrl: raw.cover ?? raw.picUrl ?? raw.imgurl16v9 ?? raw.imgurl ?? "",
+		...playCount !== void 0 ? { playCount } : {},
+		...duration !== void 0 ? { duration } : {},
+		...raw.artistName ? { artistName: raw.artistName } : {}
+	};
+};
+const toMvRefs = (raws) => (raws ?? []).map(toMvRef);
+const toVideoRef = (raw) => {
+	const playCount = num(raw.playCount);
+	const duration = num(raw.duration);
+	return {
+		id: num(raw.vid ?? raw.id) ?? 0,
+		name: raw.title ?? raw.name ?? "",
+		coverUrl: raw.coverUrl ?? "",
+		...playCount !== void 0 ? { playCount } : {},
+		...duration !== void 0 ? { duration } : {},
+		...raw.creator ? { creator: toUserRef(raw.creator) } : {}
+	};
+};
+const toVideoRefs = (raws) => (raws ?? []).map(toVideoRef);
+//#endregion
+//#region src/apis/require.ts
+/** 上游响应缺少预期容器时直接报错，不返回伪造的空结果。 */
+const requireField = (value, uri, status, field) => {
+	if (value === void 0) throw new NeteaseApiError(uri, -1, status, {
+		code: -1,
+		msg: `响应缺少 ${field}`
+	});
+	return value;
+};
+//#endregion
+//#region src/apis/album.ts
+const URI_ALBUM = "/api/v1/album";
+const URI_ALBUM_PRODUCT = "/api/vipmall/albumproduct/detail";
+const URI_ALBUM_DYNAMIC = "/api/album/detail/dynamic";
+const URI_ALBUM_SALE_BOARD = "/api/feealbum/songsaleboard";
+const URI_ALBUM_PRIVILEGE = "/api/album/privilege";
+const URI_ALBUM_LIST = "/api/vipmall/albumproduct/list";
+const URI_NEW_ALBUM = "/api/discovery/newAlbum";
+/** 数字专辑/单曲产品与销售榜条目共用的「产品式」字段命名。 */
+const toProductAlbum = (raw) => {
+	const publishTime = num(raw.publishTime ?? raw.pubTime);
+	return {
+		id: num(raw.albumId ?? raw.id) ?? 0,
+		name: raw.albumName ?? raw.name ?? "",
+		coverUrl: raw.coverUrl ?? raw.picUrl ?? "",
+		...publishTime !== void 0 ? { publishTime } : {}
+	};
+};
+const toAlbumPrivilege = (raw) => {
+	const pl = num(raw.pl);
+	const dl = num(raw.dl);
+	const fl = num(raw.fl);
+	const st = num(raw.st);
+	const fee = num(raw.fee);
+	return {
+		id: num(raw.id) ?? 0,
+		...raw.maxBrLevel ? { maxBrLevel: raw.maxBrLevel } : {},
+		...raw.playMaxBrLevel ? { playMaxBrLevel: raw.playMaxBrLevel } : {},
+		...raw.downloadMaxBrLevel ? { downloadMaxBrLevel: raw.downloadMaxBrLevel } : {},
+		...pl !== void 0 ? { pl } : {},
+		...dl !== void 0 ? { dl } : {},
+		...fl !== void 0 ? { fl } : {},
+		...st !== void 0 ? { st } : {},
+		...fee !== void 0 ? { fee } : {}
+	};
+};
+const getAlbum = async (id, options) => {
+	const uri = `${URI_ALBUM}/${id}`;
+	const res = await request(uri, {}, "weapi", options);
+	const body = res.body;
+	return {
+		...toAlbum(requireField(body.album, uri, res.status, "album")),
+		...body.songs ? { songs: toSongs(body.songs) } : {}
+	};
+};
+const getAlbumProduct = async (id, options) => {
+	const res = await request(URI_ALBUM_PRODUCT, { id }, "weapi", options);
+	const body = res.body;
+	const album = requireField(body.album, URI_ALBUM_PRODUCT, res.status, "album");
+	const price = num(body.product?.price);
+	const publishTime = num(body.product?.pubTime);
+	return {
+		id: num(album.albumId) ?? 0,
+		name: album.albumName ?? "",
+		coverUrl: album.coverUrl ?? "",
+		...album.artistName ? { artistName: album.artistName } : {},
+		...price !== void 0 ? { price } : {},
+		...publishTime !== void 0 ? { publishTime } : {}
+	};
+};
+const getAlbumDynamic = async (id, options) => {
+	const body = (await request(URI_ALBUM_DYNAMIC, { id }, "weapi", options)).body;
+	const commentCount = num(body.commentCount);
+	const shareCount = num(body.shareCount);
+	const subCount = num(body.subCount);
+	const likedCount = num(body.likedCount);
+	return {
+		...commentCount !== void 0 ? { commentCount } : {},
+		...shareCount !== void 0 ? { shareCount } : {},
+		...subCount !== void 0 ? { subCount } : {},
+		...likedCount !== void 0 ? { likedCount } : {},
+		...body.isSub !== void 0 ? { isSub: body.isSub } : {}
+	};
+};
+const getAlbumSaleBoard = async (params, options) => {
+	const type = params.type ?? "daily";
+	const uri = `${URI_ALBUM_SALE_BOARD}/${type}/type`;
+	const data = { albumType: params.albumType ?? 0 };
+	if (type === "year") data.year = params.year;
+	return { albums: ((await request(uri, data, "weapi", options)).body.products ?? []).map(toProductAlbum) };
+};
+const getAlbumPrivileges = async (id, options) => {
+	return ((await request(URI_ALBUM_PRIVILEGE, { id }, "eapi", options)).body.data ?? []).map(toAlbumPrivilege);
+};
+const getAlbumList = async (params, options) => {
+	const body = (await request(URI_ALBUM_LIST, {
+		limit: params.limit ?? 30,
+		offset: params.offset ?? 0,
+		total: true,
+		area: params.area ?? "ALL",
+		type: params.type
+	}, "weapi", options)).body;
+	const total = num(body.total);
+	const products = body.products ?? body.albums;
+	return {
+		...total !== void 0 ? { total } : {},
+		...body.more !== void 0 ? { more: body.more } : {},
+		albums: products?.some(hasProductFields) ? products.map(toProductAlbum) : toAlbums(body.albums)
+	};
+};
+const PRODUCT_KEYS = [
+	"albumId",
+	"albumName",
+	"artistName"
+];
+const hasProductFields = (raw) => PRODUCT_KEYS.some((key) => key in raw);
+const getNewestAlbums = async (options) => {
+	const body = (await request(URI_NEW_ALBUM, {}, "weapi", options)).body;
+	return toAlbums(body.albums);
+};
+//#endregion
+//#region src/apis/artist.ts
+const URI_ARTIST = "/api/v1/artist";
+const URI_ARTIST_HEAD_INFO = "/api/artist/head/info/get";
+const URI_ARTIST_SONGS = "/api/v1/artist/songs";
+const URI_ARTIST_TOP_SONG = "/api/artist/top/song";
+const URI_ARTIST_ALBUMS = "/api/artist/albums";
+const URI_ARTIST_LIST = "/api/v1/artist/list";
+const URI_ARTIST_INTRO = "/api/artist/introduction";
+const URI_ARTIST_MVS = "/api/artist/mvs";
+const URI_ARTIST_VIDEO = "/api/mlog/artist/video";
+const toArtistInitial = (value) => {
+	if (typeof value !== "string" || !Number.isNaN(Number(value))) return value;
+	return value.toUpperCase().charCodeAt(0) || void 0;
+};
+const getArtist = async (id, options) => {
+	const uri = `${URI_ARTIST}/${id}`;
+	const res = await request(uri, {}, "weapi", options);
+	const body = res.body;
+	return {
+		...toArtist(requireField(body.artist, uri, res.status, "artist")),
+		...body.hotSongs ? { topSongs: toSongs(body.hotSongs) } : {}
+	};
+};
+const getArtistDetail = async (id, options) => {
+	const res = await request(URI_ARTIST_HEAD_INFO, { id }, "eapi", options);
+	const body = res.body;
+	return toArtist(body.data?.artist ?? body.data ?? requireField(body.artist, URI_ARTIST_HEAD_INFO, res.status, "artist"));
+};
+const getArtistSongs = async (params, options) => {
+	const body = (await request(URI_ARTIST_SONGS, {
+		id: params.id,
+		private_cloud: "true",
+		work_type: 1,
+		order: params.order ?? "hot",
+		offset: params.offset ?? 0,
+		limit: params.limit ?? 100
+	}, "eapi", options)).body;
+	return toSongs(body.songs);
+};
+const getArtistTopSongs = async (id, options) => {
+	const body = (await request(URI_ARTIST_TOP_SONG, { id }, "weapi", options)).body;
+	return toSongs(body.songs);
+};
+const getArtistAlbums = async (params, options) => {
+	const body = (await request(`${URI_ARTIST_ALBUMS}/${params.id}`, {
+		limit: params.limit ?? 30,
+		offset: params.offset ?? 0,
+		total: true
+	}, "weapi", options)).body;
+	const total = num(body.total);
+	return {
+		...total !== void 0 ? { total } : {},
+		...body.more !== void 0 ? { more: body.more } : {},
+		albums: toAlbums(body.hotAlbums)
+	};
+};
+const getArtistList = async (params, options) => {
+	const body = (await request(URI_ARTIST_LIST, {
+		initial: toArtistInitial(params.initial),
+		offset: params.offset ?? 0,
+		limit: params.limit ?? 30,
+		total: true,
+		type: params.type ?? "1",
+		area: params.area
+	}, "weapi", options)).body;
+	const total = num(body.total ?? body.artistCount);
+	return {
+		...total !== void 0 ? { total } : {},
+		...body.more !== void 0 ? { more: body.more } : {},
+		artists: toArtists(body.artists)
+	};
+};
+const getArtistDesc = async (id, options) => {
+	const body = (await request(URI_ARTIST_INTRO, { id }, "weapi", options)).body;
+	return {
+		briefDesc: body.briefDesc ?? "",
+		sections: (body.introduction ?? []).map((item) => ({
+			title: item.ti ?? "",
+			text: item.tx ?? ""
+		}))
+	};
+};
+const getArtistMvs = async (params, options) => {
+	const body = (await request(URI_ARTIST_MVS, {
+		artistId: params.id,
+		limit: params.limit,
+		offset: params.offset,
+		total: true
+	}, "weapi", options)).body;
+	return toMvRefs(body.mvs);
+};
+const getArtistVideos = async (params, options) => {
+	const body = (await request(URI_ARTIST_VIDEO, {
+		artistId: params.id,
+		page: JSON.stringify({
+			size: params.size ?? 10,
+			cursor: params.cursor ?? 0
+		}),
+		tab: 0,
+		order: params.order ?? 0
+	}, "weapi", options)).body;
+	const data = body.data ?? {};
+	const videos = [];
+	for (const record of data.records ?? []) {
+		const base = record.resource?.mlogBaseData;
+		const id = num(base?.id);
+		if (id === void 0) continue;
+		const playCount = num(record.resource?.mlogExtVO?.playCount);
+		const duration = num(base?.duration);
+		videos.push({
+			id,
+			name: base?.text ?? "",
+			coverUrl: base?.coverUrl ?? "",
+			...playCount !== void 0 ? { playCount } : {},
+			...duration !== void 0 ? { duration } : {}
+		});
+	}
+	return {
+		hasMore: data.page?.more ?? body.hasMore ?? false,
+		videos
+	};
+};
+//#endregion
+//#region src/utils/parseRelatedPlaylists.ts
+const RELATED_PLAYLIST = /<div class="cver u-cover u-cover-3">[\s\S]*?<img src="([^"]+)">[\s\S]*?<a class="sname f-fs1 s-fc0" href="([^"]+)"[^>]*>([^<]+?)<\/a>[\s\S]*?<a class="nm nm f-thide s-fc3" href="([^"]+)"[^>]*>([^<]+?)<\/a>/g;
+const parseRelatedPlaylists = (html) => {
+	const playlists = [];
+	for (const match of html.matchAll(RELATED_PLAYLIST)) {
+		const [, cover = "", playlistHref = "", name = "", userHref = "", user = ""] = match;
+		playlists.push({
+			id: Number(playlistHref.replace("/playlist?id=", "")),
+			name,
+			coverUrl: cover.replace(/\?param=.*$/, ""),
+			creator: {
+				id: Number(userHref.replace("/user/home?id=", "")),
+				name: user
+			}
+		});
+	}
+	return playlists;
+};
+//#endregion
 //#region src/utils/mergeLyricTimelines.ts
 function mergeLyricTimelines(original, translation) {
 	const originalMap = /* @__PURE__ */ new Map();
@@ -23,61 +663,459 @@ function mergeLyricTimelines(original, translation) {
 	return result;
 }
 //#endregion
-//#region src/index.ts
-const BASE_URL = "https://music.163.com/api/";
-const getPlaylistDetail = async (id) => {
-	const data = await (await fetch(`${BASE_URL}/v6/playlist/detail?id=${id}`)).json();
-	return {
-		id: data.playlist.id,
-		name: data.playlist.name,
-		coverImgId: data.playlist.coverImgId,
-		coverImgUrl: data.playlist.coverImgUrl,
-		userId: data.playlist.userId,
-		createTime: data.playlist.createTime,
-		songs: data.playlist.trackIds.map((t) => ({
-			id: t.id,
-			addTime: t.at
-		}))
-	};
-};
+//#region src/utils/parseLrc.ts
 const parseLrc = (lrc) => lrc.split("\n").filter((l) => l.startsWith("[")).map((l) => {
 	const match = l.match(/^\[(\d{2}):(\d{2}(?:\.\d{2,3})?)\](.*)/);
 	if (!match) return null;
-	const minutes = parseInt(match[1], 10);
-	const seconds = parseFloat(match[2]);
+	const [, minutes = "0", seconds = "0", text = ""] = match;
 	return {
-		time: minutes * 60 + seconds,
-		text: match[3].trim()
+		time: parseInt(minutes, 10) * 60 + parseFloat(seconds),
+		text: text.trim()
 	};
 }).filter((e) => e !== null);
-const getLyric = async (id) => {
-	const data = await (await fetch(`${BASE_URL}/song/lyric?id=${id}&lv=-1&tv=-1`)).json();
-	return {
-		lines: mergeLyricTimelines(parseLrc(data.lrc.lyric), data.tlyric?.lyric ? parseLrc(data.tlyric.lyric) : []),
-		...data.transUser ? { translator: data.transUser } : {}
-	};
-};
-const getSongsDetail = async (ids) => {
-	const query = JSON.stringify(ids.map((id) => ({ id })));
-	return (await (await fetch(`${BASE_URL}/v3/song/detail?c=${query}`)).json()).songs.map((s) => ({
-		id: s.id,
-		name: s.name,
-		artists: s.ar.map((a) => ({
-			id: a.id,
-			name: a.name
-		})),
-		album: {
-			id: s.al.id,
-			name: s.al.name,
-			picUrl: s.al.picUrl
-		},
-		duration: s.dt
+//#endregion
+//#region src/utils/parseYrc.ts
+const YRC_LINE = /^\[(\d+),(\d+)\](.*)$/;
+const YRC_WORD = /(\d+),(\d+),\d+,(\d+)\)([^()]*)/g;
+const parseYrc = (yrc) => {
+	const lines = [];
+	for (const raw of yrc.split("\n")) {
+		const match = raw.match(YRC_LINE);
+		if (!match) continue;
+		const [, start = "0", span = "0", body = ""] = match;
+		const words = [];
+		for (const word of body.matchAll(YRC_WORD)) {
+			const [, wordStart = "0", , wordSpan = "0", text = ""] = word;
+			words.push({
+				time: Number(wordStart),
+				duration: Number(wordSpan),
+				text
+			});
+		}
+		lines.push({
+			time: Number(start),
+			duration: Number(span),
+			words
+		});
+	}
+	return lines;
+};
+//#endregion
+//#region src/apis/song.ts
+const URI_SONG_DETAIL = "/api/v3/song/detail";
+const URI_SONG_URL = "/api/song/enhance/player/url";
+const URI_LYRIC = "/api/song/lyric";
+const URI_LYRIC_NEW = "/api/song/lyric/v1";
+const URI_SIMI_SONG = "/api/link/position/show/resource";
+const buildSongDetailQuery = (ids) => `[${ids.map((id) => `{"id":${id}}`).join(",")}]`;
+const getSongsDetail = async (ids, options) => {
+	const body = (await request(URI_SONG_DETAIL, { c: buildSongDetailQuery(ids) }, "weapi", options)).body;
+	return toSongs(body.songs);
+};
+const readFreeTrialInfo = (raw) => {
+	if (!raw) return void 0;
+	const start = num(raw.start);
+	const end = num(raw.end);
+	if (start === void 0 || end === void 0) return void 0;
+	return {
+		start,
+		end
+	};
+};
+const getSongUrl = async (params, options) => {
+	const ids = String(params.id).split(",");
+	const items = [...(await request(URI_SONG_URL, {
+		ids: JSON.stringify(ids),
+		br: params.br ?? 999e3
+	}, "eapi", options)).body.data ?? []].sort((a, b) => ids.indexOf(String(a.id)) - ids.indexOf(String(b.id)));
+	const urls = [];
+	for (const item of items) {
+		const id = num(item.id);
+		if (id === void 0) continue;
+		const fee = num(item.fee);
+		const freeTrialInfo = readFreeTrialInfo(item.freeTrialInfo);
+		urls.push({
+			id,
+			url: item.url ?? null,
+			br: num(item.br) ?? 0,
+			size: num(item.size) ?? 0,
+			...item.level ? { level: item.level } : {},
+			...fee !== void 0 ? { fee } : {},
+			...freeTrialInfo !== void 0 ? { freeTrialInfo } : {}
+		});
+	}
+	return urls;
+};
+const getLyric = async (id, options) => {
+	const body = (await request(URI_LYRIC, {
+		id,
+		tv: -1,
+		lv: -1,
+		rv: -1,
+		kv: -1,
+		_nmclfl: 1
+	}, "eapi", options)).body;
+	const translationText = body.tlyric?.lyric;
+	const translatorId = num(body.transUser?.id);
+	return {
+		lines: mergeLyricTimelines(parseLrc(body.lrc?.lyric ?? ""), translationText ? parseLrc(translationText) : []),
+		...translatorId !== void 0 ? { translator: {
+			id: translatorId,
+			nickname: body.transUser?.nickname ?? ""
+		} } : {}
+	};
+};
+const getLyricNew = async (id, options) => {
+	const body = (await request(URI_LYRIC_NEW, {
+		id,
+		cp: false,
+		tv: 0,
+		lv: 0,
+		rv: 0,
+		kv: 0,
+		yv: 0,
+		ytv: 0,
+		yrv: 0
+	}, "eapi", options)).body;
+	const translationText = body.tlyric?.lyric;
+	const romaText = body.romalrc?.lyric;
+	const yrcText = body.yrc?.lyric;
+	const wordLines = yrcText ? parseYrc(yrcText) : void 0;
+	return {
+		lines: mergeLyricTimelines(parseLrc(body.lrc?.lyric ?? ""), translationText ? parseLrc(translationText) : []),
+		...wordLines ? { wordLines } : {},
+		...romaText ? { romaLines: parseLrc(romaText) } : {}
+	};
+};
+const checkMusic = async (params, options) => {
+	const body = (await request(URI_SONG_URL, {
+		ids: `[${params.id}]`,
+		br: params.br ?? 999e3
+	}, "weapi", options)).body;
+	const first = body.data?.[0];
+	const available = num(body.code) === 200 && num(first?.code) === 200;
+	return {
+		available,
+		message: available ? "ok" : first?.message ?? "亲爱的,暂无版权"
+	};
+};
+const getSimilarSongs = async (id, options) => {
+	const res = await request(URI_SIMI_SONG, {
+		positionCode: "toolBarRcmdSong",
+		resourceId: id,
+		resourceType: "song"
+	}, "eapi", options);
+	const body = res.body;
+	const ids = [];
+	for (const item of body.data?.commonResourceList ?? []) {
+		const resourceId = num(item.extraMap?.songId ?? item.resourceId);
+		if (resourceId !== void 0) ids.push(resourceId);
+	}
+	if (ids.length > 0) return getSongsDetail(ids, options);
+	const songs = toSongs(body.songs);
+	if (songs.length > 0) return songs;
+	throw new NeteaseApiError(URI_SIMI_SONG, -1, res.status, {
+		code: -1,
+		msg: "相似歌曲响应中未找到歌曲 id"
+	});
+};
+//#endregion
+//#region src/apis/playlist.ts
+const URI_PLAYLIST_DETAIL = "/api/v6/playlist/detail";
+const URI_PLAYLIST_DYNAMIC = "/api/playlist/detail/dynamic";
+const URI_HIGH_QUALITY_TAGS = "/api/playlist/highquality/tags";
+const URI_PLAYLIST_LIST = "/api/playlist/list";
+const URI_HIGH_QUALITY_LIST = "/api/playlist/highquality/list";
+const URI_PLAYLIST_CATALOGUE = "/api/playlist/catalogue";
+const getPlaylistDetail = async (id, options) => {
+	const { playlist } = (await request(URI_PLAYLIST_DETAIL, {
+		id,
+		n: 1e5,
+		s: 8
+	}, "eapi", options)).body;
+	const songs = [];
+	for (const track of playlist.trackIds ?? []) {
+		const trackId = num(track.id);
+		const addTime = num(track.at);
+		if (trackId === void 0 || addTime === void 0) continue;
+		songs.push({
+			id: trackId,
+			addTime
+		});
+	}
+	return {
+		id: num(playlist.id) ?? 0,
+		name: playlist.name ?? "",
+		creatorId: num(playlist.userId) ?? 0,
+		coverUrl: playlist.coverImgUrl ?? "",
+		createTime: num(playlist.createTime) ?? 0,
+		songs
+	};
+};
+const getPlaylistTracks = async (params, options) => {
+	const { playlist } = (await request(URI_PLAYLIST_DETAIL, {
+		id: params.id,
+		n: 1e5,
+		s: 8
+	}, "eapi", options)).body;
+	const offset = params.offset ?? 0;
+	const limit = params.limit ?? 1e3;
+	const ids = [];
+	for (const track of (playlist.trackIds ?? []).slice(offset, offset + limit)) {
+		const trackId = num(track.id);
+		if (trackId !== void 0) ids.push(trackId);
+	}
+	return getSongsDetail(ids, options);
+};
+const getPlaylistDetailDynamic = async (id, options) => {
+	const body = (await request(URI_PLAYLIST_DYNAMIC, {
+		id,
+		n: 1e5,
+		s: 8
+	}, "eapi", options)).body;
+	const commentCount = num(body.commentCount);
+	const shareCount = num(body.shareCount);
+	const playCount = num(body.playCount);
+	const subscribedCount = num(body.subscribedCount);
+	const playedCount = num(body.playedCount);
+	return {
+		...commentCount !== void 0 ? { commentCount } : {},
+		...shareCount !== void 0 ? { shareCount } : {},
+		...playCount !== void 0 ? { playCount } : {},
+		...subscribedCount !== void 0 ? { subscribedCount } : {},
+		...playedCount !== void 0 ? { playedCount } : {}
+	};
+};
+const getHighQualityTags = async (options) => {
+	return ((await request(URI_HIGH_QUALITY_TAGS, {}, "weapi", options)).body.tags ?? []).map((tag) => ({
+		name: tag.name ?? "",
+		hot: tag.hot ?? false
 	}));
 };
+const toPlaylistPage = (body) => {
+	const total = num(body.total);
+	return {
+		...total !== void 0 ? { total } : {},
+		...body.more !== void 0 ? { more: body.more } : {},
+		playlists: toPlaylistSummaries(body.playlists)
+	};
+};
+const getTopPlaylists = async (params, options) => {
+	return toPlaylistPage((await request(URI_PLAYLIST_LIST, {
+		cat: params.cat ?? "全部",
+		order: params.order ?? "hot",
+		limit: params.limit ?? 50,
+		offset: params.offset ?? 0,
+		total: true
+	}, "weapi", options)).body);
+};
+const getHighQualityPlaylists = async (params, options) => {
+	return toPlaylistPage((await request(URI_HIGH_QUALITY_LIST, {
+		cat: params.cat ?? "全部",
+		limit: params.limit ?? 50,
+		lasttime: params.before ?? 0,
+		total: true
+	}, "weapi", options)).body);
+};
+const getPlaylistCategories = async (options) => {
+	const body = (await request(URI_PLAYLIST_CATALOGUE, {}, "eapi", options)).body;
+	const categories = body.categories ?? {};
+	const sub = body.sub ?? [];
+	return Object.keys(categories).sort((a, b) => Number(a) - Number(b)).map((key) => {
+		const category = Number(key);
+		return {
+			name: categories[key] ?? "",
+			subcategories: sub.filter((item) => num(item.category) === category).map((item) => ({
+				name: item.name ?? "",
+				category
+			}))
+		};
+	});
+};
+const getRelatedPlaylists = async (id, options) => {
+	const url = `${WEAPI_DOMAIN}/playlist?id=${id}`;
+	const res = await getText(url, options?.timeout ?? 1e4);
+	if (res.status !== 200) throw new NeteaseApiError(url, -1, res.status, {
+		code: -1,
+		msg: res.text.slice(0, 200)
+	});
+	const playlists = parseRelatedPlaylists(res.text);
+	if (playlists.length === 0 || playlists.some((item) => !item.coverUrl)) throw new NeteaseApiError(url, -1, res.status, {
+		code: -1,
+		msg: "相关歌单页面结构可能已变化"
+	});
+	return playlists;
+};
+//#endregion
+//#region src/apis/search.ts
+const URI_SEARCH = "/api/search/get";
+const URI_SEARCH_VOICE = "/api/search/voice/get";
+const URI_CLOUD_SEARCH = "/api/cloudsearch/pc";
+const URI_SEARCH_SUGGEST = "/api/search/suggest/web";
+const URI_SEARCH_SUGGEST_KEYWORD = "/api/search/suggest/keyword";
+const URI_SEARCH_HOT = "/api/search/hot";
+const URI_HOT_SEARCH_DETAIL = "/api/hotsearchlist/get";
+const URI_DEFAULT_KEYWORD = "/api/search/defaultkeyword/get";
+const URI_SEARCH_MULTIMATCH = "/api/search/suggest/multimatch";
+const toSearchResult = (raw, total) => {
+	const lyrics = raw.lyrics?.map((item) => ({
+		id: num(item.id) ?? 0,
+		name: item.name ?? "",
+		artists: (item.artists ?? []).map(toArtistRef)
+	}));
+	return {
+		...raw.songs ? { songs: toSongs(raw.songs) } : {},
+		...raw.artists ? { artists: toArtists(raw.artists) } : {},
+		...raw.albums ? { albums: toAlbums(raw.albums) } : {},
+		...raw.playlists ? { playlists: toPlaylistSummaries(raw.playlists) } : {},
+		...raw.userprofiles ? { users: raw.userprofiles.map(toUserRef) } : {},
+		...raw.mvs ? { mvs: toMvRefs(raw.mvs) } : {},
+		...raw.videos ? { videos: toVideoRefs(raw.videos) } : {},
+		...lyrics ? { lyrics } : {},
+		...total !== void 0 ? { total } : {}
+	};
+};
+const toVoiceSearchResult = (raw, status) => {
+	const container = raw.result ?? {};
+	const songs = container.songs ?? raw.songs;
+	if (songs) return toSearchResult({
+		...container,
+		songs
+	}, num(container.songCount ?? raw.total));
+	const resources = container.resources ?? raw.resources;
+	if (resources) {
+		const radios = [];
+		for (const item of resources) {
+			const id = num(item.id ?? item.resourceId);
+			if (id === void 0) continue;
+			radios.push({
+				id,
+				name: item.name ?? item.title ?? "",
+				coverUrl: item.coverUrl ?? item.picUrl ?? "",
+				...item.djName ? { djName: item.djName } : {}
+			});
+		}
+		return { radios };
+	}
+	throw new NeteaseApiError(URI_SEARCH_VOICE, -1, status, {
+		code: -1,
+		msg: "响应中既没有 songs 也没有 resources"
+	});
+};
+const search = async (params, options) => {
+	if (params.type === 2e3) {
+		const voice = await request(URI_SEARCH_VOICE, {
+			keyword: params.keywords,
+			scene: "normal",
+			limit: params.limit ?? 30,
+			offset: params.offset ?? 0
+		}, "eapi", options);
+		return toVoiceSearchResult(voice.body, voice.status);
+	}
+	const body = (await request(URI_SEARCH, {
+		s: params.keywords,
+		type: params.type ?? 1,
+		limit: params.limit ?? 30,
+		offset: params.offset ?? 0
+	}, "eapi", options)).body;
+	const container = body.result ?? {};
+	return toSearchResult(container, num(container.songCount ?? container.albumCount ?? body.total));
+};
+const cloudSearch = async (params, options) => {
+	const body = (await request(URI_CLOUD_SEARCH, {
+		s: params.keywords,
+		type: params.type ?? 1,
+		limit: params.limit ?? 30,
+		offset: params.offset ?? 0,
+		total: true
+	}, "eapi", options)).body;
+	const container = body.result ?? {};
+	return toSearchResult(container, num(container.songCount ?? container.albumCount ?? body.total));
+};
+const getSearchSuggest = async (params, options) => {
+	const container = (await request(params.mobile ? URI_SEARCH_SUGGEST_KEYWORD : URI_SEARCH_SUGGEST, { s: params.keywords ?? "" }, "weapi", options)).body.result ?? {};
+	return {
+		keywords: container.order ?? [],
+		songs: toSongs(container.songs),
+		artists: toArtists(container.artists),
+		albums: toAlbums(container.albums)
+	};
+};
+const getHotSearches = async (options) => {
+	return ((await request(URI_SEARCH_HOT, { type: 1111 }, "eapi", options)).body.result?.hots ?? []).map((item) => ({
+		first: item.first ?? "",
+		...item.second !== void 0 && item.second !== null ? { second: item.second } : {},
+		...typeof item.third === "string" ? { third: item.third } : {}
+	}));
+};
+const getHotSearchDetail = async (options) => {
+	return ((await request(URI_HOT_SEARCH_DETAIL, {}, "weapi", options)).body.data ?? []).map((item, index) => ({
+		keyword: item.searchWord ?? "",
+		position: num(item.position) ?? index + 1,
+		...item.content ? { content: item.content } : {},
+		...item.iconUrl ? { iconUrl: item.iconUrl } : {}
+	}));
+};
+const getDefaultSearchKeyword = async (options) => {
+	const body = (await request(URI_DEFAULT_KEYWORD, {}, "eapi", options)).body;
+	return body.data?.realkeyword ?? body.data?.showKeyword ?? "";
+};
+const searchMultimatch = async (params, options) => {
+	const container = (await request(URI_SEARCH_MULTIMATCH, {
+		type: params.type ?? 1,
+		s: params.keywords ?? ""
+	}, "weapi", options)).body.result ?? {};
+	const songs = container.songs ?? container.song;
+	const artists = container.artists ?? container.artist;
+	const albums = container.albums ?? container.album;
+	const playlists = container.playlists ?? container.playlist;
+	return {
+		...songs ? { songs: toSongs(songs) } : {},
+		...artists ? { artists: toArtists(artists) } : {},
+		...albums ? { albums: toAlbums(albums) } : {},
+		...playlists ? { playlists: toPlaylistSummaries(playlists) } : {}
+	};
+};
+//#endregion
+//#region src/index.ts
 var src_default = {
-	getPlaylistDetail,
+	search,
+	cloudSearch,
+	getSearchSuggest,
+	getHotSearches,
+	getHotSearchDetail,
+	getDefaultSearchKeyword,
+	searchMultimatch,
+	getSongsDetail,
+	getSongUrl,
 	getLyric,
-	getSongsDetail
+	getLyricNew,
+	checkMusic,
+	getSimilarSongs,
+	getPlaylistDetail,
+	getPlaylistTracks,
+	getPlaylistDetailDynamic,
+	getHighQualityTags,
+	getTopPlaylists,
+	getHighQualityPlaylists,
+	getPlaylistCategories,
+	getRelatedPlaylists,
+	getArtist,
+	getArtistDetail,
+	getArtistSongs,
+	getArtistTopSongs,
+	getArtistAlbums,
+	getArtistList,
+	getArtistDesc,
+	getArtistMvs,
+	getArtistVideos,
+	getAlbum,
+	getAlbumProduct,
+	getAlbumDynamic,
+	getAlbumSaleBoard,
+	getAlbumPrivileges,
+	getAlbumList,
+	getNewestAlbums
 };
 //#endregion
-export { src_default as default, getLyric, getPlaylistDetail, getSongsDetail };
+export { NeteaseApiError, checkMusic, cloudSearch, src_default as default, getAlbum, getAlbumDynamic, getAlbumList, getAlbumPrivileges, getAlbumProduct, getAlbumSaleBoard, getArtist, getArtistAlbums, getArtistDesc, getArtistDetail, getArtistList, getArtistMvs, getArtistSongs, getArtistTopSongs, getArtistVideos, getDefaultSearchKeyword, getHighQualityPlaylists, getHighQualityTags, getHotSearchDetail, getHotSearches, getLyric, getLyricNew, getNewestAlbums, getPlaylistCategories, getPlaylistDetail, getPlaylistDetailDynamic, getPlaylistTracks, getRelatedPlaylists, getSearchSuggest, getSimilarSongs, getSongUrl, getSongsDetail, getTopPlaylists, request, search, searchMultimatch };