Jazz Agent

Инструмент для одного пользователя, который читает расписания нью-йоркских джаз-клубов, определяет, кто выступает, и создаёт плейлист Spotify для каждого клуба на каждую неделю, чтобы музыка приходила сама, без запроса. Он ведёт постоянный журнал всего, что когда-либо находил, и предоставляет этот журнал Claude через MCP, чтобы вы могли спрашивать о нём и записывать, что вам понравилось во время прослушивания.

Две половины, намеренно раздельные:

• Ежедневный пакетный конвейер (cron), который собирает, сопоставляет и согласует плейлисты.

• Постоянно работающий MCP-сервер, который отвечает на вопросы о журнале и записывает отзывы.

Почему он устроен именно так

Три вывода определили дизайн, и все три противоречат очевидному подходу:

1. Spotify удалил конечные точки, к которым вы бы обратились. Изменения API в ноябре 2024 года убрали related-artists, recommendations, audio-features и audio-analysis для любого приложения, зарегистрированного после этого. Нет ни акустических данных, ни данных о схожести исполнителей. Связи между исполнителями берутся из MusicBrainz и из самих списков клубов; «стиль» определяется тегами жанров и вашими собственными заметками.

2. CSS-селекторы — неправильный инструмент для шести неподдерживаемых веб-сайтов. Извлечение выполняется LLM по тексту страницы, поэтому добавление клуба — это строка в таблице, а редизайн площадки ничего не ломает.

3. Еженедельные плейлисты, а не ежедневные. Один плейлист на клуб на неделю бронирования (вторник–понедельник) устраняет целый класс проблем: резиденции, длящиеся несколько ночей, один и тот же артист, играющий два сета, и плейлисты, истекающие в середине периода. Ежедневный запуск становится идемпотентным циклом сходимости, а не событием создания.

Related MCP server: Spotify MCP Server

Документация

PRD хранится без изменений как запись первоначального замысла. Там, где архитектура от него отступает, ADR говорит об этом явно и называет раздел PRD, который он заменяет.

Статус

Все задачи вехи v1 реализованы и протестированы. Осталось два шага, прежде чем это действительно заработает в продакшене, и оба требуют участия человека: регистрация настоящего клиента Google OAuth и настоящего приложения Spotify Developer (см. docs/RUNBOOK.md, разделы 4–5), а также развёртывание на реальном VPS. Сборка отслеживалась как задачи в рамках вехи v1, каждая с критериями приёмки и явными ссылками Blocked by — см. закрытые задачи, чтобы узнать, что было построено и почему.

Стек

Python 3.12 с uv, Postgres 17 (tsvector, pg_trgm, pgvector), httpx с Playwright как опция для каждого клуба, Anthropic Claude Haiku для извлечения и арбитража, FastMCP с делегированным Google OAuth, Docker Compose на небольшом Linux VPS.

Лицензия

MIT.