Spotify Play Count MCP: Plays & Monthly Listeners

Spotify Play Count 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」
• 「この 3 人のアーティストの月間リスナー数とフォロワー数を比較してください。」
• 「このプレイリストで最も再生回数が多いトラックはどれですか？」
• 「アーティストのページを毎週追跡して、各楽曲の 1 日あたりの再生数を表示してください。」

ツール

ツール	入力	出力
publicrecords--spotify-play-count-scraper	urls（トラック、アルバム、アーティスト、プレイリストのリンクまたは URI）、addDailyStreams、includeArtistAlbums、maxTracksPerTarget	トラックごとに 1 行（トラック、アーティスト、アルバム、再生回数、リリース日、リンク）、アーティストごとに 1 行（月間リスナー数、フォロワー数、世界ランキング、人気の都市）

日次再生数のフィールド（streamsLast1d、streamsLast7d、streamsLast30d。addDailyStreams が有効な場合）について：初めて確認されたトラックは、その日の値が空になります。これらのフィールドは履歴が 1 日分蓄積されると値が入り、1 日後に実行すると過去 1 日分、1 週間後に実行すると過去 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：設定 → コネクター → カスタムコネクターを追加し、上記の 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 サーバー（オープンソース）

このリポジトリには、ローカルの stdio サーバーのみを実行するクライアント向けに、小規模な MCP サーバーも src/ に同梱されています。Actor の公開入力スキーマから生成され、CI と毎日のチェックでドリフトがないか確認される tools.json を使って、initialize と tools/list にローカルで応答します。そのため、トークンがなくても、どのクライアントやディレクトリからでもツールを確認できます。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の検索結果とショップの売上を取得します。
• ecommerce-sales-mcp：Amazonのベストセラーとレビュー、eBayの落札価格、TikTok ShopとEtsyのショップ売上など、Eコマースの売上に関するシグナルを取得します。
• sports-odds-mcp：Kambiのスポーツブックからスポーツのオッズを取得します。