SpotifyScraper MCP
Python-библиотека и MCP-сервер, которые отдают агенту открытые данные Spotify, тексты песен и транскрипты без ключа API
- 322 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер ходит во внешний сервис Spotify и разбирает его ответы, официальной гарантии доступа нет
- Cookie sp_dc, если вы его задали, открывает вход в ваш аккаунт Spotify и хранится в окружении как секрет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/spotifyscraperОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер ходит во внешний сервис Spotify и разбирает его ответы, официальной гарантии доступа нет
- Cookie sp_dc, если вы его задали, открывает вход в ваш аккаунт Spotify и хранится в окружении как секрет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SpotifyScraper — Python-библиотека, которая читает открытый каталог Spotify: музыку, плейлисты и подкасты. Она получает анонимный токен со страниц встраивания Spotify и обращается к тем же JSON-адресам, что и веб-плеер. Регистрировать приложение и получать ключ API не нужно. MCP-сервер `spotifyscraper-mcp` приносит эти данные в Claude и другие клиенты. Инструменты вида `get_track` и `get_album` возвращают структурированный JSON, `search` ищет по каталогу, а пакетные версии забирают много идентификаторов за один вызов. Отдельные инструменты отдают чарты, похожих исполнителей и цвета обложки. Если добавить собственный cookie `sp_dc` в переменную `SPOTIFY_SP_DC`, включаются инструменты, которым нужен вход: тексты песен, транскрипты подкастов, Canvas и данные аккаунта. Сервер работает по stdio для настольных клиентов, по streamable-http и по SSE. Помимо инструментов он отдает ресурсы вида `spotify://track/{id}` и три промпта: `describe_album`, `playlist_blurb` и `summarize_episode`.
Для кого. Для разработчиков и исследователей, которым нужны метаданные, тексты и транскрипты Spotify в Claude или в своем скрипте на Python.
Подходит, если
- Нужно получить список треков плейлиста или дискографию исполнителя
- Требуется транскрипт эпизода подкаста, чтобы агент сделал по нему краткий пересказ
- Нужны цвета обложки альбома, чтобы подобрать тему страницы или афиши релиза
- Нужно собрать данные по десяткам идентификаторов за один запрос через пакетные инструменты
- Для проекта на Python нужны типизированные модели и синхронный или асинхронный клиент
Не подходит, если
- Нужно управлять воспроизведением, очередью или записывать данные в аккаунт: SpotifyScraper только читает открытые данные
- Нужны личные данные библиотеки или рекомендации по прослушиванию аккаунта: для них подходит официальный API
- Нужны audio-features: Spotify убрал эти данные из всех инструментов
- Вы отказались от доступа к cookie своего аккаунта, а нужны тексты песен или транскрипты
Пример запроса к агенту
Возьми этот плейлист Spotify, выпиши треки с исполнителями и длительностью и найди три похожих исполнителя для первого трека.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
SPOTIFY_SP_DCсекрет- Cookie sp_dc вашего аккаунта Spotify для текстов, транскриптов, Canvas, кредитов и данных аккаунта
Ограничения
Проект неофициальный и берет данные у тех же адресов, что веб-плеер, поэтому гарантий доступа от Spotify у него нет. Данные только для чтения, управлять воспроизведением нельзя. Данные audio-features вернуть нельзя: Spotify убрал их совсем.
Тексты, транскрипты, Canvas, кредиты и сведения об аккаунте требуют cookie `sp_dc` из вашего аккаунта, его нужно хранить как пароль. Требуется Python 3.10 или новее. Доступность самого Spotify из России при подготовке карточки не проверялась.
Как отключить. Удалите запись spotifyscraper из конфигурации MCP-клиента и при желании выполните `pip uninstall spotifyscraper`. Если вы задавали cookie, уберите `SPOTIFY_SP_DC` из окружения.
Частые вопросы
Как подключить SpotifyScraper к Claude Desktop?
Поставьте пакет командой `pip install "spotifyscraper[mcp]"` и добавьте в `claude_desktop_config.json` сервер с командой `spotifyscraper-mcp`. Переменная `SPOTIFY_SP_DC` в блоке `env` нужна только для инструментов с входом.
Нужен ли ключ API Spotify?
Нет. Библиотека получает анонимный токен со страниц встраивания и читает открытые данные без регистрации приложения.
Чем SpotifyScraper отличается от spotipy?
spotipy работает через официальный Web API: ему нужны ключи и OAuth, зато он умеет писать в аккаунт и читать личные данные. SpotifyScraper читает открытые данные без ключей, умеет и синхронный, и асинхронный режим и дает MCP-сервер.
Как запустить сервер в контейнере?
Образ `ghcr.io/aliakhtari78/spotifyscraper` по умолчанию слушает порт 8000 по HTTP. Команда `docker run -p 8000:8000 ghcr.io/aliakhtari78/spotifyscraper` запускает его, cookie передается через `-e SPOTIFY_SP_DC`.
Что вернут инструменты без cookie?
Инструменты Canvas, кредитов, пользователя, текстов, транскриптов и аккаунта сообщают в ответе, что им нужна переменная `SPOTIFY_SP_DC`. Остальные инструменты работают без нее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
MCP-сервер Яндекс Музыки с анализом жанров
Yandex Music MCP Server
Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio
MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
MCP Яндекс Музыки для разбора вкуса
Yandex Music MCP
Однофайловый MCP-сервер Яндекс Музыки без установки через uv: лайки, плейлисты, поиск и разбор музыкального вкуса
YouTube MCP (Zubeid)
Zubeid YouTube MCP Server
YouTube MCP на ключе Data API: агент ищет видео и каналы с фильтром по числу подписчиков, читает плейлисты, статистику и расшифровки
MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| SpotifyScraper (эта запись) | нет | не нужна | 322 | |
| Spotify MCP Server | нет | OAuth | 490 | управляет воспроизведением, очередью и плейлистами через официальный API, а SpotifyScraper читает открытые данные без ключей |
| MCP Music Forge: загрузка и обработка треков | нет | ключ необязателен | 5 | скачивает и перекодирует треки из нескольких сервисов через очередь, SpotifyScraper отдает только метаданные |
Коротко о README
Версия 3 — полное переписывание проекта ради надежности и чистого API. Автор сравнивает библиотеку со spotipy, приводит код синхронного и асинхронного клиента и дает ссылку на онлайн-демо. Поддержку репозитория он ведет с помощью Claude Code.