podcast-downloader

The podcast-downloader is a robust Claude Skill designed for users who need to interact with the vast Apple Podcasts ecosystem programmatically. It leverages the iTunes Search API to provide high-speed, reliable access to podcast discovery and media acquisition. Whether you are a content creator, a researcher, or an audio enthusiast, this tool simplifies the workflow of finding specific podcasts by keyword, author, or topic, and allows for precise control over episode downloads.

• Advanced Search: Query the Apple iTunes API to find podcasts by name, artist, or specific genre with adjustable result limits.

• Episode Management: Browse podcast series to retrieve episode lists, including release dates, durations, and detailed descriptions.

• Targeted Downloading: Download specific episodes or batch-process the latest episodes directly to your local storage with organized directory structures.

• Metadata Retrieval: Access comprehensive metadata including RSS feed URLs, explicit content ratings, publisher info, and multi-resolution artwork.

• Multi-Mechanism Strategy: Employs a robust strategy including API-first queries, list-based searching, and RSS parsing as a fallback to ensure reliability.

• Typical Inputs: Natural language requests like 'Download the latest episode of [Podcast Name]' or 'List top 5 episodes of [Topic]'.

• Outputs: MP3 audio files saved to local paths and structured JSON output for metadata inspection.

• Performance Constraints: Designed for sequential processing to maintain API health; supports default 10-result limits to stay within typical API quotas.

• Compatibility: Uses Python 3 standard libraries and command-line execution, making it lightweight and cross-platform compatible within your development environment.

• Best Practices: Always verify download permissions and directory structures before batch operations to ensure files are saved correctly.