@sansenjian/qq-music-api 2.2.1 → 2.2.9

package/dist/module/apis/digitalAlbum/getDigitalAlbumLists.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'utf-8',
+        cmd: 'pc_index_new'
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/v8/fcg-bin/musicmall.fcg',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/downloadQQMusic.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../util/request"));
+exports.default = ({ method = 'get', params = {}, option = {} }) => {
+    const data = {
+        ...params,
+        format: 'jsonp',
+        jsonpCallback: 'MusicJsonCallback',
+        platform: 'yqq'
+    };
+    const options = {
+        ...option,
+        headers: {
+            host: 'y.qq.com',
+            referer: 'https://y.qq.com/',
+            ...(option.headers || {})
+        },
+        params: data
+    };
+    return (0, request_1.default)('/download/download.js', method, options, 'y')
+        .then(res => {
+        let response = res.data;
+        if (typeof response === 'string') {
+            const reg = /^\w+\(({[^()]+})\)$/;
+            const matches = response.match(reg);
+            if (matches) {
+                response = JSON.parse(matches[1]);
+            }
+        }
+        return {
+            status: 200,
+            body: {
+                response
+            }
+        };
+    })
+        .catch(error => {
+        console.log('error', error);
+        return {
+            body: {
+                error
+            }
+        };
+    });
+};

package/dist/module/apis/extend/getPlaylistTags.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlaylistTags = getPlaylistTags;
+exports.getPlaylistsByTag = getPlaylistsByTag;
+exports.getHotComments = getHotComments;
+exports.getSingerListByArea = getSingerListByArea;
+const config_1 = require("../../config");
+const u_common_1 = __importDefault(require("../u_common"));
+const apiResponse_1 = require("../../../util/apiResponse");
+/**
+ * 获取歌单标签列表
+ * @returns 歌单标签列表
+ */
+async function getPlaylistTags() {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        playlist: {
+            method: 'get_tags',
+            module: 'playlist.web_srf',
+            param: {}
+        }
+    };
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        }
+    }));
+}
+/**
+ * 根据标签获取歌单列表
+ * @param tagId - 标签 ID
+ * @param page - 页码
+ * @param num - 每页数量
+ * @returns 歌单列表
+ */
+async function getPlaylistsByTag(tagId = 1, page = 0, num = 20) {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        playlist: {
+            method: 'get_playlist_by_tag',
+            module: 'playlist.web_srf',
+            param: {
+                tag_id: tagId,
+                rec_type: 3,
+                show_list: 1,
+                sort: 1,
+                user_id: 0,
+                page: page,
+                num: num
+            }
+        }
+    };
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        }
+    }));
+}
+/**
+ * 获取热门评论
+ * @param id - 资源 ID（歌曲/歌单/专辑 ID）
+ * @param type - 资源类型 (1: 歌曲，2: 歌单，3: 专辑)
+ * @param page - 页码
+ * @param pagesize - 每页数量
+ * @returns 评论列表
+ */
+async function getHotComments(id, type = 1, page = 0, pagesize = 20) {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        comment: {
+            module: 'comment.CommentReadServer',
+            method: 'GetCommentList',
+            param: {
+                biztype: type,
+                bizid: id,
+                page: page,
+                pagesize: pagesize,
+                needhot: 1
+            }
+        }
+    };
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        }
+    }));
+}
+/**
+ * 获取歌手分类列表
+ * @param area - 地区 (1: 内地，2: 港台，3: 欧美，4: 韩国，5: 日本)
+ * @param sex - 性别 (1: 男歌手，2: 女歌手，3: 组合)
+ * @param genre - 流派 (1: 流行，2: 摇滚，3: 民谣等)
+ * @param page - 页码
+ * @param pagesize - 每页数量
+ * @returns 歌手列表
+ */
+async function getSingerListByArea(area = -1, sex = -1, genre = -1, page = 1, pagesize = 80) {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        singer: {
+            method: 'get_singer_list',
+            module: 'music.web_srf_svr',
+            param: {
+                area: area,
+                sex: sex,
+                genre: genre,
+                page: page,
+                pagesize: pagesize
+            }
+        }
+    };
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        }
+    }));
+}
+exports.default = {
+    getPlaylistTags,
+    getPlaylistsByTag,
+    getHotComments,
+    getSingerListByArea
+};

package/dist/module/apis/music/getLyric.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const lyricParse_1 = require("../../../util/lyricParse");
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {}, isFormat = false }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'utf-8',
+        pcachetime: Date.now()
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/lyric/fcgi-bin/fcg_query_lyric_new.fcg',
+        method: method,
+        options
+    }), {
+        transformData: (resData) => {
+            const lyricString = resData && resData.lyric && Buffer.from(resData.lyric, 'base64').toString();
+            const lyric = isFormat && lyricString ? (0, lyricParse_1.lyricParse)(lyricString) : lyricString;
+            return {
+                ...resData,
+                lyric
+            };
+        }
+    });
+};

