mcpField
S
SoundCloud MCP Server and API by Cotlet

SoundCloud MCP Server and API by Cotlet

远程服务
cotlet.dev社交媒体03 天前更新

关于 SoundCloud MCP Server and API by Cotlet

SoundCloud MCP 服务和 API 让 AI 助手及脚本通过本地 SoundCloud 登录会话读取数据和更新曲目,适合音乐人、厂牌及开发者。它支持 MCP、REST API 和 Python 调用,无需 SoundCloud API 凭据。

主要功能

  1. 01查看资料和曲目
  2. 02读取播放量与点赞数
  3. 03查看评论和私信
  4. 04更新曲目标题、标签和描述
  5. 05提供 REST API 与 Python 调用

适用场景

  1. 01汇总一段时间内的播放和点赞数据
  2. 02筛选需要回复的评论或私信
  3. 03更新曲目标题、标签及描述
  4. 04通过脚本读取 SoundCloud 数据

MCP 相关

提供通过 stdio 或 HTTP 连接的 MCP 服务,并以工具描述和输入架构列出功能。九个只读工具标记为只读,更新曲目的工具标记为写入。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://cotlet.dev/mcp/v1/soundcloud/connect
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://cotlet.dev/mcp/v1/soundcloud/connect
Streamable HTTPhttps://cotlet.dev/mcp/v1/soundcloud需要授权

工具

详细介绍

SoundCloud API 和 MCP 服务:将 SoundCloud 接入 ChatGPT 和 Claude

没错,ChatGPT、Claude 和其他 AI Agent 都可以操作你的 SoundCloud 账号。 其中包括 Cursor、Codex、OpenClaw 和任何 MCP 客户端,以及 n8n、Make 和 Zapier 中的自动化流程。用日常语言提出要求,AI 就能编辑你的曲目标题、标签和描述,读取评论和消息,并汇报播放量和听众数据。它会先向你展示将要执行的操作,未经你同意,不会向其他人发送任何内容。

截至 2026 年 11 月,这个仓库补上了缺失的一环:为 AI 助手和脚本提供 10 个 SoundCloud 工具。

你可以这样提问

告诉我过去 7 天的播放量、点赞、评论和转发次数,以及播放量最高的 5 首曲目。

显示我所有曲目下最新的评论,并为每位真实粉丝拟一条简短回复。我会自己发布。

我有未读消息吗?用一句话概述每个对话,并告诉我哪些需要回复。

我之前联系过 soundcloud.com/harbor-lights 吗?如果没有,告诉我对方的关注者数量和个人简介。

我的哪些曲目没有流派或标签?两者都给出建议,并在我同意后设置。

两种获取方式

在 Cotlet 上立即使用自行运行,即使用本仓库
适用对象艺术家、唱片公司和经理人开发者
设置只需登录 SoundCloud 一次,大约 5 分钟,无需安装任何东西Python 和终端
适用平台ChatGPT 和 Claude 应用,也可在手机上使用;Cursor、Codex、OpenClaw、任何 MCP 客户端、n8n、Make、Zapier、REST API电脑上的 Claude Code、Claude Desktop、Cursor、Codex
运行方式全天候运行,即使你的电脑关机也不受影响电脑开机时运行
价格免费试用 7 天,无需银行卡免费

Cotlet 最适合希望 ChatGPT、Claude 或其他 AI Agent 代为操作 SoundCloud,且不想安装任何东西的艺术家、唱片公司和经理人。

在 cotlet.dev 免费开始 →

自行运行

一个由你在自己的电脑上运行的 SoundCloud API 和 SoundCloud MCP 服务,使用 Python,并基于你自己的 Google Chrome 会话。包含我们在 Cotlet 生产环境中运行的全部 10 个 SoundCloud 工具:你的个人资料和任何可通过链接访问的个人资料、你的曲目(包括私密曲目及其秘密链接)、曲目编辑、指定时间范围内的评论、播放量和点赞,以及你的私信。

