Last.fm音乐数据API文档

基于Last.fm官方API的纯文档型技能，提供音乐数据查询接口说明，帮助用户获取艺术家、专辑、曲目及听歌统计信息。

基本信息

• 技能名称?last-fm
• 中文名称?Last.fm音乐数据API文档
• 作者?keyfrog-21K
• 分类?效率
• 版本?v1.0.0
• 标签?api, content-media, data-analytics, docs

使用方法

使用说明
核心用法
OpenClaw-Last.fm 是一个纯文档型的 API 接口说明技能，旨在帮助用户通过 Last.fm 官方 API 获取音乐相关数据。该技能本身不包含任何可执行代码，仅提供完整的 API 调用文档和示例。用户需要自行申请 Last.fm API Key，然后通过标准的 HTTP GET/POST 请求访问 https://ws.audioscrobbler.com/2.0// 端点。
技能涵盖了 Last.fm API 的六大核心资源类型：Artist（艺术家信息、热门曲目、热门专辑、搜索）、Album（专辑元数据、标签、搜索）、Track（曲目详情、标签、搜索）、User（用户信息、最近播放、个人排行榜）、Library（用户音乐库查询）以及 Chart（全球排行榜）。此外还支持 Tag（标签）相关的数据查询，包括标签描述、关联艺术家、曲目和专辑等。
显著优点

1. 纯文档零风险 ：该技能仅包含 Markdown 文档，无任何可执行代码，从根本上杜绝了代码注入、恶意执行等安全风险。
2. 接口覆盖全面 ：涵盖了 Last.fm API 最常用的 20+ 个方法，从基础的音乐元数据查询到用户个性化数据统计，满足多样化的音乐数据需求。
3. 示例清晰实用 ：每个 API 方法都配有完整的 HTTP 请求示例，包含所有必需参数，用户可直接复制修改使用。
4. 依托成熟平台 ：Last.fm 是全球运营超过 20 年的知名音乐社交平台，拥有庞大的音乐数据库和用户群体，数据权威性和稳定性有保障。
5. 灵活的数据格式 ：支持 JSON 和 XML 两种返回格式，方便不同场景下的数据解析需求。
   潜在缺点或局限性
6. 需要自行申请 API Key ：用户必须前往 Last.fm 官网注册并申请 API Key，增加了使用门槛。
7. 无代码封装 ：该技能仅提供文档，不包含任何 SDK 或封装代码，用户需要自行处理 HTTP 请求、错误处理和响应解析。
8. 依赖外部服务稳定性 ：所有数据查询都依赖 Last.fm 官方 API，若 Last.fm 服务出现故障或调整接口，该技能无法提供替代方案。
9. 隐私数据公开性 ：Last.fm 的用户名和听歌历史默认是公开的，用户可能无意中暴露个人音乐偏好。
10. 无实时数据保障 ：Last.fm 的数据更新存在延迟，"正在播放"状态和最热榜单并非严格实时。
    适合的目标群体
    音乐数据分析师 ：需要获取大规模音乐元数据或用户行为数据进行研究分析
    音乐推荐系统开发者 ：需要基于 Last.fm 的标签体系和相似艺术家数据构建推荐算法
    个人音乐爱好者 ：希望追踪自己的听歌历史、生成个人音乐年报或发现新音乐
    音乐类应用开发者 ：需要集成权威的音乐数据库查询功能
    数据 journalists 和内容创作者 ：需要获取音乐趋势数据制作内容
    使用风险
11. API 限流风险 ：Last.fm 对免费 API Key 有请求频率限制，高频调用可能导致临时封禁。
12. 数据隐私风险 ：用户通过 API 查询自己的数据时，用户名和听歌记录可能被第三方获取（若账号为公开状态）。
13. API Key 泄露风险 ：用户需妥善保管自己的 API Key，若泄露可能被他人滥用导致配额耗尽。
14. 服务变更风险 ：Last.fm 可能调整 API 接口或政策，导致部分功能失效。
15. 网络依赖风险 ：该技能完全依赖外部网络服务，离线环境无法使用。