Создание API для чтения мыслей: ИИ-генератор плейлистов настроения с Node.js

Представьте, что вы набираете «Меня только что бросили, и идет дождь» и мгновенно получаете идеально подобранный плейлист, который точно соответствует вашим чувствам. Сегодня мы создаем API, который читает человеческие эмоции из текста и генерирует пользовательские плейлисты Spotify, используя ИИ-анализ тональности. Это не просто очередной учебник. Мы создаем что-то, что действительно может улучшить день людям.

Что вам понадобится

Установленный Node.js (nodejs.org)
Учетная запись разработчика Spotify (бесплатно на developer.spotify.com)
Редактор кода - я буду использовать VS Code, но вы можете использовать свой редактор кода, если у вас есть привычный, иначе вы можете скачать VS Code здесь: https://code.visualstudio.com/
Ключ API OpenAI (или мы будем использовать бесплатную библиотеку анализа тональности)
Базовые знания JavaScript
Всего 30 минут вашего времени

Загрузка и установка Node.js

Перейдите на nodejs.org

Нажмите Get Node.js

Прокрутите страницу до 'Or get a prebuilt Node.js'

Готовый установщик - лучший вариант, особенно для начинающих, потому что:

Это настройка за 2 минуты вместо 30+ минут компиляции
Он гарантированно работает и был протестирован миллионами
Вы можете быстрее приступить к кодированию

Выберите вашу операционную систему: Windows, macOs, Linux или AIX

И нажмите кнопку загрузки (будет с текстом Windows Installer (.msi), macOs (.pkg), Linux (.xz) или Standalone Binary (.gz))

После загрузки откройте установщик и следуйте этим шагам установки:

Шаг 1: Экран приветствия

Дважды щелкните загруженный файл установщика, чтобы начать процесс установки. Вы увидите экран приветствия Node.js Setup.

Нажмите «Next» для продолжения.

Шаг 2: Лицензионное соглашение

Прочтите лицензионное соглашение (или просто быстро прокрутите его - это стандартная лицензия с открытым исходным кодом).

Поставьте галочку «I accept the terms in the License Agreement».

Нажмите «Next» для продолжения.

Шаг 3: Выбор места установки

Оставьте путь установки по умолчанию (обычно C:\Program Files\nodejs\ в Windows).

Ничего не меняйте, если у вас нет особой причины устанавливать в другом месте.

Нажмите «Next» для продолжения.

Шаг 4: Выбор компонентов

Оставьте все флажки выбранными (среда выполнения Node.js, менеджер пакетов npm, ярлыки онлайн-документации и Add to PATH).

Опция «Add to PATH» критически важна - она позволяет запускать Node.js из любой командной строки или терминала.

Нажмите «Next» для продолжения.

Шаг 5: Инструменты для нативных модулей (КРИТИЧЕСКИ ВАЖНО - не пропустите!)

⚠️ ВАЖНО: Вы ДОЛЖНЫ поставить эту галочку!

Если вы не отметите «Automatically install the necessary tools», ваш Node.js не будет работать правильно с многими пакетами. Этот шаг важен для работы учебника!

✅ Поставьте галочку «Automatically install the necessary tools».

Это устанавливает Python и Visual Studio Build Tools, которые нужны многим npm-пакетам для правильной компиляции нативного кода.

Нажмите «Next» для продолжения.

Дополнительные инструменты Node.js - ОБЯЗАТЕЛЬНО поставьте галочку

💡 Почему эта галочка критически важна:

Многим npm-пакетам нужно компилировать нативный код и они не будут работать без этих инструментов
Без этих инструментов вы получите непонятные сообщения об ошибках при установке пакетов
Это сэкономит вам часы устранения неполадок в вашем путешествии разработки

Шаг 6: Готов к установке

Еще раз просмотрите настройки установки.

Нажмите «Install» для начала процесса установки.

Примечание: Может появиться окно контроля учетных записей Windows - нажмите «Да» для разрешения установки.

Шаг 7: Установка завершена

Дождитесь завершения установки - обычно это занимает 1-2 минуты.