SoundCloud 确实提供官方 API,但你需要订阅 Artist Pro 才能注册应用并获取凭据,而且其指南中没有按时间段查询数据分析的功能,也不支持私信。这个仓库两者都不需要。它可以在免费账号上运行,并提供:

  • 面向 Claude Code、Claude Desktop、Cursor、Codex 和任何 MCP 客户端的 MCP 服务,支持通过 stdio 或 HTTP 通信。设置
  • 运行于 http://127.0.0.1:8787/api/v1/soundcloud 的 REST API,OpenAPI 文档位于 /docs。设置
  • Python:call("get_insights", window="DAYS_7"),以及 examples/ 中的 7 个现成脚本。

个人使用免费,也包括你自己的业务(许可证)。

SoundCloud MCP 服务 Python 3.11+ 许可证:Elastic 2.0

git clone https://github.com/cotletdev/soundcloud-api-mcp-server.git && cd soundcloud-api-mcp-server
python3 -m venv .venv && . .venv/bin/activate && pip install -e .
soundcloud-mcp connect                             # reads your SoundCloud session from Chrome
soundcloud-mcp call get_insights window=DAYS_7
claude mcp add soundcloud -- "$PWD/.venv/bin/soundcloud-mcp" mcp

目录

SoundCloud 用户常见问题

SoundCloud 有 API 吗? 有,但注册应用并获取凭据需要 Artist Pro 订阅(截至 2026 年 10 月 30 日已核实)。该 API 可上传曲目、编辑曲目详情、创建播放列表和发表评论。其指南未列出某一时段的统计数据,也未列出私信功能。本仓库和 Cotlet 为你提供 10 个 SoundCloud 工具,可作为 REST API 和 MCP 服务使用。

我能获取 SoundCloud API 密钥吗? SoundCloud 仅向 Artist Pro 用户提供应用凭据。使用 Cotlet,你可以获取自己的 API 密钥,并将其与自己的 SoundCloud 账户搭配使用,适用于脚本、n8n、Make、Zapier 或任何 HTTP 客户端。本仓库无需密钥:它运行在你的电脑上,使用你自己的 SoundCloud 会话。

SoundCloud 有官方的 ChatGPT 集成吗? 没有。SoundCloud 没有官方的 ChatGPT 或 Claude 连接器。Cotlet 是一个非官方连接器,现在即可使用,支持 ChatGPT 和 Claude 应用,以及任何支持 MCP 服务的 AI Agent。

如何将 SoundCloud 连接到 ChatGPT? 在 cotlet.dev 注册,在那里的 Cloud Browser 中登录一次 SoundCloud,然后按照账户中的步骤将 Cotlet 添加到 ChatGPT。之后,你就可以像向助手提问一样询问 ChatGPT 有关 SoundCloud 的问题。ChatGPT 需要一个位于互联网的服务,因此仅在你的电脑上运行本仓库无法连接到 ChatGPT。

ChatGPT 能管理我的 SoundCloud 曲目吗? 可以,使用 Cotlet 即可。它会在你确认后编辑曲目的标题、标签和描述,并读取评论和消息,让你知道该回复谁。

AI 能读取我的 SoundCloud 统计数据吗? 可以,使用 Cotlet 即可:按时段、按曲目查看播放量、点赞数和听众数,并以通俗语言呈现。

我能用 Zapier、Make 或 n8n 自动处理 SoundCloud 吗? SoundCloud 自己的 API 需要 Artist Pro 订阅才能注册应用。使用 Cotlet,n8n、Make 和 Zapier 无需订阅即可编辑曲目并读取统计数据。

我能用手机访问吗? 可以,使用 Cotlet 即可:设置完成后,手机上的 ChatGPT 和 Claude 应用就能帮你使用 SoundCloud。

我需要懂技术吗? 使用 Cotlet 不需要:你只需登录 SoundCloud,然后按照账户中的分步说明将 Cotlet 添加到 ChatGPT 或 Claude。本仓库适合熟悉 Python 和终端操作的用户。

