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
--spotify-cleanup PATTERN	Remove playlists matching glob pattern (dry run unless --confirm)	Off
--spotify-export [DIR]	Export matching playlist tracks to JSON files	.
--confirm	Execute cleanup (without this, --spotify-cleanup is preview only)	Off
--max N	Safety cap: max playlists to remove per invocation	No limit
--spotify-client-id ID	Spotify app client ID (or SPOTIFY_CLIENT_ID env var)	—
--spotify-client-secret SECRET	Spotify app client secret (or SPOTIFY_CLIENT_SECRET env var)	—

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