SuperAPI AI 工具集

music-podcast-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:该技能用于研究音乐、艺人、歌单与播客,通过 Crawlora API 获取 Spotify、Spotify Podcasts、Apple Podcasts、Discogs、SoundCloud 的公开数据,返回规范化 JSON,无需抓取流媒体应用页面。

主要能力:Spotify 支持搜索(/spotify/search 及曲目、艺人、专辑、歌单、用户资料的分类搜索)与详情(/spotify/track、/spotify/album、/spotify/artist、/spotify/playlist、/spotify/profile,接受 id 或 uri),并提供 /spotify/artist/related、/spotify/track/recommended、/spotify/track/similar-albums 用于发现。Spotify Podcasts 提供搜索、节目详情、节目单集与榜单。Apple Podcasts 提供搜索、节目详情、单集与按国家/地区的榜单排名。Discogs 提供搜索(可指定 release/master/artist/label)及发行、母版、艺人、厂牌详情与目录子路径。SoundCloud 提供搜索、曲目详情(含播放/点赞/评论/转发数)、用户资料、用户上传列表与歌单。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,请求发往 https://api.crawlora.net/api/v1。所有请求通过 scripts/crawlora.sh 发起,以避免密钥出现在命令行参数中,例如:scripts/crawlora.sh /spotify/search q="Daft Punk" | jq '.';scripts/crawlora.sh /apple-podcasts/search term="Reply All" | jq '.';scripts/crawlora.sh /discogs/search q="Random Access Memories" type=release | jq '.';scripts/crawlora.sh /soundcloud/track url="https://soundcloud.com/artist/track-name" | jq '.'。完整端点列表见 reference/endpoints.md。

适用场景:艺人深度调研(作品目录与相似艺人)、播客发现(榜单与往期单集)、唱片收藏研究(版本、年份、厂牌等压制信息)、SoundCloud 艺人目录与互动数据查询。

限制:仅限公开数据;按成功计费,仅 2xx 计费,免费额度每月 2000 积分;密钥缺失或无效返回 401,且只能存于 CRAWLORA_API_KEY,不得硬编码、放入查询参数或提交到仓库;Spotify 详情端点需要 id 或 uri,只有名称时须先经对应搜索端点解析;SoundCloud 详情端点需要完整 url(如 permalink_url),无数字 id 查询,只有名称时须先从搜索结果取 URL;搜索端点分页(limit/offset 或 page),需翻页以获取完整结果。