把一句想法变成 Suno 可唱歌词、风格提示词，并直接生成下载歌曲。 Turn a rough song idea into Suno-ready lyrics, style prompts, and downloaded music.

中文 | English

你想让 AI 写歌，最麻烦的通常不是一句歌词，而是整套可用于 Suno 的结构：Hook、段落标记、风格标签、排除风格、登录态、下载路径。

qiaomu-suno-master 把这些揉成一个 Agent Skill：先按专业歌曲结构写歌词，再调用本地 Rust suno CLI 生成并下载音乐。

• Suno-ready 歌词：[Verse]、[Chorus]、[Bridge]、[Hook] 等结构完整
• Style Description：例如 punk-rock, male-vocals, distorted-guitars, fast-tempo
• Exclude Styles：避免不想要的风格，例如 auto-tune, trap, overly-polished
• 三个歌名候选
• 不确定风格时，可先从 5000+ 音乐流派中推荐适合的 Suno tags
• 可选：直接生成并下载 MP3
• 面向音乐播放器/网站发布时，必须同时下载并校验带时间戳的 .lrc
• Manifest-first 工作流：用 song.manifest.json 记录标题、风格、clip IDs、MP3、LRC、封面和状态
• suno_doctor.py 预检本地 CLI、Node、Chrome/CDP 辅助和输出目录
• 从已有 Suno Clip ID 导出 MP3、视频/MTV、LRC、SRT、干净字幕、Markdown 歌词
• Chrome CDP 辅助：复用已登录 Chrome/Suno 会话
• Computer Use 网页生成路径：当 CLI/CDP 卡住时，直接操作 Suno Web UI，复制分享链接，再下载 MP3/LRC

npx skills add joeseesun/qiaomu-suno-master

验证：

ls ~/.agents/skills/qiaomu-suno-master

• 已安装 Rust suno CLI，或允许 skill 自动安装

  cargo install suno --locked
  suno --version

• 已登录 Suno

  suno auth --login
  suno auth

• 如果要复用 Chrome 登录态，Chrome 已开启远程调试

  打开：

  chrome://inspect/#remote-debugging
  

  勾选 Allow remote debugging for this browser instance。

用 qiaomu-suno-master 写一首朋克歌，主题是把音量打满

把这篇文章改成一首中文民谣，并生成 Suno 歌曲

生成一首世界音乐，女声男声合唱，鼓和长笛，下载到默认 Suno 文稿目录

我只有“深夜、空灵、梦幻”这几个感觉，先帮我选几个 Suno 风格再写歌

Skill 内置了 joeseesun/music-genre-finder 的风格数据库，可在写歌前把模糊情绪转成更精确的 Suno 风格标签：

~/.agents/skills/qiaomu-suno-master/scripts/find_music_genres.py \
  "深夜 空灵 梦幻" \
  --limit 5

也可以输出 JSON，方便后续自动生成 tags：

~/.agents/skills/qiaomu-suno-master/scripts/find_music_genres.py \
  "raw energetic punk" \
  --json

推荐做法：选 1-3 个主风格，再加人声、乐器、速度和情绪标签，例如：

garage-punk, punk-rock, raw-male-vocals, distorted-guitars, fast-tempo, anthemic

推荐先创建 manifest，再让统一工作流生成、下载、拉取 LRC 并回写状态：

python3 ~/.agents/skills/qiaomu-suno-master/scripts/run_workflow.py init \
  --manifest "$OUTPUT_DIR/song.manifest.json" \
  --title "把音量打满" \
  --style "punk-rock, male-vocals, distorted-guitars, fast-tempo" \
  --exclude "auto-tune, trap, overly-polished" \
  --lyrics-file ./lyrics.txt \
  --output-dir "$OUTPUT_DIR"

python3 ~/.agents/skills/qiaomu-suno-master/scripts/suno_doctor.py \
  --output-dir "$OUTPUT_DIR"

python3 ~/.agents/skills/qiaomu-suno-master/scripts/run_workflow.py generate \
  --manifest "$OUTPUT_DIR/song.manifest.json"

