lastfm

What This Skill Does

The Last.fm skill for OpenClaw provides a powerful interface for interacting with your personal music listening history. It acts as an bridge between your terminal agent and the Last.fm API, allowing you to fetch detailed insights about your auditory patterns, such as your current 'Now Playing' status, long-term top charts for artists, albums, and tracks, as well as your recent listening history. Furthermore, the skill supports administrative actions like 'loving' or 'unloving' specific tracks directly from your command line, provided the necessary authentication tokens are supplied.

Installation

To integrate this skill, use the ClawHub manager. Run the following command in your terminal: clawhub install openclaw/skills/skills/dennisooki/lastfm-openclaw

Once installed, ensure your shell environment is configured with the following variables for full functionality:

• LASTFM_API_KEY: Your unique key from Last.fm API settings.
• LASTFM_USERNAME: Your Last.fm username.
• LASTFM_SESSION_KEY & LASTFM_API_SECRET: (Optional) Required only if you intend to use write commands like 'love' or 'unlove'.

Use Cases

This skill is perfect for music enthusiasts and data-driven users who want to monitor their listening habits without opening a browser. Use it to generate reports for end-of-year summaries, quickly check if a specific track you heard is in your library, or maintain your 'loved' track list while you focus on other workflows. It is also an excellent tool for developers or power users who want to pipe music metadata into other logging scripts.

Example Prompts

1. "Lastfm, what am I listening to right now?"
2. "Show me my top tracks from the last 6 months."
3. "Love this track: Radiohead, Creep."

Tips & Limitations

• Time periods are case-sensitive and must be one of: 7day, 1month, 3month, 6month, 12month, or overall.
• Write operations (love/unlove) are restricted by Last.fm's API security requirements, so ensure your Session Key is refreshed if you experience auth errors.
• The 'recent' command defaults to 10 tracks, but you can pass an integer argument to retrieve more or less data depending on your needs. Always ensure your network has access to ws.audioscrobbler.com.