我的 SoundCloud 账户安全吗? 安全。Cotlet 和本仓库都不会看到或存储你的 SoundCloud 密码。你像往常一样自行登录,AI 会在该登录会话中操作。任何会影响他人的操作都会先征求你的同意:Cotlet 默认会征求同意;在这里则由你的 MCP 客户端征求同意。

它免费吗? 本仓库免费,也可用于你自己的业务。Cotlet 提供 7 天免费试用,无需信用卡;之后可购买 29 美元起的一次性点数包,无需订阅。价格。

我管理多个账户或客户的 SoundCloud。可以使用吗? 可以,使用 Cotlet 即可。每个 SoundCloud 登录都会建立独立连接。请写信至 [email protected],告诉我们你管理的账户数量。

工作原理

AI agent (MCP) / script (REST, Python) ──▶ soundcloud-mcp on your computer ──your SoundCloud session──▶ api-v2.soundcloud.com
                                                  ▲
                       soundcloud-mcp connect ────┘ reads it once from your Chrome (DevTools Protocol)
  1. 像往常一样,在自己的 Chrome 中登录 soundcloud.com。
  2. soundcloud-mcp connect 通过 Chrome DevTools Protocol 连接到该 Chrome,读取 soundcloud.com 的 Cookie,并将其保存到 ~/.config/soundcloud-api-mcp/session.json,只有你的用户才能读取。它绝不会查看或存储你的密码。
  3. 每次工具调用都会向 SoundCloud 网页应用调用的端点发出请求(api-v2.soundcloud.com 和 graph.soundcloud.com)。oauth_token Cookie 中的令牌会与网页应用公开的 client_id 一起放在 Authorization 标头中;服务端从 SoundCloud 自己的脚本包中读取 client_id,并将其保留一天。请求通过 curl_cffi 发出,它会复制 Chrome 的 TLS 指纹。不会运行第二个浏览器。

要求

  • Python 3.11 或更高版本。
  • Google Chrome 144 或更高版本,并已登录 soundcloud.com。任何 Chrome 或 Chromium 均可通过调试端口使用。
  • macOS、Linux 或 Windows。
  • SoundCloud 账号。免费方案足以使用所有工具。听众所在国家、城市和头部听众数据属于 Artist Pro 页面内容,不包含在这些工具中。

安装

git clone https://github.com/cotletdev/soundcloud-api-mcp-server.git
cd soundcloud-api-mcp-server
python3 -m venv .venv
. .venv/bin/activate              # Windows: .venv\Scripts\activate
pip install -e .
soundcloud-mcp --version

使用 uv:uv venv && uv pip install -e .,然后运行 uv run soundcloud-mcp ...。无需克隆仓库:pip install "git+https://github.com/cotletdev/[email protected]"。

想用 AI Agent(Claude Code、Codex、Cursor)进行设置?在此文件夹中打开它,并让它设置仓库:AGENTS.md 会告知它每个步骤,而它只会在 Chrome 中需要操作时询问你。

更新:git pull && pip install -e .。我们会将托管的 SoundCloud 工具的每项更改都同步到此仓库。

连接 Chrome

选项 A:日常使用的 Chrome(推荐)
  1. 在 Chrome 中打开 chrome://inspect/#remote-debugging,然后开启 remote debugging。之后,Chrome 会接受此计算机上程序发起的 DevTools 连接,并在每次连接前询问你。

  2. 确保已登录 soundcloud.com。

  3. 运行:

    soundcloud-mcp connect
    
  4. Chrome 会询问是否允许连接。点击 Allow。

Saved 55 SoundCloud cookies to /Users/you/.config/soundcloud-api-mcp/session.json
Signed in to SoundCloud as Jordan Ellis (soundcloud.com/jordan-ellis-music)

之后可以再次关闭远程调试。如果你希望 SoundCloud 将你登出后,服务能够自动获取新会话,则保持远程调试开启。

connect 会在 Chrome 的默认配置文件夹中查找 DevToolsActivePort 文件。对于 Chrome Beta、Canary 或自定义配置文件夹,请传入 --profile-dir "<folder>"。

