Music Digger

YouTube + Safari + Apple Music で音楽を掘るための MCP サーバー。Claude Code から自然言語で操作し、聴いて反応した曲だけを Obsidian Vault に蓄積する。

v0.2.0 で再生エンジンを YouTube に切り替えました。 旧 Apple Music + AppleScript ベースの理由は docs/superpowers/specs/2026-06-13-youtube-pivot.md を参照。

ワークフロー

1. play_station("Roy Ayers") → YouTube 検索 → Safari で再生（autoplay 無し、MCP が制御）
2. 気に入ったら mark_current("love") → Obsidian 日記に追記 + iTunes Search API で楽曲を照合 → Music.app で同じ楽曲ページを開く（あとはユーザーが「+」でライブラリ追加・再生）
3. love 1 回 or like 2 回でアルバムカードに自動昇格

Apple Music カタログの「特定の曲」を AppleScript から再生する公式 API は無く、URL を open しても navigate するだけで自動再生しない。digger としての再生は YouTube + Safari に統一し、Apple Music は「気に入った曲をあとで聴くための着地点」として使い分ける。

Tools

• play_station(seed?) — YouTube 検索で seed の station を Safari で起動。seed 省略時は music/stations.md からランダム
• play_album(artist, album) — <artist> <album> full album で YouTube 検索 → Safari
• current_track() — MCP が「最後に再生指示した曲」の情報を返す（ブラウザに問い合わせない）
• mark_current(reaction, note?, artist?, album?, track?) — 現在曲を love / like / meh / skip でマーク。日記追記 + 昇格判定。love / like の時は iTunes Search API で Apple Music カタログを引いて、Music.app に楽曲ページを開く

動作環境

• macOS（Safari、Music.app、open コマンド）
• Node.js 18+ (built-in fetch)
• YouTube アカウント（Safari でログイン推奨。Premium ならバックグラウンド再生・広告無し）
• Apple Music サブスクリプション（love した曲を Music.app で続けるなら）
• Obsidian Vault

セットアップ

npm install
npm run build

Safari で YouTube にログインしておく（Premium 推奨）。youtube.com の autoplay は OFF にしておくと state ずれが起きない。

Claude Code への接続

examples/mcp.json を参考に、Claude Code の .mcp.json に music-digger エントリを追加して再起動する。

開発

npm run dev          # tsx watch でホットリロード
npm test             # vitest
npm run test:watch   # vitest watch

環境変数

変数	デフォルト	用途
OBSIDIAN_VAULT_PATH	必須	Obsidian Vault のルート
MUSIC_DIARY_SUBDIR	music/diary	反応日記の保存先
MUSIC_ALBUMS_SUBDIR	music/albums	アルバムカードの保存先
MUSIC_STATIONS_PATH	music/stations.md	station の seed リスト

stations.md の書き方

## ソウル / ファンク
- Aaron Frazer       # Introducing... が今のお気に入り (Bad News)
- Curtis Harding     # ◎ The Power
- Roy Ayers          # ◎ Everybody Loves The Sunshine

## スキップ中
# - Lofi             # 今の気分じゃない

• 行頭 - で 1 行 1 seed
• 行頭が # の行はコメント / 無効化
• 末尾の # ... は seed の覚え書き（パーサーが無視する）

仕様書 / 実装計画

• docs/superpowers/specs/2026-06-12-music-digger-mcp-design.md — 初版（Apple Music ベース、現在は参考資料）
• docs/superpowers/specs/2026-06-13-youtube-pivot.md — YouTube 移行設計メモ
• docs/superpowers/plans/2026-06-12-music-digger-mcp.md — 旧実装計画

注意

• YouTube の HTML スクレイピングを使用しているため、YouTube 側のレイアウト変更で壊れる可能性があります（個人用前提）
• current_track は MCP がこのセッションで再生指示した曲のみを反映します。ブラウザ上で手動で次の曲に進めた場合は state がずれます（その間 mark_current を呼ばなければ実害なし）
• mark_current の love / like で Music.app の楽曲ページが開きますが、ライブラリへの追加は手動で「+」を押してください