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.