Dry-run 不会消耗 Suno 额度：

python3 ~/.agents/skills/qiaomu-suno-master/scripts/run_workflow.py generate \
  --manifest "$OUTPUT_DIR/song.manifest.json" \
  --dry-run

底层封装脚本仍可用于调试：

~/.agents/skills/qiaomu-suno-master/scripts/generate_with_suno.sh \
  --title "把音量打满" \
  --tags "punk-rock, male-vocals, distorted-guitars, fast-tempo" \
  --exclude "auto-tune, trap, overly-polished" \
  --lyrics-file ./lyrics.txt

默认输出到：

~/Documents/Suno/<歌曲名>/

除非你明确指定 --output-dir，不要把歌曲、字幕、LRC 或视频保存到当前项目目录。Agent 的当前工作目录通常只是执行上下文，不应该被当成音乐素材库。

默认会走 --captcha，优先使用上游 suno CLI 的 hCaptcha CDP solver 把请求真正提交到 Suno。

生成后下载到音乐播放器或网站发布目录时，不要只保存普通歌词。必须请求并校验 LRC：

~/.agents/skills/qiaomu-suno-master/scripts/download_clips.sh \
  --ids "<clip-id>" \
  --output-dir ./output \
  --lyrics \
  --lyrics-format lrc \
  --require-lrc

如果 --require-lrc 失败，说明 Suno 还没有返回真实对齐歌词，或下载到的是普通歌词。此时不要上传发布，稍后重试：

~/.agents/skills/qiaomu-suno-master/scripts/export_suno_assets.py \
  <clip-id> \
  --format lrc \
  --output ./output

~/.agents/skills/qiaomu-suno-master/scripts/validate_lrc.py ./output

如果这条路径在你的 Chrome 会话里报：

CDP Runtime.evaluate ws err: Connection reset...

如果你的会话里 captcha solver 不稳定，或你明确要跳过它：

~/.agents/skills/qiaomu-suno-master/scripts/generate_with_suno.sh ... --no-captcha

或传入 token：

~/.agents/skills/qiaomu-suno-master/scripts/generate_with_suno.sh ... --token "$HCAPTCHA_TOKEN"

当 CLI 提交卡住、CDP 确认弹窗不稳定，或你明确要求使用 Computer Use 时，走网页路径：

1. 打开 https://suno.com/create
2. 选择 Advanced 模式和目标模型
3. 填入 lyrics.txt、style tags、标题
4. 点击 Create，等待两条新歌曲出现在列表顶部
5. 逐条点击 Share，复制 Suno 分享链接
6. 解析分享链接里的真实 clip ID
7. 运行 manifest 下载流程：

python3 ~/.agents/skills/qiaomu-suno-master/scripts/run_workflow.py download \
  --manifest "$HOME/Documents/Suno/<歌曲名>/song.manifest.json" \
  --ids "ID1 ID2"

完整操作细节见：

references/computer-use-workflow.md

如果你已经有 Suno clip ID，可以直接导出字幕和素材：

~/.agents/skills/qiaomu-suno-master/scripts/export_suno_assets.py \
  <clip-id> \
  --format lyrics \
  --clean-srt

导出音频 + 视频/MTV + 全部歌词格式：

~/.agents/skills/qiaomu-suno-master/scripts/export_suno_assets.py \
  <clip-id> \
  --format all \
  --clean-srt

默认会按歌曲标题创建目录：

~/Documents/Suno/<歌曲名>/

格式说明：

• audio：下载音频
• video：下载 Suno 视频/MTV 文件（如果该 clip 可用）
• json：保存 timed lyrics 原始 JSON
• lrc：音乐播放器歌词
• srt：字幕文件
• md：带时间戳 Markdown 歌词，方便 AI/剪辑流程读取
• lyrics：等于 json,lrc,srt,md
• all：等于 audio,video,json,lrc,srt,md

清理已有 SRT：

