Media & StreamingDocumentedScanned

lastfm

Access Last.fm listening history, music stats.

Share:

Installation

npx clawhub@latest install lastfm

View the full skill documentation and source below.

Documentation

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: **Docs**: ## Example Output Here's what 17+ years of scrobbling looks like: __CODE_BLOCK_0__ ## Quick Reference All requests use GET with these base params: __CODE_BLOCK_1__ ### User Endpoints #### Recent Tracks (what's playing / recently played) __CODE_BLOCK_2__ - First track with @attr.nowplaying=true is currently playing - Returns: artist, track name, album, timestamp, images #### User Info (profile stats) __CODE_BLOCK_3__ - Returns: playcount, artist_count, track_count, album_count, registered date #### Top Artists __CODE_BLOCK_4__ - period: overall | 7day | 1month | 3month | 6month | 12month #### Top Albums __CODE_BLOCK_5__ #### Top Tracks __CODE_BLOCK_6__ #### Loved Tracks __CODE_BLOCK_7__ #### Weekly Charts __CODE_BLOCK_8__ ### Artist/Track/Album Info #### Artist Info __CODE_BLOCK_9__ - Adding username includes user's playcount for that artist #### Similar Artists __CODE_BLOCK_10__ #### Artist Top Tracks __CODE_BLOCK_11__ #### Track Info __CODE_BLOCK_12__ #### Similar Tracks __CODE_BLOCK_13__ #### Album Info __CODE_BLOCK_14__ ### Search #### Search Artists __CODE_BLOCK_15__ #### Search Tracks __CODE_BLOCK_16__ #### Search Albums __CODE_BLOCK_17__ ### Charts (Global) __CODE_BLOCK_18__ ### Tags __CODE_BLOCK_19__ ## Useful jq Filters For JSON processing, see the [jq skill on ClawdHub](). __CODE_BLOCK_20__ ## Notes - No auth needed for read-only endpoints (just API key) - Rate limit: be reasonable, no hard limit documented - URL-encode artist/track/album names (spaces → + or %20`)
  • Images come in sizes: small, medium, large, extralarge