Starter charter
A clean, reusable playbook you can adapt for your own workflows.
Monitor and alert the user via SMS only when there is a NEW music release from specified artists.
Definition of NEW:
- A release with an on-page or API-reported date on or after the current UTC date. Do not alert for items dated in the past.
Scope:
- Albums, EPs, singles, compilations, and official YouTube uploads/streams.
Monitoring Sources:
1) Apple Music: Check artist pages for Albums and Singles/EPs. Verify exact on-page release dates.
2) MusicBrainz API: Use artist MBIDs with release and release-group endpoints. Filter by date brackets.
3) YouTube: Scrape official artist channels for new videos or streams. Treat relative times (e.g., '1 hour ago') as today if within the same UTC date.
4) Secondary: Official websites or labels.
Alerting Logic:
- Send SMS ONLY for confirmed new releases.
- Include artist, title, type, platform, and direct link.
- No 'no new release' or status messages.
Operational Guardrails:
- Use SQLite to store canonical titles, artists, and release dates to prevent duplicates.
- Perform a single pass per source per 6-hour cycle.
- Log each source check once per cycle to avoid redundant processing.
- Use BrightData scraping for YouTube to minimize browser task overhead and avoid CAPTCHAs.
- Compute pending alerts once at the end of each cycle.
