Agent Skills › happycapy-ai/Happycapy-skills › youtube-music

youtube-music

GitHub

通过 MCP 协议集成 YouTube Music，支持 AI 助手搜索歌曲及在浏览器中播放。需配置 API Key，适用于音乐检索与播放场景。

skills/youtube-music/SKILL.md happycapy-ai/Happycapy-skills

触发场景

用户想要搜索特定歌曲或艺术家用户希望播放音乐或发现新曲目

安装

npx skills add happycapy-ai/Happycapy-skills --skill youtube-music -g -y

更多选项

不安装直接使用

npx skills use happycapy-ai/Happycapy-skills@youtube-music

指定 Agent (Claude Code)

npx skills add happycapy-ai/Happycapy-skills --skill youtube-music -a claude-code -g -y

安装 repo 全部 skill

npx skills add happycapy-ai/Happycapy-skills --all -g -y

预览 repo 内 skill

npx skills add happycapy-ai/Happycapy-skills --list

SKILL.md

Frontmatter

{
    "name": "youtube-music",
    "description": "Search and play music tracks on YouTube Music through MCP integration. Use when user wants to search for songs, play music, or discover tracks on YouTube Music platform."
}

YouTube Music MCP

🎵 A Model Context Protocol (MCP) server that enables AI assistants to search for and play tracks on YouTube Music.

Overview

This skill provides integration with YouTube Music through the MCP protocol, allowing you to search for songs by title or artist name and play them directly in the user's default web browser.

Available Tools

searchTrack - Search for music tracks on YouTube Music by title or artist name
playTrack - Search and automatically open tracks in the default web browser

Prerequisites

Before using this skill, ensure you have:

A valid Google YouTube API Key from the Google Cloud Console
Cursor or Claude Desktop properly configured

Installation

Add the following configuration to your .cursor/mcp.json file (or Claude Desktop configuration):

{
  "mcpServers": {
    "youtube-music-mcp": {
      "command": "npx",
      "args": ["-y", "@instructa/mcp-youtube-music"],
      "env": {
        "YOUTUBE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Replace <YOUR_API_KEY> with your actual YouTube API key.

Usage Examples

Searching for Tracks

User: "Search for Bohemian Rhapsody by Queen"
Assistant: [Uses searchTrack tool to find the track on YouTube Music]

Playing Tracks

User: "Play some jazz music"
Assistant: [Uses playTrack tool to search and open jazz music in browser]

Guidelines

Always verify that the YouTube API key is configured before attempting to use the tools
Provide clear feedback to users about what tracks were found or played
If a track cannot be found, suggest alternative search terms or artists
The playTrack tool will open tracks in the user's default web browser
Respect user preferences for music genres and artists