Spotify Play Count MCP: Plays & Monthly Listeners

io.github.GeminiGeorge22由 GitHub 账号 GeminiGeorge22 发布v1.0.1更新于 Nov 4, 2026

查看任意曲目、专辑、艺人或歌单的Spotify播放次数，以及月度听众和关注者数量。

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Spotify play counts for any track, album, artist or playlist, plus monthly listeners and followers.

已验证Streamable HTTP可网页运行

概览

Spotify Play Count MCP: Plays & Monthly Listeners 的托管 MCP 服务（mcp.apify.com）；需要 OAuth 登录或 API 密钥；Streamable HTTP；1 个工具。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

端点
mcp.apify.com
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spotify Play Count MCP: Plays & Monthly Listeners，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.GeminiGeorge22%2Fspotify-play-count-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

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

README

Spotify Play Count MCP: Plays & Monthly Listeners

An MCP server that gives your AI assistant Spotify play counts. Paste a track, album, artist or playlist link (or a spotify: URI) and it returns every track's play count, and for artists their monthly listeners, followers, world rank and top cities. Optionally it adds streams over the last 1, 7 and 30 days for tracks in daily tracking. No Spotify login and no proxy setup.

Built on the public Spotify web pages, via the Apify Actor Spotify Play Count & Monthly Listeners Scraper. Not affiliated with Spotify.

Example prompts

  • "How many plays does each track on this album have? https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy"
  • "Compare monthly listeners and followers for these three artists."
  • "Which tracks on this playlist have the most plays?"
  • "Track my artist page weekly and show streams per day for every song."

Tool

ToolInputOutput
publicrecords--spotify-play-count-scraperurls (track, album, artist or playlist links or URIs), addDailyStreams, includeArtistAlbums, maxTracksPerTargetOne row per track (track, artists, album, play count, release date, links) and one per artist (monthly listeners, followers, world rank, top cities)

About the daily stream fields (streamsLast1d, streamsLast7d, streamsLast30d, with addDailyStreams on): a track seen for the first time gets empty values on that day. The fields fill in after the first day of history, so a run a day later shows the last day and a week later the last 7 days.

The full input schema is in tools.json, generated from the Actor's public input schema and checked for drift daily.

MCP endpoint

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

Transport: Streamable HTTP (hosted by Apify, see https://docs.apify.com/mcp).

Auth

Sign in with Apify OAuth when your client prompts you, or send the header Authorization: Bearer <APIFY_TOKEN> where <APIFY_TOKEN> is your own Apify API token. Never commit a real token.

Client setup

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, and paste the MCP endpoint URL above.

Cursor

~/.cursor/mcp.json:

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

VS Code

.vscode/mcp.json:

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

To use a token instead of OAuth, add "headers": { "Authorization": "Bearer <APIFY_TOKEN>" } next to "url".

Disclosure: I maintain this Actor.

Local stdio server (open source)

This repo also ships a small MCP server in src/ for clients that only run local stdio servers. It answers initialize and tools/list locally from tools.json, which is generated from the Actor's public input schema and checked for drift in CI and daily, so any client or directory can inspect the tools with no token. tools/call is forwarded to the hosted Apify MCP endpoint above with your own APIFY_TOKEN; without a token a call returns a clear error instead of running anything. The token is only sent in the Authorization header and is never logged.

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

Or from a clone:

bash
git clone https://github.com/GeminiGeorge22/spotify-play-count-mcp.gitcd spotify-play-count-mcp && npm installAPIFY_TOKEN=YOUR_APIFY_TOKEN node src/server.js

Optional env: APIFY_ACTORS (comma-separated subset of the Actors above) and APIFY_MCP_URL (full endpoint override).

Tests run against an in-memory mock server, with no network and no token: npm test. Requires Node.js 18+.

Python (uvx/pip)

A matching Python version of this server lives in python/, built on the official mcp Python SDK: same tool, same APIFY_TOKEN, same hosted endpoint. Requires Python 3.10+.

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

Or with pip: pip install spotify-play-count-mcp, then run spotify-play-count-mcp. Until the first PyPI release, run it from GitHub: uvx --from "git+https://github.com/GeminiGeorge22/spotify-play-count-mcp#subdirectory=python" spotify-play-count-mcp. Python tests: cd python && pip install -e ".[test]" && env -u APIFY_TOKEN python -m pytest.

See also

来源：README.md，提交 736fe69

工具

1

publicrecords--spotify-play-count-scraper

Spotify Play Count & Monthly Listeners Scraper

Spotify Play Count & Monthly Listeners Scraper. Play counts for every track of any Spotify album, playlist or artist, plus monthly listeners and followers for artists. Optional streams per day for tracked tracks. No login. When to use: Use when you need Spotify play counts: the total plays of every track behind a track, album, artist or playlist link, plus an artist's monthly listeners, followers, world rank and top cities. Optional streams over the last 1, 7 and 30 days for tracks already in daily tracking; those fields stay empty for a track's first day and fill in once it has history. Good for release tracking, playlist checks and artist comparisons; not for private Spotify for Artists data or royalties. Returns: the run's dataset rows as structured JSON (one row per result), plus the run and dataset IDs for paging the full dataset. Behavior: starts one run of the Apify Actor "publicrecords/spotify-play-count-scraper" through Apify's hosted MCP gateway (mcp.apify.com) with your own APIFY_TOKEN; the run uses your Apify account. Read-only: it only reads public web data and changes nothing on the source site. Docs: https://apify.com/publicrecords/spotify-play-count-scraper

输入参数urls必填addDailyStreamsmaxTracksPerTargetincludeArtistAlbums

版本历史

1
  1. v1.0.1最新Nov 4, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分