心を読む音楽API：Node.jsでAI搭載ムード・プレイリスト・ジェネレーターを構築

「今振られて雨が降っている」と入力するだけで、あなたの気持ちに完璧に合ったプレイリストを瞬時に取得できることを想像してみてください。今日は、テキストから人間の感情を読み取り、AI感情分析を使用してカスタムSpotifyプレイリストを生成するAPIを構築します。これは単なるもう一つのチュートリアルではありません。私たちは本当に人々の日を向上させることができるものを作成しています。

必要なもの

Node.jsのインストール (nodejs.org)
Spotify開発者アカウント（developer.spotify.comで無料）
コードエディタ - VS Codeを使用しますが、慣れ親しんだコードエディタがある場合はそれを使用できます。そうでなければVS Codeをこちらからダウンロードできます：https://code.visualstudio.com/
OpenAI APIキー（または無料の感情分析ライブラリを使用します）
JavaScript の基本知識
たった30分のお時間

Node.jsのダウンロードとインストール

nodejs.orgにアクセス

Get Node.jsをクリック

ページを'Or get a prebuilt Node.js'まで下にスクロール

プリビルトインストーラーは、特に初心者にとって最良の選択肢です：

30分以上のコンパイルではなく2分のセットアップ
確実に動作し、何百万人によってテストされている
より早くコーディングを開始できる

オペレーティングシステム（Windows、macOs、Linux、AIX）を選択

ダウンロードボタンをクリック（ボタンテキストはWindows Installer (.msi)、macOs (.pkg)、Linux (.xz)、またはStandalone Binary (.gz)になります）

ダウンロード後、インストーラーを開いて次のインストール手順に従ってください：

ステップ1：ウェルカム画面

ダウンロードしたインストーラーファイルをダブルクリックしてインストールプロセスを開始します。Node.js Setup Welcome画面が表示されます。

「Next」をクリックして続行します。

ステップ2：ライセンス契約

ライセンス契約を読む（または素早くスクロール - これは標準のオープンソースライセンスです）。

「I accept the terms in the License Agreement」チェックボックスにチェックを入れる。

「Next」をクリックして進む。

ステップ3：インストール場所の選択

デフォルトのインストールパスを保持（通常WindowsではC:\Program Files\nodejs\）。

別の場所にインストールする特別な理由がない限り、何も変更しない。

「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」をクリックして続行。

💡 このチェックボックスが重要な理由：

多くのnpmパッケージはネイティブコードのコンパイルが必要でこれらのツールなしでは動作しません
これらのツールがないと、パッケージをインストールする際に暗号的なエラーメッセージが出るでしょう
これにより後の開発過程で何時間ものトラブルシューティングを節約できます

ステップ6：インストール準備完了

インストール設定を最終確認。

「Install」をクリックしてインストールプロセスを開始。

注意：WindowsユーザーアカウントコントロールPromptが表示される場合があります - インストールを許可するには「Yes」をクリック。

ステップ7：インストール完了

インストールの完了を待つ - 通常1-2分かかります。

インストールが完了したら「Finish」をクリック。

ステップ8：追加ツールのインストール（ステップ5でボックスにチェックを入れた場合）

ステップ5で「automatically install tools」オプションにチェックを入れた場合、このようなコマンドプロンプトウィンドウが表示されます：

👆 いずれかのキーを押してインストールプロセスを開始

次に何が起こるか：

プロンプトが表示されたらANY KEYを押してPythonとVisual Studio Build Toolsのインストールを開始
10-15分間辛抱強く待つ - これは多くのnpmパッケージに必要な開発ツールをインストールします
たくさんのテキストがスクロールするのが見える - これは正常です！ウィンドウを閉じないでください
インストールが完了したらENTERを押してインストーラーを終了

もう一度いずれかのキーをクリック...アプリがPCに変更を加えることを許可するかどうかを尋ねる別のポップアップが表示される場合があります。はいをクリックしてインストールを続行してください。その後、このようなものが表示されるはずです：

📦 ビルドツールをインストール中 - これには10-15分かかることがあります

インストールが完了するまで待ち、指示に従ってターミナルの下部でENTERと入力し、キーボードの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はプロジェクトのIDカードとショッピングリストのようなもの

なぜ必要か：

Node.jsにこのフォルダがNode.jsプロジェクトであることを伝える
プロジェクトが必要とするライブラリ（パッケージ）を追跡
名前、バージョン、説明などのプロジェクト情報を保存

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

何をするか：

プロジェクトに必要な5つの異なるコードライブラリをダウンロードしてインストール
何千ものファイルを含むnode_modulesフォルダを作成
これらの依存関係を覚えるためにpackage.jsonを更新

各ライブラリの役割：

express: APIリクエストを処理するWebサーバーを作成
axios: 他のAPI（Spotifyなど）へのHTTPリクエストを作成
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の下に2つの重要な情報が表示されます：

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を公開しないでください！

ターミナルで次のコマンドを使用して.gitignoreファイルに.envを追加：

# .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)}...` : 'MISSING');
      console.log('Client Secret:', process.env.SPOTIFY_CLIENT_SECRET ? 
        `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'MISSING');
      
      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.jsバージョン用にnode-fetchを追加
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());

// 美しいWebインターフェース
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：感情AIのテスト

サーバーを起動：

node server.js

次のようなものが表示されるはずです：

今すぐWebブラウザを開いて、上の画像に示されているローカルリンク (http://localhost:3000) にアクセスして、心読み取り音楽APIをテストしてください！

避けるべき一般的な落とし穴

Spotify APIの制限: 無料ティアにはレート制限があります。プロダクション使用にはレスポンスをキャッシュし、リトライロジックを実装してください。
ムードの誤解釈: 皮肉（「素晴らしい、また月曜日...」）などの感情分析を混乱させる可能性があるエッジケースをテストしてください。
空のプレイリスト: Spotifyがレコメンデーションを返さない場合は、フォールバックジャンルを提供することで常に対処してください。
APIキーの露出: .envファイルをコミットしないでください。プロダクションでは環境変数を使用してください。

次のステップ

今、私たちは本当にクールなものを構築しました！さらに良くするための方法：

ユーザーアカウントの追加: ムード履歴とプレイリスト設定を保存
機械学習: ユーザーフィードバックでカスタムモデルをトレーニングして精度向上
ソーシャル機能: ユーザーが友達とムードプレイリストを共有できるように
音声統合: 音声ムード検出のためのspeech-to-text APIと接続
ウェアラブル統合: より深いムードインサイトのために心拍数と活動データを読み取り
デプロイとスケール: キャッシュにRedisを使用し、適切な認証を実装

あなたの心読み取り音楽APIは今、人間の感情を理解し、完璧なサウンドトラックで応答できます。このAI感情分析と音楽キュレーションの組み合わせは、パーソナライズされたエクスペリエンスの未来を表しています。可能性は無限大です！

このアプリをさらに開発する次のチュートリアルにご期待ください...