musickit

Integrate Apple Music and ShazamKit APIs for catalog search, library management, playback, and audio recognition.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill musickit-autisticaf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: musickit
Source: https://github.com/AutisticAF/claude-code-apple-dev-plugin/tree/main/skills/musickit
Command: npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill musickit-autisticaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrating Apple Music and audio recognition into apps is complex: developers must handle catalog search, library access, playback control, subscription checks, authorization flows, and optional ShazamKit matching while respecting platform availability and privacy requirements.

Core Features & Use Cases

  • Catalog Search & Fetching: Build MusicCatalogSearchRequest and MusicCatalogResourceRequest flows to find songs, albums, artists, and charts.
  • User Library Management: Query and modify the user's MusicLibrary with authorization-aware requests and sorting/filtering.
  • Playback Control: Manage in-app playback with ApplicationMusicPlayer or control the system player via SystemMusicPlayer, including queue management and transport state handling.
  • Subscription & UI Integration: Detect subscription status, present subscription offer sheets in SwiftUI, and render artwork with ArtworkImage.
  • Audio Recognition with ShazamKit: Recognize live audio via SHSession/SHManagedSession, build SHCustomCatalogs for custom matching, and generate signatures with AVAudioEngine/SHSignatureGenerator.
  • Privacy & Platform Notes: Includes guidance on required Info.plist keys, API availability across iOS/macos/watchOS/tvOS, and async/await usage patterns.

Quick Start

Use the musickit skill to search the Apple Music catalog for "Taylor Swift" songs and return playable Song objects.

Frequently Asked Questions about musickit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the Apple Music catalog and return playable Song objects in Swift?▼

You can query the Apple Music catalog using MusicCatalogSearchRequest to find songs and artists, then fetch specific resources with MusicCatalogResourceRequest to return playable Song objects via async/await.

How do I manage user library access and authorization with MusicKit?▼

MusicKit manages user library access through authorization-aware MusicLibraryRequest flows, allowing you to query, sort, and modify the user's MusicLibrary while respecting required privacy permissions.

Can I control Apple Music playback in-app versus controlling the system player?▼

You can manage in-app playback with ApplicationMusicPlayer or control the system player via SystemMusicPlayer, handling queue management and transport states across iOS, macOS, tvOS, and watchOS.

How do I recognize live audio and build custom matching catalogs with ShazamKit?▼

Recognize live audio using SHSession or SHManagedSession, generate audio signatures with AVAudioEngine and SHSignatureGenerator, and build SHCustomCatalogs for custom audio matching.

Do I need specific Info.plist privacy keys and subscription checks for MusicKit integration?▼

MusicKit integration requires adding Info.plist privacy keys for authorization, checking subscription status, and presenting subscription offer sheets in SwiftUI to respect platform availability and privacy guidelines.