选项 B:使用调试端口的 Chrome

Chrome 不会在默认配置文件上开放调试端口,因此请启动一个独立的 Chrome,在其中登录一次 SoundCloud,然后连接到它:

# macOS
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-soundcloud"
# Linux
google-chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-soundcloud"
# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%USERPROFILE%\.chrome-soundcloud"

soundcloud-mcp connect --cdp http://127.0.0.1:9222

--cdp 也接受 ws:// DevTools URL,例如通过 SSH 隧道连接到另一台计算机上的 Chrome。

选项 C:手动粘贴 Cookie

对于没有 Chrome 的服务端:在 Chrome 中打开 soundcloud.com 的 DevTools,选择 **Application > Cookies > https://soundcloud.com**,复制 oauth_token 的值(格式类似 2-123456-1234567890-AbCdEf...),然后:

soundcloud-mcp connect --token     # paste it, input is hidden
# or, without a session file:
export SOUNDCLOUD_AUTH_TOKEN=...

粘贴的令牌不会自动刷新。SoundCloud 将你登出后,请粘贴新的令牌。

随时检查会话:

soundcloud-mcp status

MCP 服务

MCP 服务会列出每个工具的输入架构、面向 Agent 编写的描述和提示:九个读取工具标记为只读,update_track 标记为写入操作,因此客户端会在运行它之前征求你的同意。

Claude Code
claude mcp add soundcloud -- /path/to/soundcloud-api-mcp-server/.venv/bin/soundcloud-mcp mcp
# read only:
claude mcp add soundcloud -- /path/to/soundcloud-api-mcp-server/.venv/bin/soundcloud-mcp mcp --read-only
Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "soundcloud": {
      "command": "/path/to/soundcloud-api-mcp-server/.venv/bin/soundcloud-mcp",
      "args": ["mcp"]
    }
  }
}
Cursor

~/.cursor/mcp.json,与 Claude Desktop 使用相同的配置块。可直接使用的副本位于 mcp.json。

Codex

~/.codex/config.toml:

[mcp_servers.soundcloud]
command = "/path/to/soundcloud-api-mcp-server/.venv/bin/soundcloud-mcp"
args = ["mcp"]
通过 HTTP

soundcloud-mcp serve 也会通过 http://127.0.0.1:8787/mcp 提供基于流式 HTTP 的 MCP 服务,供需要 URL 的客户端使用:

soundcloud-mcp serve
claude mcp add --transport http soundcloud http://127.0.0.1:8787/mcp

然后可以向你的 Agent 提出这样的问题:

发送我过去 7 天的播放、点赞、评论和转发数据,以及播放量最高的 5 首曲目。

显示我所有曲目下的最新评论,并为每位真正的粉丝拟一条简短回复。我会自己发布。

我有未读消息吗?用一行概述每个对话,并告诉我哪些需要回复。

我以前联系过 soundcloud.com/harbor-lights 吗?如果没有,告诉我对方的粉丝数和个人简介。

我的哪些曲目没有流派或标签?分别给出建议,等我同意后再设置。

REST API

soundcloud-mcp serve               # http://127.0.0.1:8787, MCP at /mcp, docs at /docs

每个工具在 /api/v1/soundcloud 下都有自己的路由,与 cotlet.dev 上托管 API 的路径相同,因此针对其中一个编写的代码也适用于另一个。路径部分和查询字符串作为参数,JSON 请求体则提供其余参数。

curl 'http://127.0.0.1:8787/api/v1/soundcloud/tracks?limit=10'
curl 'http://127.0.0.1:8787/api/v1/soundcloud/insights?window=DAYS_7'
curl -X PATCH http://127.0.0.1:8787/api/v1/soundcloud/tracks/2400000001 \
  -H 'Content-Type: application/json' \
  -d '{"genre": "Ambient", "tags": ["ambient", "field recording"]}'

按名称调用任意工具,并将请求体作为其参数:

