Descarga toda tu biblioteca de Suno en MP3 en minutos, usando solo tu cookie de sesión y herramientas gratuitas como WSL o extensiones de navegador. Sin sitios de terceros, sin duplicados y con nombres de archivo organizados automáticamente.

⚠️ Advertencia de compatibilidad: Suno no ofrece una API pública oficial. Este método utiliza los endpoints internos de la plataforma (`api/library`), los cuales migraron de suno.ai a suno.com. Si en el futuro el script de Bash deja de responder, inspecciona la pestaña Network de tu navegador para verificar si el endpoint interno ha cambiado su estructura o paginación.

¿Es posible descargar masivamente tu biblioteca de Suno?

Sí. Usando únicamente la cookie de sesión de tu cuenta en Suno y herramientas de línea de comandos en WSL, puedes clonar todas tus canciones en minutos. Si prefieres evitar la configuración de la terminal, también existen extensiones de navegador que simplifican el proceso a un solo clic.

¿Qué necesitas antes de comenzar?

Requisitos para el método de WSL

• Windows 10 o Windows 11 con WSL activado (Ubuntu, Debian, etc.).
• Una distribución de Linux instalada desde la Microsoft Store.
• Conexión a internet estable para descargar las herramientas y transferir los archivos multimedia.

Requisitos para el método de extensiones

• Un navegador de escritorio compatible: Google Chrome, Mozilla Firefox o Microsoft Edge.
• Permisos para instalar complementos desde las tiendas oficiales.

Requisitos adicionales

• Tiempo estimado: Entre 5 y 15 minutos (dependiendo del volumen de tu biblioteca).
• Espacio en disco: Alrededor de 5 a 10 MB por canción (una biblioteca de 100 canciones ocupará entre 500 MB y 1 GB).
• Ancho de banda: Se recomienda una conexión de al menos 10 Mbps para una descarga masiva de contenido fluida.

⚠️ Seguridad y privacidad con las cookies de sesión

La cookie de sesión de Suno solo es válida para tu cuenta y se comunica con los dominios oficiales: suno.com y cdn1.suno.com. Por tu seguridad, toma en cuenta lo siguiente:

• Nunca compartas tu cookie en foros, código público o redes sociales; da acceso total a tu perfil.
• Manipula la cookie solo en tu propio dispositivo de confianza.
• Si sospechas de una filtración, cierra sesión en todos los dispositivos desde los ajustes de Suno para invalidar el token.
• Revisa los Términos de Servicio de la plataforma antes de ejecutar automatizaciones intensivas.

¿Cómo obtener la cookie de sesión desde el navegador?

⚠️ Nota clave: El token de sesión expira tras un periodo de inactividad o al cerrar el navegador. Extráela justo antes de arrancar el script de descarga.

1. Inicia sesión en la plataforma abriendo suno.com en tu navegador.
2. Abre las Herramientas de Desarrollador (DevTools):
   • Windows/Linux: Presiona F12 o Ctrl + Shift + I.
   • Mac: Presiona Cmd + Option + I.
3. Ve a la pestaña Network (Red).
4. Actualiza la página actual (F5 o el botón de recargar).
5. Haz clic en cualquiera de las primeras solicitudes HTTP que aparecen en la lista de peticiones.
6. En el panel lateral derecho, entra a la pestaña Headers (Cabeceras).
7. Busca la sección Request Headers e identifica la fila llamada Cookie:. Copia todo el valor de texto que aparece después de ella (toda la cadena de pares name=value separados por puntos y comas).
8. Pega temporalmente esa cadena en un bloc de notas. Esa será la variable COOKIE para nuestro entorno.

Estructura de una cookie válida:

_suno_session=abc123xyz...; _ga=GA1.1...; _gid=GA1.1...

¿Qué extensiones recomendamos para navegadores?

Si prefieres una interfaz gráfica y evitar comandos, estas extensiones agilizan la gestión y el respaldo de tus archivos:

Suno Manager (Chrome y Firefox)

• Chrome Web Store: Buscar en Chrome Store
• Firefox Add-ons: Buscar en Firefox Add-ons
• Características: Descarga masiva en formatos MP3 y WAV, exportación de portadas y letras, filtros avanzados por fecha y opción de descargar únicamente pistas marcadas como “Liked”.

Suno Tracks Exporter (Chrome)

• Chrome Web Store: Buscar en Chrome Store
• Características: Extrae de forma limpia un listado de enlaces planos de los servidores CDN. Es ideal para enviarlo posteriormente a herramientas de línea de comandos dedicadas de descarga masiva.

Suno Explorer (Chrome)

• Chrome Web Store: Buscar en Chrome Store
• Características: Enfocada en respaldos completos sin conexión (*backups offline*), empaquetado ágil de librerías y gestión personalizada de espacios de trabajo de audio.

¿Cómo ejecutar la descarga mediante extensiones?

