用途:针对指定艺人/同类群体、流派或主题、发行时间窗口以及专辑/单曲/客串范围,对比公开目录发行,构建发行队列或目录定位视图。
主要能力:搜索并核实艺人 ID/URI、署名、资料页与所选发行;按类型(album、single、compilation、appears_on、all)与排序获取艺人作品目录,支持有界的 offset/limit;解析所选专辑与曲目列表,保留标题、署名艺人、发行类型、日期及精度、厂牌/标识、曲序、时长单位、版本线索与来源;在具备录音/版本证据时对重复或变体发行分组。
使用方式:设置 CRAWLORA_API_KEY;已连接时优先使用 Crawlora MCP 工具,否则使用 scripts/crawlora.sh,其向 https://api.crawlora.net/api/v1 发送 x-api-key。示例:scripts/crawlora.sh /spotify/artists/search q="jazz trio" limit=5;scripts/crawlora.sh /spotify/albums/search q="jazz trio" limit=5;获取目录前先使用已核实的艺人 ID:scripts/crawlora.sh /spotify/artist/albums id="$ARTIST_ID" type=all order=date_desc limit=20 offset=0。参数与方法详见 reference/endpoints.md。
限制:艺人、专辑、曲目与资料页 ID/URI 属于不同命名空间;名称相似、相关艺人建议或同歌单位置不构成合作、厂牌归属或创作影响。客串与合辑署名不算艺人本人的主要发行;精选概览目录不等于完整档案。仅凭标题相同不足以合并版本,需录音标识或署名/时长/发行佐证。仅年份或月份的日期精度须保留,不得臆造确切日期或顺序。时长不等于收听时长或流媒体收入。公开热度、播放/听众字段、推荐或榜单的范围与日期可能不同,仅按所给字段并注明来源报告,不得累加重复录音指标、由单一快照推断历史势头,或将排名视为经审计的流量/收入。这些接口不提供版税、销量、听众或市场可用性的完整时间序列,也不保证提供转录、歌词或完整音频分析。应返回身份/分组与日期/覆盖台账、目录矩阵、有来源的定位假设与未知项。不得复制受版权保护的歌曲、下载受限音频、联系艺人,或据此任务更改播放列表/账户。认证错误应停止,429 应退避,瞬时上游故障可重试一次,并按请求范围与额度预算限制调用/分页。