music-discovery音乐发现

Mood- and context-aware music discovery—recommend tracks, build playlists, and match energy (BPM), vibe, and genre using Spotify/Last.fm-style workflows. Keywords: music recommendation, playlist, mood, Spotify, study music, workout mix.

作者: admin | 来源: ClawHub

Music Discovery — Mood, Scene & Playlists

Overview

Helps listeners find tracks and playlists that fit a mood, activity, or taste profile—study, commute, workout, sleep, or “something like this artist.” Use when the user wants personalized picks, scene-based sets, or exploration without manual crate-digging.

Trigger keywords: music recommendation, playlist, mood, BPM, study music, workout, discover similar artists

Prerequisites

CODEBLOCK0

Capabilities

1. Data-backed discovery — Spotify Web API / Last.fm–style metadata (see references/music_discovery_guide.md).
Scene-based sets — work, workout, wind-down, commute, focus, party.
Vibe matching — BPM, energy, valence/mood tags, genre boundaries.

Commands

Command	Description	Example
INLINECODE1	Recommend tracks	INLINECODE2
INLINECODE3

Build a playlist concept | python3 scripts/skills/music-discovery/scripts/music_discovery_tool.py playlist [args] | | mood | Recommend by mood | python3 scripts/skills/music-discovery/scripts/music_discovery_tool.py mood [args] |

Usage (from repository root)

CODEBLOCK1

Output format (for the agent’s report)

CODEBLOCK2

References

APIs & libraries

Patterns & community

Notes

- Prefer real API or user-provided data; do not invent popularity or audio features.
Mark missing fields as unavailable instead of guessing.
OAuth and rate limits apply when using Spotify—document when credentials are required.

音乐发现 — 情绪、场景与播放列表

概述

帮助听众找到符合情绪、活动或品味偏好的曲目和播放列表——学习、通勤、锻炼、睡眠，或“类似这位艺术家的作品”。当用户想要个性化推荐、基于场景的曲目集合，或无需手动挖掘的探索时使用。

触发关键词：音乐推荐、播放列表、情绪、BPM、学习音乐、锻炼、发现相似艺术家

前置条件

bash
pip install requests spotipy

功能

1. 数据驱动的发现 — Spotify Web API / Last.fm 风格元数据（参见 references/musicdiscoveryguide.md）。
基于场景的曲目集合 — 工作、锻炼、放松、通勤、专注、派对。
氛围匹配 — BPM、能量、效价/情绪标签、流派边界。

命令

命令	描述	示例
recommend	推荐曲目	python3 scripts/skills/music-discovery/scripts/musicdiscoverytool.py recommend [参数]
playlist

使用方法（从仓库根目录）

bash
python3 scripts/skills/music-discovery/scripts/musicdiscoverytool.py recommend --scene office --mood relaxed
python3 scripts/skills/music-discovery/scripts/musicdiscoverytool.py playlist --scene workout --bpm 140
python3 scripts/skills/music-discovery/scripts/musicdiscoverytool.py mood --feeling happy

输出格式（供代理报告使用）

markdown

音乐发现报告

生成时间：YYYY-MM-DD HH:MM

主要推荐

1. [曲目 / 艺术家 — 一行说明原因]
…
…

概览

| 标题 | 艺术家 | 为何适合 | |-------|--------|---------------|

播放列表草稿（可选）

- 主题：…
节奏/能量：…
避免：…

备注

[基于API或用户陈述的品味进行论证——不虚构排行榜位置。]

参考资料

API与库

模式与社区

备注

- 优先使用真实API或用户提供的数据；不虚构流行度或音频特征。
将缺失字段标记为不可用，而非猜测。
使用Spotify时需注意OAuth和速率限制——在需要凭据时进行说明。