SkillHub

youtube-music-mv-detector

v1.0.0

Detect YouTube Music links as MV (music video) or song (audio). Use when user shares YouTube Music links (music.youtube.com/watch?v=...) and you need to classify them as MV or audio track.

Sourced from ClawHub, Authored by Nico Wu

Installation

Please help me install the skill `youtube-music-mv-detector` from SkillHub official store. npx skills add Ver0n1ca/youtube-music-mv-detector

YouTube Music MV Detector

Detection Method

Use YouTube's free oEmbed API (no API key needed):

https://www.youtube.com/oembed?url={youtube_music_url}&format=json

Classification Rules

After fetching oEmbed data, check:

🎬 MV (Music Video) - if ANY true:

  1. Author does NOT contain " - Topic"
  2. Title contains "(Official Music Video)", "(Music Video)", "MV", "(Official Video)"

🎵 Song (Audio) - if ANY true:

  1. Author contains " - Topic" (YouTube Topic channels = audio tracks)
  2. Title is just the song name without video indicators

Examples

URL Title Author Result
music.youtube.com/watch?v=1rvqA8rMTu8 Iceage - Star (Official Music Video) Iceage 🎬 MV
music.youtube.com/watch?v=Mh5Y8vusknE Star Iceage - Topic 🎵 Song
music.youtube.com/watch?v=wtJcLWeY114 amazarashi...ED amazarashi Official YouTube Channel 🎬 MV
music.youtube.com/watch?v=HPMwDxi9-e0 Kisetsu Wa Tsugitsugi Shindeiku amazarashi - Topic 🎵 Song

Workflow

  1. Extract video ID from YouTube Music URL
  2. Call oEmbed API: https://www.youtube.com/oembed?url=...&format=json
  3. Parse title and author_name from JSON response
  4. Apply classification rules above
  5. Return result with title and classification

Notes

  • YouTube Music URLs may include extra params like &list=... or &si=... - strip these before calling oEmbed
  • oEmbed is free and doesn't require authentication
  • This works for both regular YouTube and YouTube Music links