Media & StreamingDocumentedScanned
lastfm
Access Last.fm listening history, music stats.
Share:
Installation
npx clawhub@latest install lastfmView 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