Construye una API de Música Que Lee la Mente: Generador de Listas de Reproducción de Estado de Ánimo con IA usando Node.js

Imagina escribir "Me acaban de cortar y está lloviendo" e instantáneamente obtener una lista de reproducción perfectamente curada que coincide exactamente con cómo te sientes. Hoy, estamos construyendo una API que lee emociones humanas a partir de texto y genera listas de reproducción personalizadas de Spotify usando análisis de sentimientos de IA. Esto no es solo otro tutorial. Estamos creando algo que genuinamente podría mejorar los días de las personas.

Lo Que Necesitarás

Node.js instalado (nodejs.org)
Una cuenta de desarrollador de Spotify (gratis en developer.spotify.com)
Un editor de código - Usaré VS Code pero puedes usar tu propio editor de código si tienes uno con el que estés acostumbrado a usar, de lo contrario puedes descargar VS Code aquí: https://code.visualstudio.com/
Clave de API de OpenAI (o usaremos una librería gratuita de análisis de sentimientos)
Conocimiento básico de JavaScript
Solo 30 minutos de tu tiempo

Descargar e Instalar Node.js

Ve a nodejs.org

Haz clic en Get Node.js

Desplázate hacia abajo en la página hasta 'Or get a prebuilt Node.js'

El instalador precompilado es la mejor opción especialmente para principiantes porque:

Es una configuración de 2 minutos en lugar de 30+ minutos compilando
Está garantizado que funciona y ha sido probado por millones
Puedes empezar a codificar más rápido

Selecciona tu sistema operativo, Windows, macOs, Linux o AIX

Y haz clic en el botón de descarga (tendrá Windows Installer (.msi), macOs (.pkg), Linux (.xz) o Standalone Binary (.gz) como texto del botón)

Una vez descargado, abre el instalador y sigue estos pasos de instalación:

Paso 1: Pantalla de Bienvenida

Haz doble clic en el archivo del instalador descargado para iniciar el proceso de instalación. Verás la pantalla de Bienvenida de Configuración de Node.js.

Haz clic en "Next" para continuar.

Pantalla de bienvenida del instalador de Node.js

Paso 2: Acuerdo de Licencia

Lee el Acuerdo de Licencia (o simplemente desplázate rápidamente - es la licencia estándar de código abierto).

Marca la casilla "I accept the terms in the License Agreement".

Haz clic en "Next" para proceder.

Paso 3: Elegir Ubicación de Instalación

Mantén la ruta de instalación predeterminada (generalmente C:\Program Files\nodejs\ en Windows).

No cambies nada a menos que tengas una razón específica para instalar en otro lugar.

Haz clic en "Next" para continuar.

Paso 4: Seleccionar Componentes

Deja todas las casillas seleccionadas (Node.js runtime, npm package manager, online documentation shortcuts, y Add to PATH).

La opción "Add to PATH" es crucial - esto te permite ejecutar Node.js desde cualquier símbolo del sistema o terminal.

Haz clic en "Next" para continuar.

Paso 5: Herramientas para Módulos Nativos (CRÍTICO - ¡No lo Omitas!)

⚠️ IMPORTANTE: ¡DEBES marcar esta casilla!

Si no marcas "Automatically install the necessary tools", tu Node.js no funcionará correctamente con muchos paquetes. ¡Este paso es esencial para que el tutorial funcione!

✅ Marca la casilla "Automatically install the necessary tools".

Esto instala Python y Visual Studio Build Tools que muchos paquetes npm necesitan para compilar código nativo correctamente.

Haz clic en "Next" para continuar.

Herramientas adicionales de Node.js - DEBES marcar la casilla

💡 Por qué esta casilla es crucial:

Muchos paquetes npm necesitan compilar código nativo y no funcionarán sin estas herramientas
Sin estas herramientas, obtendrás mensajes de error crípticos al instalar paquetes
Esto te ahorra horas de resolución de problemas más adelante en tu viaje de desarrollo

Paso 6: Listo para Instalar

Revisa tus configuraciones de instalación una vez más.

Haz clic en "Install" para comenzar el proceso de instalación.

Nota: Puedes ver un aviso de Control de Cuentas de Usuario de Windows - haz clic en "Yes" para permitir la instalación.

Paso 7: Instalación Completa

Espera a que la instalación se complete - esto generalmente toma 1-2 minutos.

Haz clic en "Finish" cuando la instalación esté completa.

Paso 8: Instalar Herramientas Adicionales (Si Marcaste la Casilla)

Si marcaste la opción "automatically install tools" en el Paso 5, aparecerá una ventana de símbolo del sistema como esta:

Terminal de Node.js para instalación de herramientas adicionales

👆 Presiona cualquier tecla para iniciar el proceso de instalación

