ytmusic-librarian

What This Skill Does

The ytmusic-librarian skill provides an automated bridge between the OpenClaw AI agent and your YouTube Music library. By leveraging the ytmusicapi library, this skill allows users to perform complex music management tasks without manual navigation of the YouTube Music interface. It enables programmatic interaction with your cloud-based library, facilitating the organization of songs, albums, and curated playlists, as well as accessing song metadata such as lyrics and related track discovery.

Installation

1. Install the core Python dependency: pip install ytmusicapi.
2. Acquire your authentication credentials using the cURL handshake method: Navigate to music.youtube.com in Microsoft Edge, open the Network tab in Developer Tools, locate a browse request, and copy it as a cURL command.
3. Save this to headers.txt in your skill directory.
4. Execute the setup script to generate browser.json, which must persist in the skill folder for authenticated access.
5. Verify the installation by running the provided one-liner Python test command to print a library song.

Use Cases

This skill is ideal for power users who want to automate their music experience. You can use it to migrate playlists from other services (via external imports), automate the curation of "liked" songs based on specific criteria, extract lyrics for offline storage or analysis, and discover new music by programmatically querying related tracks. It is perfect for building a personalized, AI-driven listening assistant.

Example Prompts

• "Add all the songs in my current 'Discovery' queue to my 'Chill Vibes' playlist."
• "What are the lyrics to the song with video ID 'dQw4w9WgXcQ'?"
• "Find ten songs related to my recent favorites and suggest a new playlist name for them."

Tips & Limitations

Authentication is session-based and may require periodic refreshes if your browser cookies expire. Avoid performing high-frequency requests, as Google's anti-bot measures may trigger rate limiting on your account. Always ensure your browser.json is kept private, as it contains sensitive session tokens that grant full access to your YouTube Music account.