~/.agents/skills/qiaomu-suno-master/scripts/clean_srt_for_mtv.py input.srt

• paperfoot/suno-cli：本 skill 使用的 Rust Suno CLI
• pasky/chrome-cdp-skill：本 skill vendored 的轻量 CDP helper
• joeseesun/suno-music-creator：歌词创作提示词来源之一
• joeseesun/music-genre-finder：音乐流派检索与推荐数据来源

• 生成音乐会消耗 Suno 账号额度。
• Chrome CDP 可以控制本地浏览器标签页，只在可信本机环境使用。
• Suno API 和网页流程可能变化；如失败，先运行 suno update --check 和 suno update。
• 视频/MTV 下载取决于 Suno 是否为该 clip 提供 video asset。
• 风格推荐来自流派数据库与关键词匹配，最终仍需按歌曲主题做审美取舍。

qiaomu-suno-master is an Agent Skill for turning a song brief into Suno-ready lyrics, style prompts, exclude tags, and generated audio through the local Rust suno CLI.

npx skills add joeseesun/qiaomu-suno-master

• Install the upstream suno CLI:

  cargo install suno --locked
  suno --version

• Authenticate Suno:

  suno auth --login
  suno auth

• Optional Chrome CDP login reuse:

  Open chrome://inspect/#remote-debugging and enable Allow remote debugging for this browser instance.

Use qiaomu-suno-master to write a punk song about turning the volume all the way up.

Turn this article into a Chinese folk song and generate it with Suno.

Generate a world music track with duet vocals, hand drums, flute, and cinematic energy.

I only know the mood: late-night, ethereal, dreamy. Pick a few Suno styles first, then write the song.

The skill includes genre data from joeseesun/music-genre-finder. Use it before writing lyrics when the style is vague:

~/.agents/skills/qiaomu-suno-master/scripts/find_music_genres.py \
  "late night ethereal dreamy" \
  --limit 5

~/.agents/skills/qiaomu-suno-master/scripts/generate_with_suno.sh \
  --title "Turn It Up" \
  --tags "punk-rock, male-vocals, distorted-guitars, fast-tempo" \
  --exclude "auto-tune, trap, overly-polished" \
  --lyrics-file ./lyrics.txt

The wrapper defaults to --no-captcha because the upstream CDP hCaptcha solver can be flaky in some Chrome sessions.

Default output:

~/Documents/Suno/<song-title>/

When the generated song will be uploaded to a music player or website, plain Suno prompt lyrics are not enough. Download and validate timestamped LRC:

~/.agents/skills/qiaomu-suno-master/scripts/download_clips.sh \
  --ids "<clip-id>" \
  --output-dir ./output \
  --lyrics \
  --lyrics-format lrc \
  --require-lrc

If the gate fails, retry aligned lyrics later and validate before publishing:

~/.agents/skills/qiaomu-suno-master/scripts/export_suno_assets.py \
  <clip-id> \
  --format lrc \
  --output ./output

~/.agents/skills/qiaomu-suno-master/scripts/validate_lrc.py ./output

For music.qiaomu.ai, do not publish Suno's original cover. Generate a fresh 1:1 album cover from the validated lyrics with qiaomu-image-generator:

python3 ~/.agents/skills/qiaomu-image-generator/scripts/generate.py \
  ./cover.visual_config.json \
  --workers 1 \
  --no-insert \
  --output ./cover.result.json

Use the album_cover template, album-mondo-cover style, a stable *-cover.png filename, and a lyric-derived symbolic visual description with no text. Upload that PNG as the track cover.

~/.agents/skills/qiaomu-suno-master/scripts/export_suno_assets.py \
  <clip-id> \
  --format all \
  --clean-srt

This can export audio, video/MTV assets, timed lyrics JSON, LRC, SRT, clean SRT, and Markdown lyrics. Without --output, exported files are saved to ~/Documents/Suno/<clip-title>/.

• paperfoot/suno-cli
• pasky/chrome-cdp-skill
• joeseesun/suno-music-creator