Communitygithub.com

sunopull-download

Descarga una canción de Suno de acceso público mediante SunoPull. Úsalo solo cuando el usuario solicite explícitamente descargar o guardar una canción desde un enlace de canción, Hook o enlace compartido.

¿Qué es sunopull-download?

Esta herramienta permite descargar una canción de Suno de acceso público (ya sea desde una canción individual, un Hook o un enlace compartido) utilizando el servicio SunoPull. Es útil para desarrolladores y usuarios que integran agentes de IA en sus flujos de trabajo musicales, ya que automatiza la descarga de audio preservando el formato original (MP3, M4A o WAV). Funciona mediante un script Node.js (`scripts/download.mjs`) que recibe la URL pública y un directorio de salida opcional, sin necesidad de conversión de formato ni descarga de álbumes, listas de reproducción o carátulas. Está diseñado para usarse exclusivamente con contenido público y no debe emplearse para acceder a canciones privadas, eludir restricciones de Suno o descargar material sin permiso. El agente debe confirmar que el usuario solicita explícitamente la descarga, pasar la URL como un argumento separado y citarlo adecuadamente, y reportar la ruta y el formato del archivo descargado solo si el script finaliza exitosamente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Descargar una canción de Suno con SunoPull

Usa esta habilidad solo cuando el usuario solicite descargar o guardar una canción. Un enlace pegado por sí mismo no es una solicitud de descarga.

Entrada compatible

  • Una canción de Suno de acceso público, Hook o enlace compartido.
  • La descarga preserva el formato de audio original expuesto para esa canción (MP3, M4A o WAV).
  • Esta primera versión no convierte formatos ni descarga álbumes, listas de reproducción, letras o carátulas.

Flujo de trabajo

  1. Confirma que el usuario solicitó guardar la canción enlazada. Usa el directorio de salida que especifique; de lo contrario, guarda en ./downloads.

  2. Pasa la URL como un argumento independiente de línea de comandos al script. Nunca evalúes la URL como código de shell. Si el ejecutor de comandos usa un shell, entrecomilla el argumento con las reglas normales de entrecomillado de ese shell.

  3. Ejecuta el siguiente comando, agregando la URL del usuario y el directorio de salida como argumentos:

    node scripts/download.mjs --url <public-suno-url> --output-dir <directorio>
    

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

  4. Reporta la ruta del archivo guardado y el formato devuelto por SunoPull. No declares éxito a menos que el script finalice exitosamente e imprima la ruta.

Acceso y límites

  • El script envía la URL pública de Suno a SunoPull para resolver la canción y luego descarga su audio disponible a través de SunoPull.
  • No uses esta habilidad para acceder a canciones privadas, eludir restricciones de la cuenta de Suno, ni descargar contenido que el usuario no tenga permiso de usar.
  • Si SunoPull informa que una página o fuente de audio no está disponible, explica el error y detente. No reintentes con cookies, credenciales o puntos finales privados alternativos.
  • Si el usuario necesita conversión a MP3/WAV u otros archivos, dirígelo a la herramienta web correspondiente de SunoPull. Este script preserva el formato de origen.

Script

  • scripts/download.mjs — resuelve un enlace público y guarda el audio original. No sobrescribe un archivo existente.

Skills relacionados