package/dist/module/apis/music/getMusicPlay.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const UCommon_1 = __importDefault(require("../UCommon/UCommon"));
+const config_1 = require("../../config");
+const cookieResolver_1 = require("../../../util/cookieResolver");
+const DEFAULT_QUALITY = '128';
+const FILE_TYPE_MAP = {
+    m4a: { prefix: 'C400', suffix: '.m4a' },
+    128: { prefix: 'M500', suffix: '.mp3' },
+    320: { prefix: 'M800', suffix: '.mp3' },
+    ape: { prefix: 'A000', suffix: '.ape' },
+    flac: { prefix: 'F000', suffix: '.flac' }
+};
+const normalizeFirstValue = (value) => {
+    if (Array.isArray(value)) {
+        return normalizeFirstValue(value[0]);
+    }
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized || undefined;
+};
+const normalizeSongmidList = (songmid) => {
+    const values = Array.isArray(songmid) ? songmid : [songmid];
+    return values
+        .flatMap(value => {
+        if (typeof value !== 'string')
+            return [];
+        return value.split(',');
+    })
+        .map(item => item.trim())
+        .filter(Boolean);
+};
+const normalizeQuality = (value) => {
+    const quality = normalizeFirstValue(value) || String(value || '');
+    if (quality === 'm4a' || quality === 'ape' || quality === 'flac') {
+        return quality;
+    }
+    const numericQuality = Number(quality);
+    if (numericQuality === 320) {
+        return '320';
+    }
+    if (numericQuality === 128) {
+        return '128';
+    }
+    return DEFAULT_QUALITY;
+};
+const pickPlayableDomain = (sip) => {
+    if (!Array.isArray(sip))
+        return '';
+    const urls = sip.filter((item) => typeof item === 'string' && item.length > 0);
+    return (urls.find(url => !url.startsWith('http://ws')) ||
+        urls.find(url => url.startsWith('https://')) ||
+        urls[0] ||
+        '');
+};
+const joinUrl = (domain, path) => {
+    if (domain.endsWith('/') && path.startsWith('/')) {
+        return `${domain}${path.slice(1)}`;
+    }
+    if (!domain.endsWith('/') && !path.startsWith('/')) {
+        return `${domain}/${path}`;
+    }
+    return `${domain}${path}`;
+};
+const buildPlayUrl = (domain, info, guid) => {
+    if (!domain)
+        return '';
+    if (info.purl) {
+        return joinUrl(domain, info.purl);
+    }
+    // Fallback for payloads where purl is empty but vkey/filename are present.
+    if (info.vkey && info.filename) {
+        return `${joinUrl(domain, info.filename)}?vkey=${info.vkey}&guid=${guid}&fromtag=66`;
+    }
+    return '';
+};
+const resolveUin = (cookie) => {
+    const defaultUin = String(global.userInfo?.uin || global.userInfo?.loginUin || '0');
+    return (0, cookieResolver_1.extractUinFromCookie)(cookie) || defaultUin;
+};
+const getCookieFromOptions = (option) => {
+    if (!option || typeof option !== 'object') {
+        return undefined;
+    }
+    const headers = option.headers;
+    if (!headers || typeof headers !== 'object') {
+        return undefined;
+    }
+    const cookie = headers.Cookie || headers.cookie;
+    return typeof cookie === 'string' ? cookie : undefined;
+};
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const musicParams = params;
+    const songmidList = normalizeSongmidList(musicParams.songmid);
+    if (songmidList.length === 0) {
+        return {
+            status: 400,
+            body: {
+                data: {
+                    message: 'no songmid'
+                }
+            }
+        };
+    }
+    const justPlayUrl = (normalizeFirstValue(musicParams.resType) || 'play') === 'play';
+    const mediaId = normalizeFirstValue(musicParams.mediaId);
+    const quality = normalizeQuality(musicParams.quality);
+    const guid = String(config_1._guid || '1429839143');
+    const cookie = getCookieFromOptions(option);
+    const uin = resolveUin(cookie);
+    const fileType = FILE_TYPE_MAP[quality];
+    const filename = songmidList.map(item => `${fileType.prefix}${item}${mediaId || item}${fileType.suffix}`);
+    const requestPayload = {
+        req_0: {
+            module: 'vkey.GetVkeyServer',
+            method: 'CgiGetVkey',
+            param: {
+                filename,
+                guid,
+                songmid: songmidList,
+                songtype: [0],
+                uin,
+                loginflag: 1,
+                platform: '20'
+            }
+        },
+        loginUin: uin,
+        comm: {
+            uin,
+            format: 'json',
+            ct: 24,
+            cv: 0
+        }
+    };
+    const upstreamParams = {
+        format: 'json',
+        sign: 'zzannc1o6o9b4i971602f3554385022046ab796512b7012',
+        data: JSON.stringify(requestPayload)
+    };
+    try {
+        const response = await (0, UCommon_1.default)({
+            method: method,
+            params: upstreamParams,
+            option
+        });
+        const upstreamData = response.data;
+        const domain = pickPlayableDomain(upstreamData?.req_0?.data?.sip);
+        const midurlinfo = Array.isArray(upstreamData?.req_0?.data?.midurlinfo)
+            ? upstreamData.req_0.data.midurlinfo
+            : [];
+        const playUrl = {};
+        const midInfoMap = new Map();
+        midurlinfo.forEach(item => {
+            if (item.songmid) {
+                midInfoMap.set(item.songmid, item);
+            }
+        });
+        songmidList.forEach(songmid => {
+            const item = midInfoMap.get(songmid);
+            const url = item ? buildPlayUrl(domain, item, guid) : '';
+            playUrl[songmid] = {
+                url,
+                error: url ? undefined : '\u6682\u65e0\u64ad\u653e\u94fe\u63a5'
+            };
+        });
+        upstreamData.playUrl = playUrl;
+        return {
+            status: 200,
+            body: {
+                data: justPlayUrl ? { playUrl } : upstreamData
+            }
+        };
+    }
+    catch (error) {
+        return {
+            status: 502,
+            body: {
+                error: error instanceof Error ? error.message : error
+            }
+        };
+    }
+};

