Spotify Play Count MCP: Plays & Monthly Listeners

Spotify 播放次数 MCP：播放量与月听众

一个可为 AI 助手提供 Spotify 播放次数的 MCP 服务。粘贴曲目、专辑、艺人或播放列表链接（或 spotify: URI），即可获取每首曲目的播放次数；对于艺人，还可获取其月听众数、关注者数、全球排名和热门城市。对于启用了每日追踪的曲目，还可选获取过去 1、7 和 30 天的播放量。无需登录 Spotify，也无需设置代理。

基于 Spotify 公开网页，通过 Apify Actor Spotify Play Count & Monthly Listeners Scraper 构建。与 Spotify 无关联。

• Apify Store：https://apify.com/publicrecords/spotify-play-count-scraper
• MCP 服务：https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper

示例提示词

• “这张专辑中的每首曲目有多少播放量？https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy”
• “比较这三位艺人的月听众数和关注者数。”
• “这个播放列表中哪些曲目的播放量最高？”
• “每周追踪我的艺人页面，并显示每首歌的每日播放量。”

工具

工具	输入	输出
publicrecords--spotify-play-count-scraper	urls（曲目、专辑、艺人或播放列表链接或 URI）、addDailyStreams、includeArtistAlbums、maxTracksPerTarget	每首曲目一行（曲目、艺人、专辑、播放次数、发行日期、链接），每位艺人一行（月听众数、关注者数、全球排名、热门城市）

关于每日播放量字段（启用 addDailyStreams 时的 streamsLast1d、streamsLast7d、streamsLast30d）：首次发现的曲目当天这些字段为空。积累一天历史记录后字段才会填入，因此一天后再次运行会显示过去一天的数据，一周后运行则会显示过去 7 天的数据。

完整输入架构见 tools.json，该文件根据 Actor 的公开输入架构生成，并每日检查是否存在偏差。

MCP 端点

https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper

传输方式：Streamable HTTP（由 Apify 托管，参见 https://docs.apify.com/mcp）。

身份验证

客户端提示时，请使用 Apify OAuth 登录；也可以发送标头 Authorization: Bearer <APIFY_TOKEN>，其中 <APIFY_TOKEN> 是你自己的 Apify API 令牌。 切勿提交真实令牌。

客户端设置

Claude

Claude Code：

claude mcp add --transport http spotify-play-count "https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper"

Claude Desktop / claude.ai：前往 Settings → Connectors → Add custom connector，然后粘贴上方的 MCP 端点 URL。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "spotify-play-count": {
      "url": "https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper"
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "spotify-play-count": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper"
    }
  }
}

若要使用令牌而不是 OAuth，请在 "url" 旁添加 "headers": { "Authorization": "Bearer <APIFY_TOKEN>" }。

---

声明：我维护此 Actor。

本地 stdio 服务（开源）

此仓库还在 src/ 中提供了一个小型 MCP 服务，供仅运行本地 stdio 服务的客户端使用。它会从 tools.json 在本地响应 initialize 和 tools/list；该文件根据 Actor 的公开输入架构生成，并在 CI 和每日检查是否存在偏差，因此任何客户端或目录都无需令牌即可查看这些工具。tools/call 会通过你自己的 APIFY_TOKEN 转发到上方托管的 Apify MCP 端点；如果没有令牌，调用会返回明确的错误，而不会执行任何操作。令牌只会通过 Authorization 标头发送，绝不会记录到日志中。

npx -y github:GeminiGeorge22/spotify-play-count-mcp

{
  "mcpServers": {
    "spotify-play-count": {
      "command": "npx",
      "args": ["-y", "github:GeminiGeorge22/spotify-play-count-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

或者从克隆的仓库运行：

git clone https://github.com/GeminiGeorge22/spotify-play-count-mcp.git
cd spotify-play-count-mcp && npm install
APIFY_TOKEN=YOUR_APIFY_TOKEN node src/server.js

可选环境变量：APIFY_ACTORS（以上 Actor 的逗号分隔子集）和 APIFY_MCP_URL（完整端点覆盖值）。

测试通过内存中的模拟服务运行，无需网络和令牌：npm test。需要 Node.js 18+。

Python（uvx/pip）

此服务的对应 Python 版本位于 python/，基于官方 mcp Python SDK 构建：工具相同、APIFY_TOKEN 相同、托管端点相同。需要 Python 3.10+。

uvx spotify-play-count-mcp

{
  "mcpServers": {
    "spotify-play-count": {
      "command": "uvx",
      "args": ["spotify-play-count-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

也可以使用 pip：运行 pip install spotify-play-count-mcp，然后运行 spotify-play-count-mcp。在 PyPI 首次发布前，请从 GitHub 运行：uvx --from "git+https://github.com/GeminiGeorge22/spotify-play-count-mcp#subdirectory=python" spotify-play-count-mcp。Python 测试：cd python && pip install -e ".[test]" && env -u APIFY_TOKEN python -m pytest。

另请参阅

• google-ads-transparency-mcp：来自 Ads Transparency Center 的竞争对手 Google 广告：新投放、投放中和已停止。
• etsy-sales-mcp：Etsy 搜索结果和 Etsy 店铺销量。
• ecommerce-sales-mcp：电商销售趋势：Amazon 畅销商品和评论、eBay 已售价格、TikTok Shop 和 Etsy 店铺销量。
• sports-odds-mcp：来自 Kambi 体育博彩平台的赔率。