Кратко
Reverb API для продавцов музыкального оборудования: собственные листинги с черновиком, обновлением и публикацией, заказы и доставка с отслеживанием, сообщения от покупателей, предложения, запросы на возврат, выплаты и данные магазина. Личный токен доступа.
Пошаговая настройка
Подключи Reverb к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Reverb в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Reverb
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Reverb, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Reverb
Reverb API для продавцов музыкального оборудования: собственные листинги с черновиком, обновлением и публикацией, заказы и доставка с отслеживанием, сообщения от покупателей, предложения, запросы на возврат, выплаты и данные магазина. Личный токен доступа.
Настройка
Настройка занимает около 3 минут.
- Войди на reverb.com, открой меню пользователя и перейди в Мой профиль.
- Нажми на вкладку API & Integrations, затем Создать новый токен.
- Введи имя и отметь области доступа:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutsиread_profile. Инструмент, у которого отсутствует область доступа, будет отклонён. - Скопируй токен в
REVERB_TOKEN. Личные токены доступа не истекают.
Reverb требует от каждого продавца настроить выставление счетов и создать хотя бы один листинг вручную на reverb.com перед использованием API.
С чего начать: reverb_list_orders_awaiting_shipment показывает, что должно быть отправлено. reverb_list_my_listings показывает твои активные листинги (состояние всех добавленных черновиков и завершённых); reverb_get_shop показывает магазин и его профили доставки.
Листинги: создай черновик с помощью reverb_create_listing (uuid категории из reverb_list_categories, uuid состояния из reverb_list_listing_conditions, id профиля доставки из reverb_get_shop), измени его с помощью reverb_update_listing и выстави на продажу с помощью reverb_publish_listing. reverb_list_my_drafts перечисляет неопубликованные черновики, а reverb_get_listing считывает один листинг. Найди листинг по своему SKU с помощью reverb_list_my_listings и sku. Только состояния Brand New, B-Stock и Mint с запасом могут содержать более одной единицы; использованный товар — это одна единица и не может быть повторно выставлен на продажу после продажи. Установка запаса на 0 завершает листинг. reverb_end_listing установлен выключенным.
Заказы: reverb_list_orders (все, фильтрация по последнему изменению), reverb_list_orders_awaiting_shipment, reverb_get_order. Отправляй только когда статус оплачен, с помощью reverb_ship_order (поставщик из reverb_list_shipping_providers и номер отслеживания); локальные самовывозы закрываются с помощью reverb_mark_order_picked_up. Этикетки для доставки не покупаются через этот коннектор.
Сообщения и предложения: reverb_list_conversations, reverb_get_conversation и reverb_send_message обрабатывают сообщения от покупателей. reverb_list_offers и reverb_get_offer считывают предложения по твоим листингам; reverb_decline_offer отклоняет одно из них. reverb_accept_offer и reverb_counter_offer установлены выключенными, потому что оба обязывают тебя к цене.
Возвраты и выплаты: reverb_list_refund_requests считывает запросы на возврат. reverb_respond_to_refund_request и reverb_create_refund_request установлены выключенными: одобрение возврата зачисляет средства покупателю и списывает их с тебя одновременно. reverb_list_payouts и reverb_list_payout_line_items считывают, что Reverb выплатил твоему банку и комиссии за заказ.
Форматы: деньги — это объект с amount (десятичная строка, такая как 95.00), amount_cents, currency и display; отправляй сумму и валюту. Даты — ISO 8601 с смещением. Идентификаторы: заказы используют номер заказа, листинги — числовой id листинга, категории и состояния — uuid.
Пагинация и ссылки: Reverb отвечает в формате HAL JSON. Списки содержат _links.next и _links.prev; когда следующая ссылка отсутствует, ты на последней странице. Используй page и per_page для навигации. Каждый объект также перечисляет действия, доступные для него, под _links.
Ошибки: 401 означает, что токен неверен или не имеет области доступа; 404 не найдено; 406 действие нарушает правило текущего состояния; 412 ошибка валидации с message и errors для каждого поля; 429 слишком много вызовов.
Лимиты частоты: чтения 2000 в минуту или 10000 за 10 минут; записи 600 в минуту или 3000 за 10 минут. Избегай синхронизации всего магазина сразу.
Песочница: sandbox.reverb.com — это отдельный сайт с собственными учетными записями и токенами; этот коннектор вызывает производственный API.
Предварительные условия: REVERB_TOKEN
Установка коннектора локально
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Открой http://localhost:3000/connectors/store, выбери Reverb и вставь переменные окружения, указанные в предварительных условиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
reverb_list_my_listings | Перечисляет твои собственные листинги с их id, заголовком, маркой, моделью, sku, состоянием, ценой (сумма и валюта), запасом и _links (листинг… |
reverb_list_my_drafts | Перечисляет твои черновики листингов (созданные, но еще не опубликованные) с теми же полями, что и reverb_list_my_listings: id, заголовок, марка, модель, sku… |
reverb_get_listing | Считывает один листинг по id с полями, из которых создается листинг: заголовок, марка, модель, отделка, год, описание, состояние, категории… |
reverb_create_listing | Создает листинг как черновик в твоем магазине Reverb. Он не виден покупателям, пока не будет вызван reverb_publish_listing. Укажи хотя бы заголовок… |
reverb_update_listing | Обновляет один из твоих листингов (черновик или активный): изменяются только указанные поля. Типичные использования: цена, запас, описание, фотографии, доставка… |
reverb_publish_listing | Публикует черновик листинга, чтобы покупатели могли его видеть и покупать. Черновик должен быть полным (известны марка и модель, категория, состояние, цена, фотографии… |
reverb_end_listing | Завершает активный листинг, чтобы его больше нельзя было купить. Причина not_sold просто снимает его. Причина reverb_sale говорит, что ты нашел покупателя на… |
reverb_list_orders | Перечисляет заказы, которые ты продал, все статусы: номер заказа, статус (неоплаченный, ожидание оплаты, на рассмотрении, заблокирован, оплачен, отправлен, забран… |
reverb_list_orders_awaiting_shipment | Перечисляет оплаченные заказы, которые еще нужно отправить, с теми же полями, что и reverb_list_orders (номер заказа, заголовок, количество, имя покупателя… |
reverb_get_order | Считывает один проданный заказ по его номеру заказа: номер заказа, статус (неоплаченный, ожидание оплаты, на рассмотрении, заблокирован, оплачен, отправлен, забран… |
reverb_ship_order | Отмечает оплаченный заказ как отправленный с указанием перевозчика и номера отслеживания. При send_notification равном true Reverb отправляет покупателю электронное письмо о том, что товар… |
reverb_mark_order_picked_up | Отмечает заказ на самовывоз как забранный покупателем (заказы с методом доставки local). Статус заказа становится picked_up. Используй это только… |
reverb_list_shipping_providers | Перечисляет перевозчиков (поставщиков доставки), которых Reverb принимает, когда заказ отмечен как отправленный. Используй имя поставщика точно так, как указано в… |
reverb_list_conversations | Перечисляет твои сообщения в Reverb, каждое с его id (необходимым для чтения или ответа) и _links. При unread_only равном true только… |
reverb_get_conversation | Считывает одно сообщение в деталях, с его сообщениями в хронологическом порядке (сначала старые), чтобы весь обмен с покупателем можно было… |
reverb_send_message | Ответить в существующем разговоре. Другая сторона получает сообщение в Reverb сразу, и его нельзя отменить, так что пиши его так, как… |
reverb_list_offers | Перечисляет активные предложения (Reverb называет их переговорами), которые покупатели сделали по твоим листингам, каждое с его id для reverb_get_offer и ответом… |
reverb_get_offer | Считывает детали одного предложения (переговоров) по id: листинг, на котором оно находится, предложенные цены и его текущее состояние, с _links к… |
reverb_decline_offer | Отклоняет предложение покупателя по одному из твоих листингов. Переговоры заканчиваются без продажи, и отклонение нельзя отменить; цена не… |
reverb_accept_offer | Принимает предложение покупателя. Это обязывающе: ты соглашаешься продать товар по предложенной цене и цене доставки, и покупатель может заплатить сразу.… |
reverb_counter_offer | Ответить на предложение покупателя встречным предложением: твоя цена и, при желании, цена доставки. Встречное предложение обязывающе, если покупатель принимает… |
reverb_list_refund_requests | Перечисляет запросы на возврат по твоим продажам, по умолчанию активные (pending_seller_response и условно_одобренные): id, состояние, сумма… |
reverb_respond_to_refund_request | Ответить на запрос на возврат: условно_одобренный (ты вернешь деньги, как только товар вернется; запрос остается открытым), одобренный (возврат сейчас… |
reverb_create_refund_request | Начать возврат по одному из твоих проданных заказов как продавец, полный или частичный. Он создается как условно одобренный; деньги перемещаются, когда… |
reverb_list_payouts | Перечисляет выплаты, которые Reverb отправил на твой банковский счет: по каждой выплате общая сумма (сумма и валюта), created_at, updated_at и _links.line_items… |
reverb_list_payout_line_items | Перечисляет строки одной выплаты, по одной на заказ: order_id, sale_date, sale_price, payout_currency и взимаемые комиссии (selling_fee… |
reverb_get_shop | Считывает твой магазин: id, имя, описание и shipping_profiles[] (id и имя), чьи id идут в shipping_profile_id листинга. Доставка… |
reverb_list_categories | Перечисляет все категории Reverb в одном плоском списке с их uuid и именем. UUID — это то, что берут категории листинга. Длинный список; некоторые… |
reverb_list_listing_conditions | Перечисляет состояния, которые твой магазин может использовать в листингах (Не функционирует, Плохое, Удовлетворительное, Хорошее, Очень хорошее, Отличное, Mint, B-Stock, Brand New): uuid… |
Примеры запросов
- "Какие заказы Reverb ожидают отправки?"
- "Создай черновик листинга для моей Gibson Les Paul Standard 2019 года в отличном состоянии за 2200 долларов США."
- "Какие предложения от покупателей открыты по моим листингам?"
- "Отправь заказ 12345678 с отслеживанием UPS 1Z999AA10123456784."
- "Покажи мои выплаты за последний месяц и их строки."
Следующие шаги
Это руководство помогло?