1. Accede a la tienda oficial mediante los enlaces anteriores e instala el complemento verificado.
2. Concede los permisos básicos de almacenamiento y lectura sobre el dominio de Suno.
3. Navega hacia tu biblioteca (suno.com/library).
4. Importantísimo para evitar descargas incompletas: Haz scroll vertical continuo hasta el fondo absoluto de la pantalla. Al ser una interfaz de carga diferida (*lazy loading*), la extensión sólo procesará las pistas musicales indexadas que el navegador haya renderizado en pantalla.
5. Haz clic sobre el icono de la extensión en tu barra de herramientas y selecciona la opción de volcado masivo.

¿Cómo preparar WSL para el método de línea de comandos?

Abre la consola de tu distribución Linux en Windows y ejecuta el comando de aprovisionamiento una sola vez:

sudo apt-get update && sudo apt-get install -y curl jq aria2 bc

Este comando desplegará tres herramientas de línea de comandos esenciales:

• curl: El motor encargado de inyectar las cookies y descargar los metadatos desde los servidores.
• jq: Un analizador sintáctico para estructurar y filtrar las respuestas JSON nativas del servicio.
• aria2 / bc: Un potente gestor de descargas multiproceso en paralelo (comando aria2c) y una calculadora matemática para gestionar marcas de tiempo.

Creación y despliegue del script de descarga en WSL

Si es tu primera toma de contacto con editores de consola como nano, sigue detalladamente este flujo de trabajo:

1. Copia íntegramente el bloque de código Bash que se muestra abajo.
2. En tu consola de WSL, escribe: nano suno_bulk_download.sh.
3. Pega el script utilizando la combinación de teclas Ctrl + Shift + V.
4. Para guardar el archivo: Presiona Ctrl + O y pulsa Enter. Para salir del editor, presiona Ctrl + X.

Posiciónate en tu directorio raíz local e inicia el editor:

cd ~
nano suno_bulk_download.sh

Pega el código automatizado e introduce tu token dentro de la variable COOKIE:

#!/usr/bin/env bash
# ==============================================================
# Descarga masiva de Suno.com usando la cookie de sesión
# Corrección sintáctica nativa para inyección paralela en aria2c
# Versión robusta con control de dependencias, entornos y codificación
# ==============================================================

# Forzar codificación UTF-8 para evitar errores con emojis o caracteres Unicode en títulos
export LANG=C.UTF-8

# ---------- CONFIGURACIÓN ----------
# Coloca dentro de las comillas tu cadena de autenticación copiada
COOKIE="TU_COOKIE_COMPLETA_AQUI"

# Ruta local del directorio de destino para tus archivos de audio
OUTPUT_DIR="$HOME/Suno_MP3"
mkdir -p "$OUTPUT_DIR"

# ---------- CONTROL DE DEPENDENCIAS EN CALIENTE ----------
for cmd in curl jq aria2c bc; do
    if ! command -v "$cmd" &> /dev/null; then
        echo "Error: La herramienta '$cmd' no está instalada correctamente en tu WSL."
        echo "Por favor, ejecuta en la terminal: sudo apt-get install -y $cmd"
        exit 1
    fi
done

# Sanitización automática de la cookie por si se copió con el prefijo "Cookie: " por error
COOKIE=$(echo "$COOKIE" | sed 's/^Cookie: //i')

# ---------- VALIDACIÓN DE CREDENCIALES ----------
echo "Verificando validez de la sesión..."
TEST_RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" -b "$COOKIE" -H "Accept: application/json" "https://suno.com/api/library")
if [ "$TEST_RESPONSE" -ne 200 ]; then
    echo "Error crítico: El token no es válido o la sesión ha expirado (HTTP: $TEST_RESPONSE)."
    echo "Por favor, extrae una cookie fresca desde las herramientas de desarrollo."
    exit 1
fi
echo "Conexión autorizada con éxito. Sincronizando..."

# ---------- ADQUISICIÓN DE METADATOS ----------
echo "Obteniendo el índice de tu biblioteca musical..."
JSON=$(curl -s -b "$COOKIE" \
        -H "Accept: application/json" \
        -H "Referer: https://suno.com/" \
        "https://suno.com/api/library")

if ! echo "$JSON" | jq . >/dev/null 2>&1; then
    echo "Error: La respuesta del servidor no tiene un formato JSON computable."
    exit 1
fi

# ---------- PROCESAMIENTO Y MAPEADO (Redirección nativa de flujos) ----------
echo "Sintetizando nombres de archivos y mapeando URLs de descarga..."
LIST_FILE="$OUTPUT_DIR/download_list.txt"
> "$LIST_FILE"

declare -A title_count

