Suno Music Creator — AI skill for Claude Code

suno-music-creator

AI 歌词创作大师 + Suno API 自动生成音乐。

安装

npx skills add joeseesun/suno-music-creator

Suno Music Creator

AI 歌词创作大师 + Suno API 自动生成音乐。

Token 管理

方法 1: 自动刷新 Token（推荐）⚡

**当用户说"刷新token"、"自动刷新token"、"更新suno token"时，执行：**

python ~/.claude/skills/suno-music-creator/scripts/auto_refresh_token.py

**工作原理：**

1. ✅ 检查 Chrome 是否开启远程调试（localhost:9222）
2. ✅ 查找已登录的 suno.com 页面
3. ✅ 通过 CDP (Chrome DevTools Protocol) 自动提取 JWT Token
4. ✅ 自动更新 .env 文件并重启 suno-api 服务

**前提条件：**

• Chrome 浏览器已开启远程调试
• 已在 Chrome 中登录 https://suno.com/create

**如果未开启远程调试：**

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug &

**优点：**

• 🚀 一键自动化，无需手动复制粘贴
• 🔒 直接从已登录的浏览器提取，安全可靠
• ⚡ 30秒内完成整个流程

---

方法 2: 手动更新 Token

**当用户说"换token：xxx"或"更新token：xxx"时，执行：**

python ~/.claude/skills/suno-music-creator/scripts/update_token.py ""

**检查当前 token 状态：**

python ~/.claude/skills/suno-music-creator/scripts/update_token.py --check

**功能说明：**

• 自动验证新 token 是否有效
• 更新 .env 文件
• 自动重启 suno-api 服务
• 显示 token 剩余有效时间

---

Quick Start

# 自动生成并下载音乐（推荐）
python ~/.claude/skills/suno-music-creator/scripts/generate_music.py \
  --prompt "深夜的火车站，流浪的旅人" \
  --title "无归人" \
  --tags "folk-rock, male-vocals, melancholic" \
  --download

# 指定模型
python ~/.claude/skills/suno-music-creator/scripts/generate_music.py \
  --prompt "城市的霓虹灯" \
  --title "夜行者" \
  --tags "indie-pop, synth" \
  --model chirp-bluejay \
  --download

# 查询已生成歌曲并下载
python ~/.claude/skills/suno-music-creator/scripts/generate_music.py \
  --status "song-id-1,song-id-2" \
  --download

**下载位置**：`~/Music/Suno/`

**歌词保存**：下载歌曲时会自动保存歌词文件（`.lyrics.json`），供 whisper-transcribe 纠错使用。

---

获取精准同步歌词 🎯 NEW!

**使用场景**：生成歌曲后，获取带时间戳的 LRC/SRT 格式歌词，用于制作 MTV 字幕或卡拉 OK。

# 获取单首歌曲的精准歌词（LRC + SRT）
python ~/.claude/skills/suno-music-creator/scripts/fetch_aligned_lyrics.