Communitygithub.com

sunopull-download

Baixe uma música do Suno publicamente acessível através do SunoPull. Use quando o usuário solicitar explicitamente o download ou salvamento de uma música do Suno a partir de um link de música, Hook ou compartilhamento.

O que é sunopull-download?

Esta skill permite baixar uma única música do Suno que esteja publicamente acessível através da ferramenta SunoPull. Ela é útil para desenvolvedores e usuários que desejam salvar localmente uma faixa do Suno a partir de um link de música, Hook ou compartilhamento, preservando o formato de áudio original (MP3, M4A ou WAV). A skill não suporta conversão de formatos, download de álbuns, playlists, letras ou capas. A skill funciona no Claude Code, Cursor, Codex e outras plataformas que executam comandos em terminal, utilizando um script Node.js que resolve o link público e faz o download do áudio disponível. Importante: a skill só deve ser usada quando o usuário explicitamente pedir para baixar ou salvar a música, e não apenas com um link colado. O script não sobrescreve arquivos existentes e não deve ser usado para acessar músicas privadas ou contornar restrições de conta do Suno.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sunopull/suno-downloader-skill/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Baixar uma música do Suno com SunoPull

Use esta skill apenas quando o usuário solicitar o download ou salvamento de uma música. Um link colado por si só não é uma solicitação de download.

Entrada suportada

  • Uma música do Suno publicamente acessível, Hook ou link de compartilhamento.
  • O download preserva o formato de áudio original exposto para aquela música (MP3, M4A ou WAV).
  • Esta primeira versão não converte formatos nem baixa álbuns, playlists, letras ou capas.

Fluxo de trabalho

  1. Confirme que o usuário pediu para salvar a música vinculada. Use o diretório de saída que ele especificar; caso contrário, salve em ./downloads.

  2. Passe a URL como um argumento separado de linha de comando para o script. Nunca avalie a URL como código de shell. Se o executor de comando usar um shell, coloque o argumento entre aspas seguindo as regras normais de citação de argumento desse shell.

  3. Execute o seguinte comando, adicionando a URL do usuário e o diretório de saída como argumentos:

    node scripts/download.mjs --url <suno-url-publica> --output-dir <diretório>
    

    Omita --output-dir para usar ./downloads.

  4. Informe o caminho do arquivo salvo e o formato retornado pelo SunoPull. Não declare sucesso a menos que o script saia com êxito e imprima o caminho.

Acesso e limites

  • O script envia a URL pública do Suno para o SunoPull resolver a música e, em seguida, baixa seu áudio disponível através do SunoPull.
  • Não use esta skill para acessar músicas privadas, contornar restrições de conta do Suno ou baixar conteúdo que o usuário não tem permissão para usar.
  • Se o SunoPull relatar que uma página ou fonte de áudio está indisponível, explique o erro e pare. Não tente novamente com cookies, credenciais ou endpoints privados alternativos.
  • Se o usuário precisar de conversão MP3/WAV ou outros arquivos, direcione-o para a ferramenta correspondente do site SunoPull. Este script preserva o formato de origem.

Script

  • scripts/download.mjs — resolve um link público e salva o áudio original. Ele não sobrescreve um arquivo existente.

Habilidades Relacionadas