while IFS= read -r song; do
    TITLE=$(echo "$song" | jq -r '.title')
    CLIP_ID=$(echo "$song" | jq -r '.clipId')
    DURATION=$(echo "$song" | jq -r '.duration // empty')

    # Corrección para pistas que no contienen un título asignado por el usuario o vienen nulas
    if [ -z "$TITLE" ] || [ "$TITLE" = "null" ]; then
        TITLE="Pista_Suno_Sin_Titulo"
    fi

    BASENAME="$TITLE"
    if [ -n "$DURATION" ] && [ "$DURATION" != "null" ]; then
        # Formatear duración de segundos planos a minutos y segundos legibles para sistemas locales
        MINUTES=$(echo "$DURATION/60" | bc 2>/dev/null || echo "0")
        SECONDS=$(echo "$DURATION%60" | bc 2>/dev/null || echo "0")
        BASENAME="$BASENAME (${MINUTES}m${SECONDS}s)"
    fi

    count=${title_count["$TITLE"]:-0}
    ((count++))
    title_count["$TITLE"]=$count

    if [ $count -eq 1 ]; then
        FILENAME="${BASENAME}.mp3"
    else
        FILENAME="${BASENAME}_${count}.mp3"
    fi

    # Limpieza exhaustiva de caracteres incompatibles con sistemas de almacenamiento (NTFS / ext4)
    FILENAME=$(echo "$FILENAME" | sed 's/[\\\/:*?"<>|]/_/g')
    URL="https://cdn1.suno.com/${CLIP_ID}.mp3"

    # Inyección de mapa de entrada estructurado nativo para aria2c (URL + Directiva out)
    echo "$URL" >> "$LIST_FILE"
    echo "  out=$FILENAME" >> "$LIST_FILE"

done < <(echo "$JSON" | jq -c '.[] | {title: .title, clipId: .clipId, duration: .duration}') TOTAL=$(grep -c "out=" "$LIST_FILE" 2>/dev/null || echo "0")
echo "Indexación completada: $TOTAL canciones añadidas al mapa de descarga."

# ---------- DESPLIEGUE MULTIPROCESO CON ARIA2C ----------
echo "Abriendo hilos paralelos de descarga..."
aria2c \
    --input-file="$LIST_FILE" \
    --dir="$OUTPUT_DIR" \
    --continue=true \
    --split=5 \
    --max-connection-per-server=5 \
    --max-concurrent-downloads=5 \
    --retry-wait=5 \
    --max-tries=3 \
    --console-log-level=notice \
    --show-console-readout=true

echo "¡Felicidades! Descarga masiva finalizada."
echo "Tus archivos MP3 organizados se encuentran en: $OUTPUT_DIR"

Concede permisos de ejecución al script desde la terminal:

chmod +x ~/suno_bulk_download.sh

Ejecuta la automatización para iniciar la descarga:

~/suno_bulk_download.sh

¿Qué hace internamente este script?

• Valida tus credenciales antes de iniciar peticiones masivas al servidor CDN para evitar bloqueos.
• Interpreta el JSON devuelto para procesar el ID único (*clipId*), el nombre asignado y la duración exacta.
• Evita colisiones e hilos corruptos en discos duros controlando los títulos idénticos mediante un array asociativo numérico incremental (_2, _3, etc.).
• Genera un mapa compatible con aria2c, descargando de forma asíncrona hasta 5 canciones simultáneamente a máxima velocidad.

Estructura de salida en tu sistema

Suno_MP3/
├── Mi cancion favorita (3m42s).mp3
├── Mi cancion favorita (3m42s)_2.mp3
├── Pista_Suno_Sin_Titulo_4a5b6c.mp3
└── download_list.txt

¿Cómo solucionar problemas comunes?

Error de sintaxis bash o error de comando ‘\r’: command not found

Este fallo ocurre si editaste o copiaste el código del script usando herramientas nativas de texto de Windows (como el Bloc de Notas clásico), las cuales inyectan un salto de línea invisible incompatible con entornos Linux (CRLF). Para solucionarlo, ejecuta el siguiente comando purificador directamente en tu terminal de WSL antes de volver a correr el script:

sed -i 's/\r$//' ~/suno_bulk_download.sh

Error: “No se pudo obtener la biblioteca”

La cookie ingresada ha expirado o se copió de forma incompleta. Limpia la sesión web en el navegador, vuelve a loguearte y repite los pasos de copiado.

Error 403 o 401: “Forbidden” / “Unauthorized”

Ocurre si hay interferencias con extensiones de seguridad corporativas o bloqueadores de anuncios avanzados. Te recomendamos abrir una ventana en modo incógnito, acceder a Suno y extraer una cookie limpia desde allí.

El script descarga menos canciones de las que tengo

Si tu biblioteca musical supera las 100 o 200 canciones y notas que faltan elementos, se debe a que la API interna de Suno ha aplicado paginación sobre tu perfil. Si experimentas esto, inspecciona la pestaña Network en tus herramientas de desarrollador mientras haces scroll en tu biblioteca de la web de Suno. Localiza el endpoint dinámico correspondiente e integra los parámetros numéricos de paginación o límite de elementos activos (como por ejemplo: api/library?page=1&limit=1000) en la URL de consulta del script de Bash.

Conclusión: ¿Qué método elegir?

• Para un perfil técnico: Utiliza el entorno de WSL. Es infinitamente más rápido si manejas bibliotecas masivas con miles de audios, te protege frente a bloqueos y permite automatizar el respaldo en tus propios discos de red o servidores locales.
• Para un perfil práctico: Instala una de las extensiones web recomendadas y gestiona tus descargas mediante una interfaz visual cómoda.