| name | lastfm |
| description | Access Last.fm listening history, music stats, and discovery. Query recent tracks, top artists/albums/tracks, loved tracks, similar artists, and global charts. |
Last.fm API Skill
Access Last.fm listening history, music stats, and discovery.
Configuration
Required env vars (add to your shell profile or optionally ~/.clawdbot/.env):
LASTFM_API_KEY — your Last.fm API key (get one here)LASTFM_USER — your Last.fm username
Base URL: http://ws.audioscrobbler.com/2.0/
Docs: https://lastfm-docs.github.io/api-docs/
Example Output
Here's what 17+ years of scrobbling looks like:
Total scrobbles: 519,778
Unique artists: 13,763
Unique tracks: 68,435
Unique albums: 33,637
Top Artists (all time):
• System of a Down (52,775 plays)
• Eminem (15,400 plays)
• Dashboard Confessional (10,166 plays)
• Edguy (10,161 plays)
• Metallica (9,927 plays)
Top Tracks (all time):
• System of a Down - Aerials (1,405 plays)
• System of a Down - Toxicity (1,215 plays)
• System of a Down - Sugar (1,149 plays)
• System of a Down - Chop Suey (1,116 plays)
• System of a Down - Prison Song (1,102 plays)
Quick Reference
All requests use GET with these base params:
?api_key=$LASTFM_API_KEY&format=json&user=$LASTFM_USER
User Endpoints
Recent Tracks (what's playing / recently played)
curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&limit=10"
