Last.fm音乐数据查询

技能简介

连接Last.fm API，查询个人或全局音乐收听数据，包括近期播放、热门艺人/专辑/曲目、收藏歌曲及相似推荐。

能做什么

• 查看最近播放记录和当前正在听的歌曲
• 获取个人累计播放次数、艺人数量、曲目数量等统计
• 查询指定时间段内的热门艺人、专辑、曲目排行
• 列出标记为喜爱的歌曲
• 查找相似艺人或相似曲目
• 检索全球热门榜单

使用说明

安装配置

1. 前往 Last.fm API页面 申请API Key
2. 在环境变量中添加：LASTFM_API_KEY（你的API密钥）和 LASTFM_USER（Last.fm用户名）
3. 可选：将变量写入 ~/.clawdbot/.env 文件

基础调用格式

?api_key=$LASTFM_API_KEY&format=json&user=$LASTFM_USER

常用示例

获取最近10条播放记录：

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&limit=10"

获取近7天热门艺人：

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&period=7day&limit=10"

period参数可选值：overall（全部）、7day、1month、3month、6month、12month

输入与输出

见下方输入与输出表格。

风险提示

• API Key需妥善保管，避免泄露导致配额被滥用
• 免费API有请求频率限制，频繁调用可能触发限流
• 用户数据依赖Last.fm平台的持续运营
• 部分历史数据可能存在缺失或延迟同步

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gumadeiras/lastfm/SKILL.md
来源类型：开源技能仓库