curl -X POST http://127.0.0.1:8787/api/v1/soundcloud/tools/resolve_profile -d '{"url": "https://soundcloud.com/harbor-lights"}'
  • GET /api/v1/soundcloud/tools:列出所有工具及其路由、输入架构和示例回答。
  • GET /docs:交互式 OpenAPI 文档;GET /openapi.json:适用于 n8n、Postman 或生成的客户端的架构。
  • 回答均为 JSON。列表会返回 next_cursor;将其作为 cursor 传回即可获取下一页。

服务仅监听 127.0.0.1。若要从你的其他设备访问,请设置令牌;之后每个请求都需要包含 Authorization: Bearer <token>:

SOUNDCLOUD_MCP_TOKEN=$(openssl rand -hex 24) soundcloud-mcp serve --host 0.0.0.0

Python 和示例脚本

直接从 Python 调用,无需启动服务:

from soundcloud_api_mcp import call
from soundcloud_api_mcp.scripting import paginate, write_rows

tracks = list(paginate("list_tracks", {"limit": 50}, "tracks"))
write_rows(tracks, "tracks.csv")
week = call("get_insights", window="DAYS_7")["totals"]
call("update_track", track_id=tracks[0]["track_id"], genre="Ambient")

也可以从命令行调用单个工具:soundcloud-mcp call list_conversations unread_only=true,或传入 JSON 对象。

examples/ 中提供了现成脚本。每个脚本都会输出 JSON,在适用时可使用 --out file.csv 或 --out file.json,并支持 --help。执行写入操作的脚本会先展示将要进行的更改:

脚本功能
weekly_report.py指定时间范围内的播放、点赞、评论、转发和下载数据,并按播放量列出你的热门曲目。--window、--top。
new_comments.py你曲目下的最新评论,包含曲目标题和评论者。--track-id、--since。
unread_messages.py含未读消息的对话及其最近几条消息。--all、--messages。
check_profile.py查询一个或多个个人资料链接:粉丝数、曲目、个人简介,以及你是否联系过对方。
export_tracks.py将你的曲目(包括私密曲目)及其统计数据导出为 CSV 或 JSON。--sharing private。
tidy_tags.py查找没有流派或标签的曲目。--genre 和 --tags 仅填写空项,--apply 保存更改。
account_status.py粉丝数、曲目数、套餐和剩余上传时长。
python examples/weekly_report.py --window DAYS_7
python examples/export_tracks.py --out tracks.csv

按计划运行时,只要你的电脑保持开机,就可以使用本机的 cron:0 8 * * 1 cd ~/soundcloud-api-mcp-server && .venv/bin/python examples/weekly_report.py --out ~/soundcloud-week.csv。

全部 10 个工具

ID 可从工具列表中获取:track_id 来自 list_tracks,某人的 user_id 来自 list_conversations 或 resolve_profile。运行 soundcloud-mcp tools 可打印此列表;运行 soundcloud-mcp tools --json 则会附上输入架构。

个人资料
工具访问权限REST 路由功能
get_profile读取GET /profile你自己的 SoundCloud 个人资料:姓名、城市、个人简介、粉丝数、曲目、套餐和剩余上传时长。
resolve_profile读取GET /profiles/resolve通过 SoundCloud 个人资料链接查找用户:用户 ID、姓名、城市、个人简介和粉丝数。
曲目
工具访问权限REST 路由功能
list_tracks读取GET /tracks列出你的曲目,包括公开和私有曲目,按最新优先排序,并显示播放、点赞、转发和评论数。
get_track读取GET /tracks/{track_id}查看一首曲目的标题、描述、流派、标签、分享设置、私密链接、播放数、点赞数和评论。
update_track写入PATCH /tracks/{track_id}修改你某首曲目的标题、描述、流派、标签或评论设置。
评论
工具访问权限REST 路由功能
list_comments读取GET /comments查看你某首曲目的评论,或你所有曲目下的最新评论。
数据洞察
工具访问权限REST 路由功能
get_insights读取GET /insights查看指定时间范围内你的个人资料及各曲目的播放、点赞、评论、转发和下载数据。
私信
工具访问权限REST 路由功能
list_conversations读取GET /conversations列出你的 SoundCloud 私信对话,按最新优先排序,并显示对方、最新消息及是否已读。
get_conversation读取GET /conversations/{user_id}查看你与某人的消息,按最新优先排序。
find_conversation读取GET /conversations/find根据个人资料链接,检查你是否已给某个 SoundCloud 用户发过消息。

