@sansenjian/qq-music-api 2.1.1 → 2.2.1

package/module/apis/songLists/songListCategories.ts

@@ -0,0 +1,22 @@
+import { handleApi } from '../../../util/apiResponse';
+import y_common from '../y_common';
+import type { ApiOptions } from '../../../types/api';
+
+export default async ({ method = 'get', params = {}, option = {} }: ApiOptions) => {
+	const data = {
+		...params,
+		format: 'json',
+		outCharset: 'utf-8'
+	};
+	const options = {
+		...option,
+		params: data
+	};
+	return handleApi(
+		y_common({
+			url: '/splcloud/fcgi-bin/fcg_get_diss_tag_conf.fcg',
+			method: method as string,
+			options
+		})
+	);
+};

package/module/apis/songLists/songListDetail.ts

@@ -0,0 +1,27 @@
+import { handleApi } from '../../../util/apiResponse';
+import y_common from '../y_common';
+import type { ApiOptions } from '../../../types/api';
+
+export default async ({ method = 'get', params = {}, option = {} }: ApiOptions) => {
+	const data = {
+		...params,
+		format: 'json',
+		outCharset: 'utf-8',
+		type: 1,
+		json: 1,
+		utf8: 1,
+		onlysong: 0,
+		new_format: 1
+	};
+	const options = {
+		...option,
+		params: data
+	};
+	return handleApi(
+		y_common({
+			url: '/qzone/fcg-bin/fcg_ucc_getcdinfo_byids_cp.fcg',
+			method: method as string,
+			options
+		})
+	);
+};

package/module/apis/songLists/songLists.ts

@@ -0,0 +1,35 @@
+import { handleApi } from '../../../util/apiResponse';
+import y_common from '../y_common';
+import type { ApiOptions } from '../../../types/api';
+
+export default async ({ method = 'get', params = {}, option = {} }: ApiOptions) => {
+	const data = {
+		...params,
+		format: 'json',
+		outCharset: 'utf-8',
+		picmid: 1
+	};
+	const options = {
+		...option,
+		params: data
+	};
+	return handleApi(
+		y_common({
+			url: '/splcloud/fcgi-bin/fcg_get_diss_by_tag.fcg',
+			method: method as string,
+			options
+		}),
+		{
+			transformData: (response: unknown) => {
+				if (typeof response === 'string') {
+					const reg = /^\w+\(([^()]+)\)$/;
+					const matches = response.match(reg);
+					if (matches) {
+						return JSON.parse(matches[1]);
+					}
+				}
+				return response;
+			}
+		}
+	);
+};

package/module/apis/u_common.ts

@@ -0,0 +1,29 @@
+import { AxiosRequestConfig, Method } from 'axios';
+import request from '../../util/request';
+import * as config from '../config';
+
+interface UCommonOptions {
+	options?: AxiosRequestConfig;
+	method?: Method | string;
+}
+
+export default ({ options = {}, method = 'get' }: UCommonOptions) => {
+	const opts: AxiosRequestConfig = { ...options };
+
+	// Merge commonParams into params for query string
+	opts.params = { ...config.commonParams, ...(opts.params || {}) };
+
+	opts.headers = {
+		referer: 'https://y.qq.com/portal/player.html',
+		host: 'u.y.qq.com',
+		'content-type': 'application/x-www-form-urlencoded',
+		...(opts.headers || {})
+	};
+
+	if (process.env.DEBUG === 'true') {
+		const logOpts = { ...opts, headers: { ...opts.headers, cookie: '[REDACTED]' } };
+		console.log('https://u.y.qq.com/cgi-bin/musicu.fcg', { opts: logOpts });
+	}
+
+	return request('https://u.y.qq.com/cgi-bin/musicu.fcg', method as Method, opts, 'u');
+};

package/module/apis/user/checkQQLoginQr.ts