Нажмите «Finish» когда установка завершится.

Шаг 8: Установка дополнительных инструментов (если вы поставили галочку)

Если вы поставили галочку «автоматически устанавливать инструменты» в Шаге 5, появится окно командной строки как это:

Терминал Node.js для установки дополнительных инструментов

👆 Нажмите любую клавишу для начала процесса установки

Что происходит дальше:

Нажмите ЛЮБУЮ КЛАВИШУ когда увидите приглашение для начала установки Python и Visual Studio Build Tools
Подождите терпеливо 10-15 минут - это устанавливает инструменты разработки, которые требуются многим npm-пакетам
Вы увидите много прокручивающегося текста - это нормально! Не закрывайте окно
Нажмите ENTER когда установка завершится для выхода из установщика

Нажмите любую клавишу снова... вы, вероятно, получите еще одно всплывающее окно с вопросом, хотите ли вы разрешить приложению вносить изменения в ваш ПК, продолжайте и нажмите да для продолжения установки. Затем вы должны увидеть что-то вроде этого:

Установка дополнительных инструментов Node.js в процессе

📦 Установка инструментов сборки - это может занять 10-15 минут

Дождитесь завершения установки, а затем сделайте как говорится - введите ENTER в нижней части терминала и нажмите клавишу enter на клавиатуре для выхода:

Установка Node.js завершена - нажмите ENTER для выхода

Настройка среды разработки

Теперь мы можем перейти к веселой части и начать оживлять наше приложение. Сначала откройте ваш редактор кода. Я буду использовать VS Code и если вы не чувствуете себя комфортнее с другим, я рекомендую использовать VS Code, так как будет легче следовать этому учебнику.

Откройте ваш терминал. Если вы не знаете, как это сделать, нажмите на 3 точки вверху вашего редактора кода и прокрутите до 'Terminal', наведите на него курсор и затем нажмите на 'New Terminal'.

Введите следующие 4 команды в ваш терминал, одну за раз:

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

Разбор команд: что фактически делает каждый шаг

1. mkdir mood-music-api

Что делает:

Создает новую пустую папку с названием "mood-music-api"
mkdir = "make directory" (создать директорию)

Зачем это нужно:

Вашему проекту нужен собственный дом/рабочее пространство
Сохраняет ваш код организованным и отдельным от других проектов
Как создание новой папки для каждого школьного задания

2. cd mood-music-api

Что делает:

Перемещает ваш терминал/командную строку ВНУТРЬ этой папки
cd = "change directory" (изменить директорию)

Зачем это нужно:

Все будущие команды будут выполняться внутри папки вашего проекта
Как открытие определенной папки перед сохранением документа

3. npm init -y

Что делает:

Создает файл package.json с настройками по умолчанию
package.json - это как удостоверение личности и список покупок вашего проекта

Зачем это нужно:

Сообщает Node.js, что эта папка ЯВЛЯЕТСЯ проектом Node.js
Отслеживает, какие библиотеки (пакеты) нужны вашему проекту
Хранит информацию о проекте, такую как название, версия, описание

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

Что делает:

Загружает и устанавливает 5 различных библиотек кода, которые нужны вашему проекту
Создает папку node_modules с тысячами файлов
Обновляет package.json, чтобы запомнить эти зависимости

Что делает каждая библиотека:

express: Создает веб-сервер, который обрабатывает API-запросы
axios: Выполняет HTTP-запросы к другим API (например, Spotify)
sentiment: Анализирует текст для определения эмоций/настроения
dotenv: Безопасно хранит секретные ключи API
spotify-web-api-node: Подключается к Spotify для получения музыкальных данных

Теперь откройте вашу папку, перейдя в файл, затем открыть папку и найти папку с именем mood-music-api и открыть ее.

Теперь вы должны видеть папку с именем Mood-MUSIC-API в вашем проводнике с node modules, файлом package-lock.json и файлом package.json внутри.

Получение ваших ключей Spotify API (пошагово)