update_track 会先读取曲目,再连同你的更改一起完整提交,因此未填写的字段会保留原值。将 description 或 genre 设为空会清除对应内容,而 tags 会替换所有标签。此仓库中没有其他功能会向 SoundCloud 写入数据:消息和评论只能读取。

此版本未提供:发送消息、回复对话和评论、删除评论以及创建播放列表。SoundCloud 的机器人检测会阻止程序执行这些操作,因此我们没有提供这些工具,以免发布无法正常工作的工具。上传、定时发布、隐私设置和受众列表功能也尚未实现。

出于设计考虑,以下功能从未实现:SoundCloud 登录、电子邮件和密码,以及 SoundCloud 套餐和账单管理。每个请求都会经过防护机制,拒绝对登录、密码和账户路径的更改。

配置

变量默认值功能
SOUNDCLOUD_MCP_HOME~/.config/soundcloud-api-mcpsession.json 所在文件夹。
SOUNDCLOUD_AUTH_TOKENoauth_token Cookie 的值,可替代 soundcloud-mcp connect。
SOUNDCLOUD_PROXY发往 SoundCloud 的所有请求所使用的代理,例如 http://user:pass@host:port。
SOUNDCLOUD_MCP_READ_ONLY1 会隐藏并拒绝 update_track(效果与 --read-only 相同)。
SOUNDCLOUD_MCP_TOKENserve 所需的 Bearer 令牌;若要监听 127.0.0.1 以外的地址,则必须设置。
SOUNDCLOUD_MCP_HOST、SOUNDCLOUD_MCP_PORT127.0.0.1、8787serve 的监听地址。

安全与 SoundCloud 账户

  • 你的密码永远不会传到此代码中。 这里只读取 Cookie,且仅限 soundcloud.com 和 sndcdn.com 的 Cookie。
  • 会话文件由你保管。 session.json 会以 0600 权限创建。任何拥有该文件的人都能以你的身份操作 SoundCloud,因此请勿将它提交到 git 或存放在共享文件夹中。
  • 默认仅限本地访问。 serve 会绑定到 127.0.0.1,若未设置 SOUNDCLOUD_MCP_TOKEN,则拒绝使用其他地址。
  • 仅限 SoundCloud。 系统会拒绝发往 soundcloud.com 和 sndcdn.com 以外地址的请求和重定向。sndcdn.com 提供 client_id 来源的脚本包。
  • 只读模式。 --read-only 或 SOUNDCLOUD_MCP_READ_ONLY=1 仅开放 9 个读取工具。
  • 读取不会更改任何内容。 读取对话线程不会在 SoundCloud 上将其标记为已读。

错误

REST API 会返回 {"error": "<code>", "message": "..."}。MCP 服务会将相同的代码和消息作为工具错误返回。

状态代码处理方法
401auth_required, auth_expired没有会话,或 SoundCloud 已将你登出。请在 Chrome 中登录 soundcloud.com,然后运行 soundcloud-mcp connect。
403scope_denied服务以只读模式运行。
403target_blockedSoundCloud 的机器人检测阻止了请求。请在 Chrome 中打开 soundcloud.com,手动执行一次相同操作,运行 connect,然后重试。
422invalid_input缺少或输入了错误的参数,或者该曲目不属于你;消息会指出具体问题。
429rate_limitedSoundCloud 正在限制该账户。请等待几分钟。
502target_errorSoundCloud 返回了错误,或更改了其 Web 应用。请在我们修复后运行 git pull 获取最新工具,或提交问题。