Lo que sucede a continuación:

Presiona CUALQUIER TECLA cuando veas la solicitud para comenzar a instalar Python y Visual Studio Build Tools
Espera pacientemente 10-15 minutos - esto instala herramientas de desarrollo que muchos paquetes npm requieren
Verás mucho texto desplazándose - ¡esto es normal! No cierres la ventana
Presiona ENTER cuando la instalación se complete para salir del instalador

Haz clic en cualquier tecla otra vez... probablemente obtendrás otra ventana emergente preguntándote si quieres que la aplicación haga cambios en tu pc, adelante y haz clic en sí para proceder con la instalación. Luego deberías ver algo como esto:

Instalación de herramientas adicionales de Node.js en progreso

📦 Instalando Build Tools - Esto puede tomar 10-15 minutos

Espera a que termine de instalarse y luego haz como dice y escribe ENTER en la parte inferior del terminal y presiona el botón enter en tu teclado para salir:

Instalación de Node.js completa - presiona ENTER para salir

Proceso de instalación de Node.js terminado

Configuración de Tu Entorno de Desarrollo

Ahora podemos llegar a la parte divertida y comenzar a dar vida a nuestra aplicación. Primero abre tu editor de código. Usaré VS Code y a menos que te sientas más cómodo usando otro, recomiendo usar VS Code, ya que será más fácil seguir este tutorial.

Abre tu terminal. Si no sabes cómo hacer esto, haz clic en los 3 puntos en la parte superior de tu editor de código y desplázate hacia abajo hasta 'Terminal', pasa el cursor sobre él y luego haz clic en 'New Terminal'.

Escribe los siguientes 4 comandos en tu terminal, uno a la vez:

mkdir mood-music-api
cd mood-music-api
npm init -y
npm install express axios sentiment dotenv spotify-web-api-node

Desglose de Comandos: Lo Que Cada Paso Realmente Hace

1. mkdir mood-music-api

Lo que hace:

Crea una nueva carpeta vacía llamada "mood-music-api"
mkdir = "make directory" (hacer directorio)

Por qué lo necesitas:

Tu proyecto necesita su propio hogar/espacio de trabajo
Mantiene tu código organizado y separado de otros proyectos
Como crear una nueva carpeta para cada tarea escolar

2. cd mood-music-api

Lo que hace:

Mueve tu terminal/símbolo del sistema DENTRO de esa carpeta
cd = "change directory" (cambiar directorio)

Por qué lo necesitas:

Todos los comandos futuros se ejecutarán dentro de tu carpeta del proyecto
Como abrir una carpeta específica antes de guardar un documento

3. npm init -y

Lo que hace:

Crea un archivo package.json con configuraciones predeterminadas
package.json es como la tarjeta de identificación y lista de compras de tu proyecto

Por qué lo necesitas:

Le dice a Node.js que esta carpeta ES un proyecto de Node.js
Rastrea qué librerías (paquetes) necesita tu proyecto
Almacena información del proyecto como nombre, versión, descripción

4. npm install express axios sentiment dotenv spotify-web-api-node

Lo que hace:

Descarga e instala 5 librerías de código diferentes que tu proyecto necesita
Crea una carpeta node_modules con miles de archivos
Actualiza package.json para recordar estas dependencias

Lo que hace cada librería:

express: Crea el servidor web que maneja las solicitudes de API
axios: Hace solicitudes HTTP a otras APIs (como Spotify)
sentiment: Analiza texto para detectar emociones/estado de ánimo
dotenv: Almacena de forma segura claves secretas de API
spotify-web-api-node: Se conecta a Spotify para obtener datos de música

Ahora abre tu carpeta yendo a archivo luego abrir carpeta y busca una carpeta llamada mood-music-api y ábrela.

Ahora deberías ver una carpeta llamada Mood-MUSIC-API en tu explorador con node modules, un package-lock.json y un archivo package.json dentro.

Obtener Tus Claves de API de Spotify (Paso a Paso)

Ahora quieres crear un nuevo archivo y nombrarlo .env. Para hacer esto puedes hacer clic en File luego New File y escribir .env luego hacer clic en enter y escribir el nombre del archivo otra vez .env y hacer clic en Create File.

Antes de ingresar algo en este archivo necesitamos obtener nuestras claves de API.

Paso 1: Crear una Cuenta de Desarrollador de Spotify

Ve a: developer.spotify.com

Lo que verás:

Un enlace "Log in" en la parte superior derecha
Si no tienes Spotify: Haz clic en "Sign up" (¡es gratis!)
Si tienes Spotify: Usa tu cuenta existente

Importante: ¡No necesitas Spotify Premium - las cuentas gratuitas funcionan bien para acceso a API!