Теперь вы хотите создать новый файл и назвать его .env. Для этого вы можете нажать на File, затем New File и ввести .env, затем нажать enter и ввести имя файла снова .env и нажать Create File.

Прежде чем вводить что-либо в этот файл, нам нужно получить наши ключи API.

Шаг 1: Создание учетной записи разработчика Spotify

Перейдите на: developer.spotify.com

Что вы увидите:

Ссылку "Log in" в правом верхнем углу
Если у вас нет Spotify: нажмите "Sign up" (это бесплатно!)
Если у вас есть Spotify: используйте существующую учетную запись

Важно: Вам не нужен Spotify Premium - бесплатные учетные записи отлично работают для доступа к API!

Шаг 2: Создание вашего приложения

После входа в систему:

Нажмите "Create app"

Заполните форму:

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

Какие API вы планируете использовать?

✅ Поставьте галочку "Web API"
✅ Поставьте галочку "Web Playback SDK" (опционально, для будущих функций)

Согласитесь с условиями и нажмите "Save"

Шаг 3: Получите ваши секретные ключи

После создания приложения:

Вы увидите панель управления вашего приложения
В разделе Basic Information вы увидите два важных элемента информации:

Client ID: abc123def456... (видимый, 32 символа)
Client Secret: [Show client secret] (нажмите для открытия)

Нажмите "Show client secret" для открытия секретного ключа
Скопируйте оба ключа - они понадобятся на следующем шаге!

Что делают эти ключи:

Client ID: Публичный идентификатор вашего приложения (как имя пользователя)
Client Secret: Пароль вашего приложения (держите в секрете!)

Шаг 4: Добавьте ключи в ваш проект

Добавьте ваши ключи в созданный файл .env:

SPOTIFY_CLIENT_ID=your_actual_client_id_here
SPOTIFY_CLIENT_SECRET=your_actual_client_secret_here
PORT=3000

Нажмите ctrl + s или cmd + s или File затем save для сохранения изменений.

Шаг 5: Защитите ваши секреты

Важно: Никогда не делитесь вашим Client Secret публично!

Добавьте .env в ваш файл .gitignore, используя следующие команды в терминале:

# Создать файл .gitignore
# Или на macOS/Linux
touch .gitignore

# или PowerShell
New-Item -Path ".gitignore" -ItemType "file"
# Или еще проще: 
echo $null > .gitignore

# Добавьте эту строку в .gitignore:
.env
node_modules/

Нажмите ctrl + s или cmd + s или File затем save для сохранения изменений.

Движок определения настроения

Создайте файл и назовите его moodAnalyzer.js - здесь происходит магия.

Добавьте следующий код в файл и сохраните изменения.

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

class MoodAnalyzer {
  analyzeMood(text) {
    const result = sentiment.analyze(text);
    
    // Улучшенное определение настроения с контекстными подсказками
    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);
    
    // Проверка специфических ключевых слов настроения
    for (const [mood, keywords] of Object.entries(moodKeywords)) {
      if (keywords.some(keyword => lowerText.includes(keyword))) {
        detectedMood = mood;
        confidence += 2;
        break;
      }
    }
    
