← 返回目录

Spotifyscraper

社区

无需API密钥，为LLM代理提供公共Spotify元数据、歌词和播客。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 64 / 230
Stars: ★ 316 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 3 个月前

61FMRS · C

SpotifyScraper为AI代理提供了一个有价值的无需API密钥的Spotify数据访问方式，但它依赖于非官方端点，存在破坏风险，适合非关键的只读用例。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

14/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: manifest 格式规范，名称、包标识 spotifyscraper 3.9.2、stdio 传输和可选环境变量 SPOTIFY_SP_DC 互相一致；README 描述的同步/异步库与 mcp extra 结构自洽，正常路径可行。但材料中未提供服务器源码、工具定义或任何测试文件，无法静态核实工具列表与真实行为一致；README 声称的 CI、每日金丝雀测试和 85% 覆盖率仅是断言，非可执行证据。此外服务器依赖 Spotify 未公开的网页端点，README 自己承认随时可能失效。因此扣分：缺少可验证证据，且端点本身脆弱。
安全与权限 14/20: 设计符合最小权限：只读公共数据、无写/删除/支付等破坏性操作；唯一密钥 SPOTIFY_SP_DC 标记为 isSecret 且可选，文档称仅发送给 Spotify、不写日志；缓存刻意不存储携带令牌的响应；cookie 存于仅属主可读文件或可选系统钥匙串；安装示例中无真实令牌。未发现恶意代码、隐蔽外传或伪造身份等红线问题。扣分点：日志脱敏、cookie 传输与存储的实际实现无法从所提供源码中确认，只能依据文档声明；无独立的漏洞披露/安全响应说明。
维护活跃度 14/20: 项目维护迹象充分：MIT 许可证、明确的作者归属、版本迭代到 3.9.2 并有按版本列出的已发布路线图；README 描述每日金丝雀测试自动开/关 breakage issue，体现持续维护机制。扣分点：材料中没有 SECURITY.md 之类的安全响应渠道，未提供 CHANGELOG 或发布记录原文；CI、测试覆盖率、SHA 固定 Actions 等均为 README 声明而无实际 workflow/测试文件佐证；8 个未关闭 issue 的响应质量无法评估。
文档质量 13/20: README 分层且内容充实：安装 extras、同步/异步快速入门、CLI、批量助手、缓存、搜索、歌词、播客字幕、本地化、浏览器登录、法律声明，并链接完整文档站，覆盖了大部分使用面。扣分点：MCP 专门文档薄弱——没有客户端接入配置示例（如 Claude Desktop 的 JSON 配置）、没有 MCP 工具清单与参数说明、没有 MCP 故障排查或明确限制；SPOTIFY_SP_DC 的获取与失效场景说明不足；限额/成本虽因无官方配额而基本不适用，但未明确说明反爬限速等实际限制。
安装易用性 12/20: 安装路径清晰：Python 3.10+ 上 pip install spotifyscraper[mcp] 即可，另有 ghcr.io 容器镜像和可选环境变量，manifest 与 PyPI 包名/版本一致，步骤少。扣分点：README 未给出将 stdio 服务器接入主流 LLM 客户端的配置示例，用户需要自行推断注册方式；静态校准要求有真实 CI 工作流与覆盖服务器关键路径的测试文件才能给到 15 分以上，而所提供材料仅有 README 声明，无执行证据，因此低于上限；客户端兼容性与真实启动行为未经核实。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

开发人员需要快速、无需密钥访问公共Spotify元数据。
希望为代理提供Spotify数据的LLM应用。
需要音频内容元数据的个人项目。
希望为AI应用添加音乐搜索功能的研究人员。

不适合谁

需要写入用户Spotify账户或访问私人/库数据的应用。
需要市场准确的可用性或区域特定数据的情况。
生产级应用可能因Spotify改变端点而有破坏风险。

所需权限

默认情况下，无需认证。
可选地，需要SPOTIFY_SP_DC cookie以启用歌词、转录和账户工具。此cookie是秘密的。

风险与副作用

这依赖于Spotify的公共私有端点，可能会在没有通知的情况下更改，导致破坏。
存在Spotify封禁的风险，但库中包括反封禁措施。
该工具不是官方的，可能违反Spotify的服务条款；用于教育或个人用途。

安装接入

准备工作

运行环境：Python 3.10+ · Docker

SPOTIFY_SP_DC 可选密钥可选的 Spotify 登录 Cookie（sp_dc），用于解锁歌词、播客文稿、账户信息等认证工具；从已登录浏览器 Spotify 的 Cookie 中获取。

安装Python包：pip install 'spotifyscraper[mcp]'。然后配置MCP客户端以运行spotifyscraper-mcp。可选地，设置环境变量SPOTIFY_SP_DC以启用认证工具。

验证是否装好

在客户端工具列表中看到 spotifyscraper 的 MCP 工具（如 get_track / get_track_visuals），并请求一首曲目返回其名称与艺术家即证明连接成功。

常见排障

确保Python版本≥3.10。
检查SPOTIFY_SP_DC cookie是否有效且未过期。
验证网络连接和Spotify的可访问性。
重新安装包以获取最新版本。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

获取曲目 4uLU6hMCjMI75M1A2tKUQC 的名称、艺术家和时长
搜索 daft punk，返回前 5 个 track 和 artist 结果
列出专辑 6N9PS4QXF1D0OWPk0Sxtb4 的曲目
用 get_track_visuals 拿到这首曲子的封面配色和预览

使用场景

获取公开的Spotify曲目、专辑、艺术家、播放列表和播客数据，无需API密钥。

在AI应用中检索歌词和播客转录。

为研究构建Spotify元数据搜索。

下载封面和预览片段。

详细介绍

SpotifyScraper是一个MCP服务器，它从Spotify的公开网页数据中提取曲目、专辑、艺术家、播放列表、播客和歌词。它不需要官方API或API密钥，通过引导匿名令牌并访问网络播放器使用的JSON端点来实现。它支持同步和异步Python客户端，提供类型化、不可变的模型，并包含一个MCP服务器，使AI代理（如Claude）能够轻松访问Spotify数据。可选地，使用你的Spotify sp_dc cookie（密码或API密钥不需要）启用歌词和播客转录。