Paso 2: Crear Tu Aplicación

Después de iniciar sesión:

Haz clic en "Create app"

Llena el formulario:

App name: Mood Music API
App description: AI-powered mood playlist generator
Website: http://localhost:3000 (por ahora)
Redirect URI: https://localhost:3000/callback

¿Qué APIs planeas usar?

✅ Marca "Web API"
✅ Marca "Web Playbook SDK" (opcional, para características futuras)

Acepta los términos y haz clic en "Save"

Paso 3: Obtener Tus Claves Secretas

Después de crear tu aplicación:

Verás el panel de tu aplicación
Bajo Basic Information verás dos piezas importantes de información:

Client ID: abc123def456... (visible, 32 caracteres)
Client Secret: [Show client secret] (haz clic para revelar)

Haz clic en "Show client secret" para revelar tu clave secreta
Copia ambas claves - ¡las necesitarás en el siguiente paso!

Lo que hacen estas claves:

Client ID: El identificador público de tu aplicación (como un nombre de usuario)
Client Secret: La contraseña de tu aplicación (¡mantén esto privado!)

Paso 4: Agregar Claves a Tu Proyecto

Agrega tus claves al archivo .env que creaste:

SPOTIFY_CLIENT_ID=tu_client_id_real_aqui
SPOTIFY_CLIENT_SECRET=tu_client_secret_real_aqui
PORT=3000

Haz clic en ctrl + s o cmd + s o File luego save para guardar tus cambios.

Paso 5: Proteger Tus Secretos

Importante: ¡Nunca compartas tu Client Secret públicamente!

Agrega .env a tu archivo .gitignore usando los siguientes comandos en tu terminal:

# Crear archivo .gitignore
# O en macOS/Linux
touch .gitignore

# o PowerShell
New-Item -Path ".gitignore" -ItemType "file"
# O aún más simple: 
echo $null > .gitignore

# Agregar esta línea a .gitignore:
.env
node_modules/

Haz clic en ctrl + s o cmd + s o File luego save para guardar tus cambios.

El Motor de Detección de Estado de Ánimo

Crea un archivo y nómbralo moodAnalyzer.js - aquí es donde sucede la magia.

Agrega el siguiente código al archivo y guarda tus cambios.

const Sentiment = require('sentiment');
const sentiment = new Sentiment();

class MoodAnalyzer {
  analyzeMood(text) {
    const result = sentiment.analyze(text);
    
    // Enhanced mood detection with context clues
    const moodKeywords = {
      energetic: ['pumped', 'excited', 'energy', 'workout', 'party', 'dancing'],
      sad: ['dumped', 'broke up', 'crying', 'lonely', 'depressed', 'heartbreak'],
      angry: ['furious', 'pissed', 'angry', 'mad', 'rage', 'frustrated'],
      chill: ['relax', 'calm', 'peaceful', 'meditation', 'study', 'focus'],
      romantic: ['love', 'date', 'crush', 'valentine', 'romantic', 'kiss'],
      nostalgic: ['memories', 'throwback', 'old days', 'reminiscing', 'vintage']
    };
    
    const lowerText = text.toLowerCase();
    let detectedMood = 'neutral';
    let confidence = Math.abs(result.score);
    
    // Check for specific mood keywords
    for (const [mood, keywords] of Object.entries(moodKeywords)) {
      if (keywords.some(keyword => lowerText.includes(keyword))) {
        detectedMood = mood;
        confidence += 2;
        break;
      }
    }
    
    // Fallback to sentiment score
    if (detectedMood === 'neutral') {
      if (result.score > 2) detectedMood = 'happy';
      else if (result.score < -2) detectedMood = 'sad';
      else if (result.score < 0) detectedMood = 'melancholy';
      else detectedMood = 'chill';
    }
    
    return {
      mood: detectedMood,
      confidence: Math.min(confidence, 10),
      sentiment: result.score,
      intensity: this.calculateIntensity(text, result.score)
    };
  }
  
  calculateIntensity(text, score) {
    const intensifiers = ['very', 'extremely', 'really', 'super', 'totally', '!!!', 'so much'];
    const hasIntensifiers = intensifiers.some(word => text.toLowerCase().includes(word));
    const baseIntensity = Math.abs(score) / 5;
    return Math.min((hasIntensifiers ? baseIntensity * 1.5 : baseIntensity), 1);
  }
}

module.exports = new MoodAnalyzer();

El Asistente de Listas de Reproducción de Spotify

Crea un archivo y nómbralo playlistGenerator.js. Luego agrega el siguiente código y guarda tus cambios:

const SpotifyWebApi = require('spotify-web-api-node');

