网易云音乐歌手状态记录工具 - 定时监控歌手信息变化

功能特性

强大而灵活的工具，满足您的所有音乐数据监控需求

定时监控

定时监控歌手详情（默认每小时），自动抓取最新数据，确保不遗漏任何重要变化

详细数据记录

记录歌手和用户的详细状态信息，包括专辑数量、音乐数量、MV数量等全方位数据

MD5去重

智能MD5去重机制，仅保存变化的数据，避免重复记录，节省存储空间

变更备注

自动生成变更备注，对比前后差异，清晰展示每次数据变化的具体内容

微信推送通知

支持Server酱微信推送通知，数据变化时第一时间接收提醒，随时随地掌握动态

Docker一键部署

提供完整的Docker支持，一键部署，开箱即用，支持内置MySQL或连接已有数据库

工作原理

简单的三步流程，轻松监控歌手数据变化

1

配置监控参数

设置环境变量，配置数据库连接、API地址和要监控的歌手ID列表

2

自动定时监控

程序按设定间隔自动获取歌手数据，MD5去重并记录变化到数据库

3

接收变化通知

发现数据变化时自动生成备注说明，并通过Server酱推送微信通知

快速开始

选择适合您的部署方式，快速开始监控歌手数据变化

Docker部署

推荐方式，无需本地Python环境，一键启动完整服务

# 1. 克隆项目

git clone https://github.com/samge/wyy-artist-recorder.git

# 2. 配置环境变量

cp .env.example .env

# 3. 启动服务（含MySQL）

docker-compose -f docker-compose.with-mysql.yml up -d --build

本地运行

适合开发者，需要本地Python环境和MySQL数据库

# 1. 安装依赖

pip install -r requirements.txt

# 2. 初始化数据库

执行 sql/init.sql 脚本

# 3. 运行程序

python src/main.py

技术栈

基于成熟稳定的技术构建，确保可靠性和性能

Py

Python 3.12

DB

MySQL 8.0

RQ

requests

PY

pymysql

TZ

pytz

ENV

python-dotenv

常见问题

快速了解项目使用中的常见问题

如何获取网易云音乐歌手ID？

访问网易云音乐网页版，进入歌手页面，URL中的数字部分即为歌手ID。例如：https://music.163.com/#/artist?id=122448251 中的 122448251 就是歌手ID。

支持同时监控多个歌手吗？

支持！在环境变量配置中，ARTIST_IDS 参数支持多个歌手ID，用逗号分隔即可。例如：ARTIST_IDS=122448251,123456789,987654321

如何配置Server酱微信推送？

1. 访问 Server酱官网 (https://sct.ftqq.com/) 注册账号；2. 获取您的 SendKey；3. 在 .env 文件中配置 SERVER_CHAN_SEND_KEY=your_send_key。配置完成后，数据变化时将自动推送微信通知。

数据库数据会持久化保存吗？

使用Docker部署时，MySQL数据会持久化存储在Docker volume中。即使容器重启或删除，数据仍然保留。如果使用 docker-compose down -v 命令，则会删除包括数据在内的所有内容。

如何查看和分析记录的数据？

可以通过MySQL客户端连接数据库进行查询。使用 docker-compose 部署时，可执行：docker exec -it wyy-mysql mysql -u root -pwyy_password --default-character-set=utf8mb4 -e "USE wyy_artist; SELECT * FROM artist_records;"

网易云音乐 歌手状态记录工具