    // Запасной вариант к оценке тональности
    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();

Мастер плейлистов Spotify

Создайте файл и назовите его playlistGenerator.js. Затем добавьте следующий код и сохраните изменения:

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('🔑 Попытка аутентификации Spotify...');
      console.log('Client ID:', process.env.SPOTIFY_CLIENT_ID ? 
        `${process.env.SPOTIFY_CLIENT_ID.substring(0, 8)}...` : 'ОТСУТСТВУЕТ');
      console.log('Client Secret:', process.env.SPOTIFY_CLIENT_SECRET ? 
        `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'ОТСУТСТВУЕТ');
      
      const data = await this.spotifyApi.clientCredentialsGrant();
      this.spotifyApi.setAccessToken(data.body['access_token']);
      console.log('🎵 Spotify подключен успешно!');
    } catch (error) {
      console.error('❌ Подключение к Spotify не удалось:', error.message);
      console.error('Код состояния:', error.statusCode);
      console.error('Это обычно означает неверные учетные данные API');
    }
  }
  
  // ... (остальная часть кода как показано в вашем документе)
}

module.exports = PlaylistGenerator;

API-сервер для чтения мыслей

Создайте файл и назовите его server.js, добавьте следующий код и сохраните изменения:

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

// Добавьте node-fetch для старых версий Node.js
let fetch;
if (typeof globalThis.fetch === 'undefined') {
  console.log('📦 Node.js fetch недоступен, используется пакет node-fetch...');
  try {
    fetch = require('node-fetch');
  } catch (error) {
    console.error('❌ Пожалуйста, установите node-fetch: npm install node-fetch');
    process.exit(1);
  }
} else {
  fetch = globalThis.fetch;
  console.log('✅ Используется встроенный Node.js fetch');
}

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

app.use(express.json());

// Красивый веб-интерфейс
app.get('/', (req, res) => {
  res.send(\`
    <!DOCTYPE html>
    <html>
    <head>
        <title>API для чтения мыслей</title>
        <style>
            /* Красивые градиентные стили и пользовательские аудио элементы управления */
        </style>
    </head>
    <body>
        <div class="container">
            <h1>🧠🎵 API для чтения мыслей</h1>
            <p class="subtitle">Расскажите мне, как вы себя чувствуете, и я создам идеальный плейлист для вашего настроения!</p>
            
            <textarea id="moodText" placeholder="Напишите, как вы себя чувствуете..."></textarea>
            <button onclick="generatePlaylist()">🎧 Создать мой плейлист</button>
            
            <div id="result" style="display:none;" class="result">
                <!-- Результаты появятся здесь -->
            </div>
        </div>
        
        <script>
            // JavaScript для генерации плейлистов и аудио управления
        </script>
    </body>
    </html>
  \`);
});

// Магическая конечная точка
app.post('/api/mood-playlist', async (req, res) => {
  // Логика API здесь
});

app.listen(PORT, () => {
  console.log(`🚀 API для чтения мыслей работает на http://localhost:${PORT}`);
  console.log('🧠 Готов анализировать настроения и генерировать плейлисты!');
});

Шаг 5: Тестирование вашего эмоционального ИИ

Запустите ваш сервер:

node server.js

Вы должны увидеть что-то вроде этого:

Теперь откройте ваш веб-браузер и перейдите по локальной ссылке, показанной на изображении выше (http://localhost:3000) для тестирования вашего API для чтения мыслей!

Распространенные подводные камни, которых следует избегать

Ограничения Spotify API: Бесплатный уровень имеет ограничения скорости. Кэшируйте ответы и реализуйте логику повторных попыток для продакшн использования.
Неправильная интерпретация настроения: Тестируйте пограничные случаи, такие как сарказм ("отлично, еще один понедельник..."), которые могут сбить с толку анализ тональности.
Пустые плейлисты: Всегда обрабатывайте случаи, когда Spotify не возвращает рекомендаций, предоставляя запасные жанры.
Раскрытие ключей API: Никогда не коммитьте ваш файл .env. Используйте переменные окружения в продакшене.

Следующие шаги

Теперь мы создали что-то действительно крутое! Вот как сделать это еще лучше:

Добавьте учетные записи пользователей: Храните историю настроений и предпочтения плейлистов
Машинное обучение: Тренируйте пользовательские модели на обратной связи пользователей для улучшения точности
Социальные функции: Позвольте пользователям делиться плейлистами настроений с друзьями
Голосовая интеграция: Подключитесь к API speech-to-text для голосового определения настроения
Интеграция с носимыми устройствами: Читайте данные о частоте сердечных сокращений и активности для более глубоких инсайтов настроения
Развертывание и масштабирование: Используйте Redis для кэширования, реализуйте правильную аутентификацию

Ваш API для чтения мыслей теперь может понимать человеческие эмоции и отвечать идеальными саундтреками. Эта комбинация ИИ-анализа тональности и музыкальной курации представляет будущее персонализированных впечатлений. Возможности безграничны!

Следите за нашим следующим учебником, где мы будем дальше развивать это приложение...