自托管或托管服务

本仓库Cotlet,托管服务
工具相同的 10 个相同的 10 个
运行位置在你的电脑上,电脑开机时运行在云端,全天候运行
SoundCloud 会话你的 Chrome,Cookie 保存在本地文件中你在欧盟的专属 Cloud Browser,配置文件使用 AES-256-GCM 加密
SoundCloud 更改 Web 应用时我们修复后运行一次 git pull我们为你修复,每天测试所有工具
兼容对象你电脑上的 MCP 客户端、本地脚本Claude.ai 和 ChatGPT 连接器、n8n、Make、Zapier,以及任何 HTTP 客户端
适用对象你和你自己的企业你、团队、唱片公司、企业、代理机构
价格免费免费试用 7 天,含 2,000 个额度,无需银行卡;之后可购买一次性额度包,5,000 个额度起价 $29

在托管版本中,成功调用消耗 10 个额度,失败调用免费;只要 Cloud Browser 启用了供 Agent 使用的应用,每天就会消耗 50 个额度。完整价格。

常见问题

有适用于 Claude、ChatGPT 或 Cursor 的 SoundCloud MCP 服务吗? 有,这个服务运行在你的机器上:soundcloud-mcp mcp 可用于 Claude Code、Claude Desktop、Cursor 和 Codex。ChatGPT 和 Claude.ai 连接器需要公开的 HTTPS URL,托管的 SoundCloud MCP 服务可提供该 URL。

我需要 Artist Pro 或自己的 API 应用吗? 不需要。这些工具使用你已登录的 Web 会话,因此免费账户就够了,也不需要客户端密钥。get_profile 会显示你的套餐以及剩余上传时长。

它能发送私信或回复评论吗? 此版本不支持。SoundCloud 的机器人检测会阻止程序执行这些操作。这些工具可以读取你的私信和评论,你的 Agent 可以为你起草回复,供你发布。

播放量来自哪里? get_insights 会读取与 SoundCloud Insights 页面相同的数据,时间范围从今天到所有时间,并以总量和单曲数据的形式显示。list_tracks 和 get_track 会提供每首曲目的累计数据。

为什么它需要我的 Chrome? 为了在不使用你密码的情况下读取 SoundCloud 会话。每次登录时只需使用一次 Chrome,而不是每次调用都使用。

SoundCloud 将我登出后会发生什么? 调用会因 auth_expired 而失败。启用 Chrome 远程调试后,服务会在下次调用时读取新的会话(Chrome 询问时点击“允许”)。否则,请再次运行 soundcloud-mcp connect。

它能在 VPS 或 Docker 中运行吗? 技术上可以,使用 SOUNDCLOUD_AUTH_TOKEN 或从你的电脑复制的 session.json 即可。但 SoundCloud 随后会看到你的会话来自数据中心 IP,并会在那里启用更严格的机器人检测。若要始终在线运行,托管版本会将你的会话保存在你自己的 Cloud Browser 中,并使用固定 IP。

我的 SoundCloud 账户会被封禁吗? 请求会携带 Chrome 的指纹,并逐个发送,就像你亲自点击一样。没有人能保证平台永远不会采取措施。请保持正常使用。

我可以修改代码或将其提供给客户吗? 你可以修改代码,并在自己的业务中使用。你不能将其作为托管或管理服务提供给他人。对于客户项目,请使用 Cotlet,或发邮件至 [email protected]。

工具出问题了,或者我需要另一个工具。 请提交问题,并附上工具名称和错误消息。

许可证

Elastic License 2.0。简而言之:

  • **允许:**免费供个人使用以及用于自己的业务。修改代码并以相同许可证分享。
  • **不允许:**将其作为托管或管理服务提供给他人,删除许可证声明,规避其限制。

Cotlet

由 Cotlet(@cotletdev)维护。SoundCloud 是其所有者的商标。本项目为非官方项目,与 SoundCloud 无关,也未获得 SoundCloud 的认可或赞助。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。