@@ -0,0 +1,230 @@
+import type { ApiFunction, ApiOptions, ApiResponse } from '../../../types/api';
+import { customResponse, errorResponse } from '../../../util/apiResponse';
+import { getGtk, getGuid } from '../../../util/loginUtils';
+
+interface LoginSession {
+  loginUin: string;
+  uin: string;
+  cookie: string;
+  cookieList: string[];
+  cookieObject: Record<string, string>;
+}
+
+const REQUEST_TIMEOUT_MS = 10000;
+const DEBUG_ENABLED = process.env.DEBUG === 'true';
+
+const debugLog = (message: string, payload?: unknown) => {
+  if (DEBUG_ENABLED) {
+    console.log(`[checkQQLoginQr] ${message}`, payload ?? '');
+  }
+};
+
+const parseSetCookie = (setCookieHeader: string | null): string[] => {
+  if (!setCookieHeader) return [];
+  const cookies: string[] = [];
+  const parts = setCookieHeader.split(/,(?=\s*[a-zA-Z_]+=)/);
+  for (const part of parts) {
+    const cookiePair = part.split(';')[0].trim();
+    if (cookiePair && cookiePair.includes('=') && cookiePair.split('=')[1]) {
+      cookies.push(cookiePair);
+    }
+  }
+  return cookies;
+};
+
+const fetchWithTimeout = async (input: string, init: RequestInit = {}, timeout = REQUEST_TIMEOUT_MS) => {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+
+  try {
+    return await fetch(input, {
+      ...init,
+      signal: controller.signal
+    });
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+const buildLoginSession = (cookie: string): LoginSession => {
+  const cookieList = cookie
+    .split(';')
+    .map(item => item.trim())
+    .filter(Boolean);
+
+  const cookieObject: Record<string, string> = {};
+  cookieList.forEach(item => {
+    const [key, value = ''] = item.split('=');
+    if (key && value) {
+      cookieObject[key] = value;
+    }
+  });
+
+  const loginUin = cookieObject.uin || '';
+
+  return {
+    loginUin,
+    uin: loginUin,
+    cookie,
+    cookieList,
+    cookieObject
+  };
+};
+
+const checkQQLoginQr: ApiFunction = async ({ method = 'get', params = {}, option = {} }: ApiOptions): Promise<ApiResponse> => {
+  const { ptqrtoken, qrsig } = params;
+  if (!ptqrtoken || !qrsig) {
+    return errorResponse('参数错误', 400);
+  }
+
+  try {
+    const url = `https://ssl.ptlogin2.qq.com/ptqrlogin?u1=https%3A%2F%2Fgraph.qq.com%2Foauth2.0%2Flogin_jump&ptqrtoken=${ptqrtoken}&ptredirect=0&h=1&t=1&g=1&from_ui=1&ptlang=2052&action=0-0-1711022193435&js_ver=23111510&js_type=1&login_sig=du-YS1h8*0GqVqcrru0pXkpwVg2DYw-DtbFulJ62IgPf6vfiJe*4ONVrYc5hMUNE&pt_uistyle=40&aid=716027609&daid=383&pt_3rd_aid=100497308&&o1vId=3674fc47871e9c407d8838690b355408&pt_js_version=v1.48.1`;
+
+    const response = await fetchWithTimeout(url, { headers: { Cookie: `qrsig=${qrsig}` } });
+    const data = (await response.text()) || '';
+
+    const cookieMap = new Map<string, string>();
+    const setCookie = (setCookieHeader: string | null) => {
+      const cookies = parseSetCookie(setCookieHeader);
+      for (const cookie of cookies) {
+        const [name] = cookie.split('=');
+        cookieMap.set(name, cookie);
+      }
+    };
+
+    setCookie(response.headers.get('Set-Cookie'));
+
+    const refresh = data.includes('已失效');
+    if (!data.includes('登录成功')) {
+      return customResponse(
+        {
+          isOk: false,
+          refresh,
+          message: (refresh && '二维码已失效') || '未扫描二维码'
+        },
+        200
+      );
+    }
+
+    const allCookie = () => Array.from(cookieMap.values());
+
+    const urlMatch = data.match(/(?:'((?:https?|ftp):\/\/[^\s/$.?#].[^\s]*)')/g);
+    if (!urlMatch || !urlMatch[0]) {
+      return errorResponse('Failed to extract checkSigUrl from response', 502);
+    }
+    const checkSigUrl = urlMatch[0].replace(/'/g, '');
+    const checkSigRes = await fetchWithTimeout(checkSigUrl, {
+      redirect: 'manual',
+      headers: { Cookie: allCookie().join('; ') }
+    });
+
+    const checkSigCookie = checkSigRes.headers.get('Set-Cookie');
+    const pSkeyMatch = checkSigCookie?.match(/p_skey=([^;]+)/);
+    if (!pSkeyMatch || !pSkeyMatch[1]) {
+      return errorResponse('Failed to extract p_skey from response', 502);
+    }
+    const p_skey = pSkeyMatch[1];
+    const gtk = getGtk(p_skey);
+    setCookie(checkSigCookie);
+
+    const authorizeUrl = 'https://graph.qq.com/oauth2.0/authorize';
+
+    const getAuthorizeData = (g_tk: number) => {
+      const data = new FormData();
+      data.append('response_type', 'code');
+      data.append('client_id', '100497308');
+      data.append('redirect_uri', 'https://y.qq.com/portal/wx_redirect.html?login_type=1&surl=https://y.qq.com/');
+      data.append('scope', 'get_user_info,get_app_friends');
+      data.append('state', 'state');
+      data.append('switch', '');
+      data.append('from_ptlogin', '1');
+      data.append('src', '1');
+      data.append('update_auth', '1');
+      data.append('openapi', '1010_1030');
+      data.append('g_tk', g_tk.toString());
+      data.append('auth_time', new Date().toString());
+      data.append('ui', getGuid());
+      return data;
+    };
+
+    const authorizeRes = await fetchWithTimeout(authorizeUrl, {
+      redirect: 'manual',
+      method: 'POST',
+      body: getAuthorizeData(gtk),
+      headers: {
+        Cookie: allCookie().join('; ')
+      }
+    });
+    setCookie(authorizeRes.headers.get('Set-Cookie'));
+
+    const location = authorizeRes.headers.get('Location');
+    const contentType = authorizeRes.headers.get('Content-Type');
+
+    debugLog('authorize response meta', {
+      status: authorizeRes.status,
+      redirected: authorizeRes.redirected,
+      hasLocation: Boolean(location),
+      contentType
+    });
+
+    if (authorizeRes.status < 300 || authorizeRes.status >= 400 || !location) {
+      return errorResponse('授权响应异常，未返回跳转地址', 502);
+    }
+
+    const codeMatch = location.match(/[?&]code=([^&]+)/);
+    if (!codeMatch || !codeMatch[1]) {
+      debugLog('authorize location parse failed', { location });
+      return errorResponse('授权响应中未找到 code 参数', 502);
+    }
+    const code = codeMatch[1];
+
+    const getFcgReqData = (g_tk: number, code: string) => {
+      const data = {
+        comm: {
+          g_tk,
+          platform: 'yqq',
+          ct: 24,
+          cv: 0
+        },
+        req: {
+          module: 'QQConnectLogin.LoginServer',
+          method: 'QQLogin',
+          param: {
+            code
+          }
+        }
+      };
+      return JSON.stringify(data);
+    };
+
+    const loginUrl = 'https://u.y.qq.com/cgi-bin/musicu.fcg';
+    const loginRes = await fetchWithTimeout(loginUrl, {
+      method: 'POST',
+      body: getFcgReqData(gtk, code),
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded',
+        Cookie: allCookie().join('; ')
+      }
+    });
+    setCookie(loginRes.headers.get('Set-Cookie'));
+
+    const sessionCookie = allCookie().join('; ');
+
+    return customResponse(
+      {
+        isOk: true,
+        message: '登录成功',
+        session: buildLoginSession(sessionCookie)
+      },
+      200
+    );
+  } catch (error) {
+    if ((error as Error).name === 'AbortError') {
+      return errorResponse('登录检查超时', 504);
+    }
+
+    return errorResponse('登录检查失败', 502);
+  }
+};
+
+export default checkQQLoginQr;

package/module/apis/user/getQQLoginQr.ts

@@ -0,0 +1,28 @@
+import type { ApiFunction, ApiOptions } from '../../../types/api';
+import { customResponse, errorResponse } from '../../../util/apiResponse';
+import { hash33 } from '../../../util/loginUtils';
+
+const getQQLoginQr: ApiFunction = async ({ method = 'get', params = {}, option = {} }: ApiOptions) => {
+  try {
+    const url =
+      'https://ssl.ptlogin2.qq.com/ptqrshow?appid=716027609&e=2&l=M&s=3&d=72&v=4&t=0.9698127522807933&daid=383&pt_3rd_aid=100497308&u1=https%3A%2F%2Fgraph.qq.com%2Foauth2.0%2Flogin_jump';
+
+    const response = await fetch(url);
+    const data = await response.arrayBuffer();
+    const img = 'data:image/png;base64,' + (data && Buffer.from(data).toString('base64'));
+    const cookieHeader = response.headers.get('Set-Cookie');
+    const match = cookieHeader?.match(/qrsig=([^;]+)/);
+
+    if (!match) {
+      return errorResponse('Failed to get qrsig from response', 502);
+    }
+
+    const qrsig = match[1];
+
+    return customResponse({ img, ptqrtoken: hash33(qrsig), qrsig }, 200);
+  } catch (error) {
+    return errorResponse('Failed to fetch QQ login QR', 502);
+  }
+};
+
+export default getQQLoginQr;

package/module/apis/user/getUserAvatar.ts

@@ -0,0 +1,32 @@
+import request from '../../../util/request';
+
+// 获取 QQ 用户头像
+export const getUserAvatar = async (params: {
+  k?: string;
+  uin?: string;
+  size?: number;
+}) => {
+  const { k, uin, size = 140 } = params;
+  
+  // 如果提供了 k 参数，使用 k 参数获取头像
+  if (k) {
+    const url = `https://thirdqq.qlogo.cn/g?b=sdk&k=${k}&s=${size}`;
+    
+    return {
+      avatarUrl: url,
+      message: '头像 URL 获取成功'
+    };
+  }
+  
+  // 如果提供了 uin，尝试从 uin 获取头像
+  if (uin) {
+    const url = `https://q.qlogo.cn/headimg_dl?dst_uin=${uin}&spec=${size}`;
+    
+    return {
+      avatarUrl: url,
+      message: '头像 URL 获取成功'
+    };
+  }
+  
+  throw new Error('缺少 k 或 uin 参数');
+};

package/module/apis/user/getUserLikedSongs.ts

@@ -0,0 +1,145 @@
+import request from '../../../util/request';
+import { customResponse, errorResponse } from '../../../util/apiResponse';
+import type { ApiResponse } from '../../../types/api';
+
+interface LikedSong {
+  [key: string]: unknown;
+}
+
+const DEBUG_ENABLED = process.env.DEBUG === 'true';
+
+const debugLog = (message: string, payload?: unknown) => {
+  if (DEBUG_ENABLED) {
+    console.log(`[getUserLikedSongs] ${message}`, payload ?? '');
+  }
+};
+
+// 获取用户喜欢的歌曲列表
+// 注意：此接口需要有效的 QQ 音乐 Cookie 才能正常工作
+export const getUserLikedSongs = async (params: {
+  uin: string;
+  offset?: number;
+  limit?: number;
+}): Promise<ApiResponse> => {
+  const { uin, offset = 0, limit = 30 } = params;
+  const page = Math.floor(offset / limit) + 1;
+
+  // 使用 c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg 接口
+  // 通过 mymusic 字段获取用户喜欢的歌曲信息
+  const url = 'https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg';
+
+  try {
+    debugLog('request meta', {
+      url,
+      uin,
+      offset,
+      limit,
+      page,
+      hasGlobalCookie: Boolean(global.userInfo?.cookie),
+      cookieLength: global.userInfo?.cookie?.length || 0
+    });
+
+    const response = await request<Record<string, any>>({
+      url,
+      method: 'GET',
+      isUUrl: 'u',
+      options: {
+        params: {
+          _: Date.now(),
+          cv: 4747474,
+          ct: 24,
+          format: 'json',
+          inCharset: 'utf-8',
+          outCharset: 'utf-8',
+          notice: 0,
+          platform: 'yqq.json',
+          needNewCode: 0,
+          uin: Number.parseInt(uin, 10),
+          g_tk_new_20200303: 0,
+          g_tk: 0,
+          cid: 205360838,
+          userid: Number.parseInt(uin, 10),
+          reqfrom: 1,
+          reqtype: 0,
+          hostUin: 0,
+          loginUin: Number.parseInt(uin, 10)
+        },
+        headers: {
+          Referer: `https://y.qq.com/portal/profile.html?uin=${uin}`,
+          Cookie: global.userInfo?.cookie || ''
+        }
+      }
+    });
+
+    const payload = response.data;
+
+    debugLog('upstream payload summary', {
+      topLevelKeys: payload && typeof payload === 'object' ? Object.keys(payload) : null,
+      code: payload?.code,
+      hasData: Boolean(payload?.data),
+      dataKeys: payload?.data && typeof payload.data === 'object' ? Object.keys(payload.data) : []
+    });
+
+    if (!payload || typeof payload !== 'object') {
+      debugLog('invalid payload received', payload);
+      return errorResponse('用户喜欢的歌曲响应格式无效', 502);
+    }
+
+    if (typeof payload.code === 'number' && payload.code !== 0) {
+      debugLog('upstream business error payload', payload);
+      return errorResponse(payload.msg || payload.message || '获取用户喜欢的歌曲失败', 502);
+    }
+
+    // 从 mymusic 字段中提取喜欢的歌曲信息
+    // mymusic 数组中的第一个元素通常包含"我喜欢"歌单的信息
+    const mymusic = payload?.data?.mymusic;
+    let likedSongsInfo = null;
+
+    if (Array.isArray(mymusic)) {
+      // 查找"我喜欢"歌单（通常 title 包含"喜欢"或 type 为 1）
+      likedSongsInfo = mymusic.find((item: any) => {
+        return item?.title && (item.title.includes('喜欢') || item.type === 1);
+      });
+    }
+
+    debugLog('liked songs info', likedSongsInfo);
+
+    if (!likedSongsInfo) {
+      debugLog('no liked songs info found in mymusic');
+      return customResponse({ 
+        response: { 
+          code: 0, 
+          data: { 
+            songs: [],
+            total: 0,
+            hasMore: false
+          } 
+        } 
+      }, 200);
+    }
+
+    // 返回喜欢的歌曲信息（包含歌单 ID 和统计信息）
+    // 注意：完整的歌曲列表需要通过 musics.fcg 接口获取（需要二进制加密）
+    // 这里先返回歌单基本信息
+    return customResponse({ 
+      response: { 
+        code: 0, 
+        data: { 
+          songs: [likedSongsInfo],
+          total: likedSongsInfo.num0 || 0,
+          hasMore: false,
+          info: {
+            title: likedSongsInfo.title,
+            songCount: likedSongsInfo.num0,
+            albumCount: likedSongsInfo.num1,
+            playlistCount: likedSongsInfo.num2,
+            id: likedSongsInfo.id
+          }
+        } 
+      } 
+    }, 200);
+  } catch (error) {
+    console.error('获取用户喜欢的歌曲失败:', error);
+    return errorResponse((error as Error).message || '获取用户喜欢的歌曲失败', 502);
+  }
+};