class PlaylistGenerator {
  constructor() {
    this.spotifyApi = new SpotifyWebApi({
      clientId: process.env.SPOTIFY_CLIENT_ID,
      clientSecret: process.env.SPOTIFY_CLIENT_SECRET
    });
    this.initializeSpotify();
  }
  
  async initializeSpotify() {
    try {
      console.log('🔑 Intentando autenticación de Spotify...');
      console.log('Client ID:', process.env.SPOTIFY_CLIENT_ID ? 
        `${process.env.SPOTIFY_CLIENT_ID.substring(0, 8)}...` : 'FALTANTE');
      console.log('Client Secret:', process.env.SPOTIFY_CLIENT_SECRET ? 
        `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'FALTANTE');
      
      const data = await this.spotifyApi.clientCredentialsGrant();
      this.spotifyApi.setAccessToken(data.body['access_token']);
      console.log('🎵 ¡Spotify conectado exitosamente!');
    } catch (error) {
      console.error('❌ Falló la conexión de Spotify:', error.message);
      console.error('Código de estado:', error.statusCode);
      console.error('Esto generalmente significa credenciales de API inválidas');
    }
  }
  
  // ... (resto del código como se muestra en tu documento)
}

module.exports = PlaylistGenerator;

El Servidor API Que Lee la Mente

Crea un archivo y nómbralo server.js, agrega el siguiente código y guarda tus cambios:

require('dotenv').config();
const express = require('express');
const moodAnalyzer = require('./moodAnalyzer');
const PlaylistGenerator = require('./playlistGenerator');

// Add node-fetch for older Node.js versions
let fetch;
if (typeof globalThis.fetch === 'undefined') {
  console.log('📦 Node.js fetch no disponible, usando paquete node-fetch...');
  try {
    fetch = require('node-fetch');
  } catch (error) {
    console.error('❌ Por favor instala node-fetch: npm install node-fetch');
    process.exit(1);
  }
} else {
  fetch = globalThis.fetch;
  console.log('✅ Usando fetch incorporado de Node.js');
}

const app = express();
const PORT = process.env.PORT || 3000;
const playlistGen = new PlaylistGenerator();

app.use(express.json());

// Beautiful web interface
app.get('/', (req, res) => {
  res.send(`
    
    
    
        Mind-Reading Music API
        
    
    
        
            🧠🎵 Mind-Reading Music API
            ¡Dime cómo te sientes y crearé la lista de reproducción perfecta para tu estado de ánimo!
            
            
            
            
            
                
            
        
        
        
    
    
  `);
});

// The magic endpoint
app.post('/api/mood-playlist', async (req, res) => {
  // API logic here
});

app.listen(PORT, () => {
  console.log(`🚀 Mind-Reading Music API ejecutándose en http://localhost:${PORT}`);
  console.log('🧠 ¡Listo para analizar estados de ánimo y generar listas de reproducción!');
});

Paso 5: Prueba Tu IA Emocional

Inicia tu servidor:

node server.js

Deberías ver algo como esto:

¡Ahora abre tu navegador web y ve al enlace local mostrado en la imagen de arriba (http://localhost:3000) para probar tu Mind-Reading Music API!

Errores Comunes a Evitar

Límites de API de Spotify: El nivel gratuito tiene límites de velocidad. Almacena respuestas en caché e implementa lógica de reintentos para uso en producción.
Mala interpretación de estado de ánimo: Prueba casos límite como sarcasmo ("genial, otro lunes...") que podría confundir el análisis de sentimientos.
Listas de reproducción vacías: Siempre maneja casos donde Spotify no devuelve recomendaciones proporcionando géneros de respaldo.
Exposición de claves de API: Nunca confirmes tu archivo .env. Usa variables de entorno en producción.

Próximos Pasos

¡Ahora hemos construido algo genuinamente genial! Aquí te muestro cómo hacerlo aún mejor:

Agregar cuentas de usuario: Almacenar historial de estados de ánimo y preferencias de listas de reproducción
Aprendizaje automático: Entrenar modelos personalizados con retroalimentación del usuario para mejorar la precisión
Características sociales: Permitir a los usuarios compartir listas de reproducción de estados de ánimo con amigos
Integración de voz: Conectar con APIs de voz a texto para detección de estado de ánimo por voz
Integración de dispositivos portátiles: Leer datos de frecuencia cardíaca y actividad para percepciones más profundas del estado de ánimo
Implementar y escalar: Usar Redis para almacenamiento en caché, implementar autenticación adecuada

Tu Mind-Reading Music API ahora puede entender emociones humanas y responder con bandas sonoras perfectas. Esta combinación de análisis de sentimientos de IA y curación musical representa el futuro de las experiencias personalizadas. ¡Las posibilidades son infinitas!

Mantente atento a nuestro próximo tutorial donde desarrollaremos esta aplicación aún más...