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 分