音乐专辑多功能爬虫

从多个音乐数据库搜索专辑，保存到本地，自动上传到豆瓣。

安装

pip install -r requirements.txt
playwright install chromium

快速开始

网页可视化界面（推荐，零门槛）

pip install fastapi uvicorn python-multipart
python gui/main.py

启动后浏览器自动打开，使用流程：

1. 在搜索框输入专辑名
2. 从列表中点击选择正确的专辑
3. 确认后自动保存并上传豆瓣

一行命令完成所有操作

./workflow.sh full "专辑名"

示例：搜索并添加 Immanuel Wilkins Quartet: Live at the Village Vanguard

./workflow.sh full "Immanuel Wilkins Village Vanguard"

交互流程：

1. 自动搜索 MusicBrainz 和 Apple Music
2. 显示结果列表，输入编号选择
3. 自动获取曲目列表和封面
4. 保存后询问是否上传豆瓣

单独命令

# 登录豆瓣（首次使用）
./workflow.sh login

# 搜索专辑
./workflow.sh search "专辑名"

# 添加专辑
./workflow.sh add "https://music.apple.com/cn/album/..."

# 列出本地专辑
./workflow.sh list

# 查看专辑详情
./workflow.sh show xmahll

# 上传到豆瓣
./workflow.sh upload xmahll

# 清空所有数据
./workflow.sh clear

# 检查环境
./workflow.sh check

工作流脚本命令

命令	说明
full <关键词>	交互式搜索 → 选择 → 添加 → 上传
search <关键词>	搜索专辑
add <URL>	添加专辑
list	列出本地专辑
show <ID>	显示专辑详情
upload <ID>	上传到豆瓣
clear	清空所有数据
login	登录豆瓣
check	检查环境配置

数据源

数据源	说明	备注
MusicBrainz	免费开源，数据全面	无需配置
Apple Music	封面丰富	无需配置
Discogs	信息详细	需要 API Key
Spotify	曲目全面	需要 API Key

配置 API（可选）

编辑 config.yaml：

# Spotify
scrapers:
  spotify:
    client_id: "your_client_id"
    client_secret: "your_client_secret"

# Discogs
  discogs:
    api_key: "your_api_key"

获取 API Keys:

• Spotify: https://developer.spotify.com/dashboard
• Discogs: https://www.discogs.com/settings/developers

更新日志

2025-04-03

• 新增网页可视化界面（gui/）：无需命令行，浏览器中完成全部操作
  • 输入专辑名即可搜索，列表展示结果（优先 Apple Music）
  • 点击选择后自动获取详情、保存并上传豆瓣
  • 启动命令：python gui/main.py

2025-04-02

• 优化专辑简介获取：优先从 Wikipedia 获取中文简介
  • Apple Music 爬虫新增专辑简介获取
  • MusicBrainz 爬虫支持三重容错获取 Wikipedia 简介（关系链接 → Wikidata → 标题搜索）
  • 简介获取优先级：Wikipedia（中文优先）> Discogs，跳过 Apple Music
• 优化封面上传流程：改为阻塞等待用户点击【下一步】，避免超时自动跳过
• workflow 提示：添加推荐选择 Apple Music 来源的提示

数据存储

data/
├── albums/       # 专辑 JSON 文件
├── images/       # 封面图片
└── cookies/      # 登录状态

打包成可执行文件

打包后的程序约 250MB，下载 Chromium 浏览器后约 500MB

macOS

cd gui
chmod +x build_mac.command
./build_mac.command

打包完成后：

1. 进入 dist/豆瓣专辑上传工具/ 目录
2. 双击 豆瓣专辑上传工具.app
3. 首次运行会自动下载 Chromium（约 200MB，请保持网络连接）

Windows

cd gui
build_win.bat

Linux

cd gui
pip install pyinstaller
pyinstaller app.spec --clean
./dist/豆瓣专辑上传工具/

注意事项

• 首次运行：会自动打开浏览器窗口用于豆瓣登录
• Chromium 下载：首次上传豆瓣时会自动下载（约 200MB）
• 数据位置：与项目源码共用 data/ 目录
• macOS 提示：如果提示"无法打开"，在终端运行：xattr -cr "dist/豆瓣专辑上传工具.app"