classical-887

name	classical-887
description	Check what's playing on WRHV 88.7 FM (Classical WMHT), fetch recent tracks, build playlist reports, search for pieces, and create or manage Spotify playlists from radio tracks. Triggers on 'Classical 887', 'WRHV', 'what's playing', 'classical radio', 'Hudson Valley radio', 'Spotify playlist from radio'.

Classical 887

Check what's playing on WRHV 88.7 FM (Classical WMHT) — the classical music station in the Hudson Valley. Queries the NPR Composer API for real-time playlist data and provides clickable links to listen on YouTube, Spotify, Apple Music, IMSLP, IDAGIO, Internet Archive, and Musopen.

When to Use

• Checking what's playing right now on 88.7
• Getting recent tracks with links to listen again
• Building a Markdown playlist report
• Finding a specific piece heard on the radio
• Creating Spotify playlists from radio tracks
• Renaming Spotify playlists
• Auditing owned Spotify playlists (list, search, sort)
• Cleaning up accumulated Spotify playlists (safe bulk removal)
• Exporting playlist track data to JSON before cleanup
• Reviewing playlist operation history

Prerequisites

• requests Python package (uv pip install --system requests)
• No API key required — uses NPR's public Composer API
• Spotify integration (optional): spotipy package (uv pip install --system spotipy) + Spotify Developer App credentials

Usage

# What's playing right now (default)
python3 ~/.claude/skills/classical-887/scripts/classical_887.py

# Last 10 tracks
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --recent 10

# Today's full playlist (pages through all tracks for today)
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period today

# Last week as Markdown report
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period week --markdown ~/Desktop/classical-week.md

# Last month as Markdown report
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period month --markdown ~/Desktop/classical-month.md

# Specific date (Valentine's Day)
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --date 2026-02-14

# Search for a composer across a date range
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period week --search bach

# Full performer details (album, label, catalog number)
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --recent 5 --verbose

# Raw JSON output
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --now --json

# Create Spotify playlist from today's tracks
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period today --spotify-playlist

# Add yesterday's tracks to the persistent playlist
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period yesterday --spotify-playlist

# Custom playlist name from a specific date
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --date 2026-02-14 --spotify-playlist "Valentine's Classical"

# Last week's Bach on Spotify
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --period week --search bach --spotify-playlist "Bach on 88.7"

# Rename the default playlist
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-rename "Hudson Valley Classical"

# Rename a specific playlist with a new description
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-playlist "Bach on 88.7" --spotify-rename "Bach Collection" --spotify-description "Curated Bach from WRHV 88.7 FM"

# View playlist operation log as Markdown
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-log-report

# Audit all owned Spotify playlists
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-audit

# Audit with search filter and sort by track count
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-audit --search "Rediscover*" --sort tracks

# Dry run cleanup (preview only, no deletion)
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-cleanup "Rediscover*"

# Execute cleanup with safety cap
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-cleanup "Rediscover*" --confirm --max 10

# Export playlist tracks to JSON before cleanup
python3 ~/.claude/skills/classical-887/scripts/classical_887.py --spotify-export ~/Desktop/exports --search "Rediscover*"

Parameters

Flag	Description	Default
--now	Show what's playing now	On (if no other mode)
--recent N	Show last N tracks (1–100)	Off
--date YYYY-MM-DD	Fetch all tracks from a specific date	Off
--period PERIOD	Fetch tracks from: today, yesterday, week, month	Off
--search QUERY	Filter results by composer, piece, or performer	Off
--verbose	Full details (album, label, catalog, all performers)	Off
--json	Raw JSON output	Off
--markdown [FILE]	Write Markdown report with clickable links	classical-playlist.md
--sort FIELD	Sort by: time (newest first), duration (longest), composer (A–Z)	time
--spotify-playlist [NAME]	Create/append to a Spotify playlist	Classical 88.7 FM
--spotify-rename NEW_NAME	Rename an existing Spotify playlist (defaults to renaming Classical 88.7 FM unless --spotify-playlist specifies the current name)	Off
--spotify-description DESC	Set new description when renaming (used with --spotify-rename)	Off
--spotify-log-report	View the playlist operation log as a Markdown report	Off
--spotify-audit	List all owned Spotify playlists (combine with --search and --sort)	Off

Output

Default shows: composer, piece, performers, duration, and listen links (YouTube, Spotify, Apple Music, IMSLP, IDAGIO, Internet Archive, Musopen).

Markdown report includes: now-playing header, recent tracks table with 7 platform links, and a composer index.

Playlist Log

Every --spotify-playlist operation automatically appends a JSONL entry to ~/.claude/skills/classical-887/playlist-log.jsonl. Each entry records:

• Date and action (created/appended)
• Playlist name and Spotify URL
• Tracks added (composer, piece, performers, duration, Spotify URI)
• Tracks not found on Spotify
• Total counts (matched/unmatched)

View the log as a Markdown report with --spotify-log-report. The log file is append-only and can be queried with standard jq commands:

# Count total operations
wc -l ~/.claude/skills/classical-887/playlist-log.jsonl

# Show all playlist names used
cat ~/.claude/skills/classical-887/playlist-log.jsonl | jq -r '.playlist_name' | sort -u

# Total tracks matched across all operations
cat ~/.claude/skills/classical-887/playlist-log.jsonl | jq '.matched_count' | paste -sd+ | bc

Data Source

NPR Composer API (api.composer.nprstations.org/v1/widget/), which powers the WMHT playlist widget at classicalwmht.org/playlist.

Full API documentation: references/api-reference.md

Station Info

WRHV 88.7 FM (Poughkeepsie, NY), simulcast of WMHT-FM 89.1 (Schenectady). Full station details in references/api-reference.md.

• Stream: wmht.org/classical
• Playlist: classicalwmht.org/playlist

Fallback

If the NPR Composer API is unavailable:

# Check the playlist page directly
firecrawl scrape "https://classicalwmht.org/playlist" --only-main-content

Reference Documentation

File	Contents
references/api-reference.md	NPR Composer API: endpoints, request/response schema, field reference
references/spotify-setup.md	Spotify Developer App setup, OAuth, env vars, Dev Mode notes