package/dist/module/apis/mv/getMvByTag.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'GB2312',
+        cmd: 'shoubo',
+        lan: 'all'
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/mv/fcgi-bin/getmv_by_tag',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/radio/getRadioLists.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'utf-8',
+        channel: 'radio',
+        page: 'index',
+        tpl: 'wk',
+        new: 1,
+        p: Math.round(1)
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/v8/fcg-bin/fcg_v8_radiolist.fcg',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/rank/getTopLists.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'utf-8',
+        platform: 'h5',
+        needNewCode: 1
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/v8/fcg-bin/fcg_myqq_toplist.fcg',
+        method: method,
+        options,
+        isUUrl: 'c'
+    }), {
+        transformData: (response) => {
+            if (typeof response === 'string') {
+                const reg = /^\w+\(({[^()]+})\)$/;
+                const matches = response.match(reg);
+                if (matches) {
+                    return JSON.parse(matches[1]);
+                }
+            }
+            return response;
+        }
+    });
+};

package/dist/module/apis/recommend/getDailyRecommend.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDailyRecommend = getDailyRecommend;
+exports.getPrivateFM = getPrivateFM;
+exports.getNewSongs = getNewSongs;
+const config_1 = require("../../config");
+const u_common_1 = __importDefault(require("../u_common"));
+const apiResponse_1 = require("../../../util/apiResponse");
+const DEFAULT_NEW_SONG_TYPE = 5;
+function normalizeNewSongType(areaId) {
+    return Number.isInteger(areaId) && areaId >= 1 && areaId <= 5
+        ? areaId
+        : DEFAULT_NEW_SONG_TYPE;
+}
+/**
+ * 获取每日推荐歌曲
+ * @param cookie - 用户 Cookie（可选，用于获取个性化推荐）
+ * @returns 每日推荐歌曲列表
+ */
+async function getDailyRecommend(cookie) {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        recommend: {
+            method: 'get_recommend',
+            module: 'music.web_srf_svr',
+            param: {
+                page: 0,
+                num: 20,
+                uin: 0,
+                login: 0
+            }
+        }
+    };
+    const headers = { 'Content-Type': 'application/json' };
+    if (cookie)
+        headers.cookie = cookie;
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers
+        }
+    }));
+}
+/**
+ * 获取私人 FM
+ * @param cookie - 用户 Cookie
+ * @returns 私人 FM 歌曲列表
+ */
+async function getPrivateFM(cookie) {
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        fm: {
+            method: 'GetPrivateFmPlaylist',
+            module: 'music.web_fm_svr',
+            param: {
+                enc: 'utf8',
+                moter: 0,
+                uin: 0,
+                login: 0
+            }
+        }
+    };
+    const headers = { 'Content-Type': 'application/json' };
+    if (cookie)
+        headers.cookie = cookie;
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers
+        }
+    }));
+}
+/**
+ * 获取新歌速递
+ * @param areaId - 地区 ID（兼容旧参数，当前映射到新歌类型，暂定映射关系）
+ * @param limit - 返回数量（当前上游接口固定类型，limit 仅用于兼容入参）
+ * @returns 新歌列表
+ */
+async function getNewSongs(areaId = DEFAULT_NEW_SONG_TYPE, limit = 20) {
+    const normalizedType = normalizeNewSongType(areaId);
+    const normalizedLimit = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 20;
+    const data = {
+        comm: {
+            ...config_1.commonParams,
+            ct: 24,
+            cv: 0
+        },
+        new_song: {
+            module: 'newsong.NewSongServer',
+            method: 'get_new_song_info',
+            param: {
+                type: normalizedType,
+                num: normalizedLimit
+            }
+        }
+    };
+    return (0, apiResponse_1.handleApi)((0, u_common_1.default)({
+        method: 'POST',
+        options: {
+            data: JSON.stringify(data),
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        }
+    }));
+}
+exports.default = {
+    getDailyRecommend,
+    getPrivateFM,
+    getNewSongs
+};