new-music-digest

Generates a weekly HTML email digest of new album releases from Last.fm, MusicBrainz, and Deezer data.

10|2|Updated May 6, 2026
One-click install
npx skills add https://github.com/jcrabapple/hermes-skills --skill new-music-digest-jcrabapple
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new-music-digest
Source: https://github.com/jcrabapple/hermes-skills/tree/main/new-music-digest
Command: npx skills add https://github.com/jcrabapple/hermes-skills --skill new-music-digest-jcrabapple

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, agentmail, and includes references (resource) components.

What problem does it solve? Keeping track of new album releases from your favorite artists requires manually checking multiple music platforms, and Last.fm's own new-releases endpoint returns unreliable data. This Skill automates the entire pipeline: it pulls your top artists from your real listening history, cross-references release dates, enriches with cover art, and delivers a formatted email digest. ## Core Features & Use Cases - Personalized artist selection: Fetches your top artists from Last.fm using 1-month and 3-month listening windows, deduplicated. - Reliable release tracking: Queries MusicBrainz for full albums released in the last 30 days (Out Now) and upcoming in the next 90 days (Coming Soon), excluding singles, EPs, and compilations. - Rich email delivery: Enriches each album with Deezer cover art, fan counts, and genres, then sends an HTML email via AgentMail with inline CID-attached images. - Use Case: Set up a Friday-morning cron job so every week you receive an email listing new albums from artists you actually listen to, with cover art and listen links. ## Quick Start Run the new-music-digest skill to build and email me this week's new album releases from my Last.fm top artists.

Frequently Asked Questions about new-music-digest

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

FAQPage Schema
How do I track new album releases from my favorite artists automatically?▼

Fetch your top artists from the Last.fm API using your listening history, then query the MusicBrainz API for release groups filtered to full albums within your date window. Enrich results with Deezer cover art and deliver them as an HTML email digest.

How to get new music releases from Last.fm API?▼

Do not use Last.fm's artist.getnewreleases or user.getnewreleases endpoints, as they return unreliable release-date data. Instead, get top artists via user.gettopartists and look up release dates through the MusicBrainz release-group API.

Why does the MusicBrainz API return 429 errors?▼

MusicBrainz enforces a rate limit of roughly one request per second and returns HTTP 429 when exceeded. Add a time.sleep(0.35) delay between calls and always send a descriptive User-Agent header with a real contact email.

Does the Deezer API require authentication for album search?▼

No, Deezer's public endpoints such as search/album, chart/0/albums, and album detail require no API key and have no documented rate limit. They return cover art, fan counts, genres, and listen links suitable for enrichment.

How do I embed images in HTML emails that display when external images are blocked?▼

Download the images, base64-encode them, and attach them with a Content-ID (CID) using inline content disposition. Reference each image in the HTML as cid:your-cid so mail clients render them without loading external URLs.

What are the limitations of this release digest approach?▼

It only includes full albums, deliberately excluding singles, EPs, and compilations. Coverage depends on MusicBrainz having first-release-date data for the artist, and the email is skipped entirely if no releases are found in either window.