Resumen
Reverb API para vendedores de equipo musical: propios listados con borrador, actualización y publicación, pedidos y envíos con seguimiento, mensajes de compradores, ofertas, solicitudes de reembolso, pagos y datos de la tienda. Token de acceso personal.
Configuración guiada
Conecta Reverb a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Reverb con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Reverb
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Reverb, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Reverb
Reverb API para vendedores de equipo musical: propios listados con borrador, actualización y publicación, pedidos y envíos con seguimiento, mensajes de compradores, ofertas, solicitudes de reembolso, pagos y datos de la tienda. Token de acceso personal.
Configuración
Configurar toma aproximadamente 3 minutos.
- Inicia sesión en reverb.com, abre tu menú de usuario y ve a Mi Perfil.
- Haz clic en la pestaña API e Integraciones, luego en Generar Nuevo Token.
- Ingresa un nombre y marca los alcances:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutsyread_profile. Una herramienta cuyo alcance falte será rechazada. - Copia el token en
REVERB_TOKEN. Los tokens de acceso personal no caducan.
Reverb pide a cada vendedor que tenga la facturación configurada y al menos un listado creado manualmente en reverb.com antes de usar la API.
Por dónde empezar: reverb_list_orders_awaiting_shipment muestra lo que debe ser enviado. reverb_list_my_listings muestra tus listados activos (estado todos añade borradores y finalizados); reverb_get_shop muestra la tienda y sus perfiles de envío.
Listados: crea un borrador con reverb_create_listing (uuid de categoría de reverb_list_categories, uuid de condición de reverb_list_listing_conditions, id de perfil de envío de reverb_get_shop), cámbialo con reverb_update_listing, y ponlo a la venta con reverb_publish_listing. reverb_list_my_drafts lista borradores no publicados y reverb_get_listing lee un listado. Encuentra un listado por tu SKU con reverb_list_my_listings y sku. Solo las condiciones Nuevo, B-Stock y Mint con inventario pueden tener más de una unidad; un artículo usado es una sola pieza y no puede ser listado nuevamente una vez vendido. Establecer el inventario en 0 finaliza el listado. reverb_end_listing está instalado apagado.
Pedidos: reverb_list_orders (todos, filtrar por última modificación), reverb_list_orders_awaiting_shipment, reverb_get_order. Envía solo cuando el estado esté pagado, con reverb_ship_order (proveedor de reverb_list_shipping_providers y el número de seguimiento); las recogidas locales se cierran con reverb_mark_order_picked_up. Las etiquetas de envío no se compran a través de este conector.
Mensajes y ofertas: reverb_list_conversations, reverb_get_conversation y reverb_send_message manejan los mensajes de los compradores. reverb_list_offers y reverb_get_offer leen ofertas en tus listados; reverb_decline_offer rechaza una. reverb_accept_offer y reverb_counter_offer están instalados apagados, porque ambos te comprometen a un precio.
Reembolsos y pagos: reverb_list_refund_requests lee solicitudes de reembolso. reverb_respond_to_refund_request y reverb_create_refund_request están instalados apagados: aprobar un reembolso acredita al comprador y te debita a ti al mismo tiempo. reverb_list_payouts y reverb_list_payout_line_items leen lo que Reverb pagó a tu banco y las tarifas por pedido.
Formatos: el dinero es un objeto con amount (cadena decimal como 95.00), amount_cents, currency y display; envía cantidad y moneda. Las fechas son ISO 8601 con un desfase. Ids: los pedidos usan el número de pedido, los listados el id numérico del listado, categorías y condiciones un uuid.
Paginación y enlaces: Reverb responde en HAL JSON. Las listas llevan _links.next y _links.prev; cuando falta el siguiente estás en la última página. Usa page y per_page para moverte. Cada objeto también lista las acciones abiertas para él bajo _links.
Errores: 401 significa que el token es incorrecto o carece del alcance; 404 no encontrado; 406 la acción rompería una regla del estado actual; 412 un error de validación con message y errors por campo; 429 demasiadas llamadas.
Límites de tasa: lecturas 2,000 por minuto o 10,000 por 10 minutos; escrituras 600 por minuto o 3,000 por 10 minutos. Evita sincronizar toda la tienda a la vez.
Sandbox: sandbox.reverb.com es un sitio separado con sus propias cuentas y tokens; este conector llama a la API de producción.
Requisitos previos: REVERB_TOKEN
Instala el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Reverb y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
reverb_list_my_listings | Lista tus propios listados con su id, título, marca, modelo, sku, condición, precio (cantidad y moneda), inventario y _links (el listado… |
reverb_list_my_drafts | Lista tus listados en borrador (creados pero aún no publicados) con los mismos campos que reverb_list_my_listings: id, título, marca, modelo, sku… |
reverb_get_listing | Lee un listado por id con los campos de los que se crea un listado: título, marca, modelo, acabado, año, descripción, condición, categorías… |
reverb_create_listing | Crea un listado como un borrador en tu tienda Reverb. No es visible para los compradores hasta que se llama a reverb_publish_listing. Proporciona al menos un título… |
reverb_update_listing | Actualiza uno de tus listados (borrador o activo): solo cambian los campos dados. Usos típicos: precio, inventario, descripción, fotos, envío… |
reverb_publish_listing | Publica un listado en borrador para que los compradores puedan verlo y comprarlo. El borrador debe estar completo (marca y modelo conocidos, categoría, condición, precio, fotos… |
reverb_end_listing | Finaliza un listado activo para que ya no pueda ser comprado. La razón not_sold simplemente lo retira. La razón reverb_sale dice que encontraste al comprador en… |
reverb_list_orders | Lista los pedidos que vendiste, todos los estados: order_number, status (no pagado, pago pendiente, pendiente de revisión, bloqueado, pagado, enviado, recogido… |
reverb_list_orders_awaiting_shipment | Lista pedidos pagados que aún deben ser enviados, con los mismos campos que reverb_list_orders (order_number, título, cantidad, buyer_name… |
reverb_get_order | Lee un pedido vendido por su número de pedido: order_number, status (no pagado, pago pendiente, pendiente de revisión, bloqueado, pagado, enviado, recogido… |
reverb_ship_order | Marca un pedido pagado como enviado con el transportista y el número de seguimiento. Con send_notification true Reverb envía un correo electrónico al comprador de que el artículo está… |
reverb_mark_order_picked_up | Marca un pedido de recogida local como recogido por el comprador (pedidos con shipping_method local). El estado del pedido se convierte en picked_up. Úsalo solo… |
reverb_list_shipping_providers | Lista los proveedores de envío (transportistas) que Reverb acepta cuando un pedido se marca como enviado. Usa el nombre del proveedor exactamente como se lista en… |
reverb_list_conversations | Lista tus conversaciones de mensajes en Reverb, cada una con su id (necesario para leer o responder) y _links. Con unread_only true solo… |
reverb_get_conversation | Lee una conversación en detalle, con sus mensajes en orden cronológico (el más antiguo primero), para que todo el intercambio con el comprador pueda ser… |
reverb_send_message | Responde en una conversación existente. La otra parte recibe el mensaje en Reverb de inmediato y no se puede retractar, así que escríbelo como el… |
reverb_list_offers | Lista las ofertas activas (Reverb las llama negociaciones) que los compradores hicieron en tus listados, cada una con su id para reverb_get_offer y la respuesta… |
reverb_get_offer | Lee los detalles de una oferta (negociación) por id: el listado en el que se encuentra, los precios ofrecidos hasta ahora y su estado actual, con _links a… |
reverb_decline_offer | Rechaza la oferta de un comprador en uno de tus listados. La negociación termina sin una venta y el rechazo no se puede retractar; no se establece precio… |
reverb_accept_offer | Acepta la oferta de un comprador. Esto es vinculante: aceptas vender el artículo al precio ofrecido y al precio de envío, y el comprador puede pagar de inmediato.… |
reverb_counter_offer | Responde a la oferta de un comprador con una contraoferta: tu precio y, opcionalmente, un precio de envío. Una contraoferta es vinculante si el comprador acepta… |
reverb_list_refund_requests | Lista las solicitudes de reembolso en tus ventas, por defecto las activas (pending_seller_response y conditionally_approved): id, estado, cantidad… |
reverb_respond_to_refund_request | Responde a una solicitud de reembolso: conditionally_approved (reembolsarás una vez que el artículo esté de vuelta; la solicitud permanece abierta), approved (reembolso ahora… |
reverb_create_refund_request | Inicia un reembolso en uno de tus pedidos vendidos como vendedor, total o parcial. Se crea como condicionalmente aprobado; el dinero se mueve cuando el… |
reverb_list_payouts | Lista los pagos que Reverb envió a tu cuenta bancaria: por pago total (cantidad y moneda), created_at, updated_at y _links.line_items… |
reverb_list_payout_line_items | Lista las líneas de un pago, una por pedido: order_id, sale_date, sale_price, payout_currency y las tarifas cobradas (selling_fee… |
reverb_get_shop | Lee tu tienda: id, nombre, descripción y shipping_profiles[] (id y nombre), cuyos ids van en shipping_profile_id de un listado. Envío… |
reverb_list_categories | Lista todas las categorías de Reverb como una lista plana con su uuid y nombre. El uuid es lo que toman las categorías de un listado. Una lista larga; algunas… |
reverb_list_listing_conditions | Lista las condiciones que tu tienda puede usar en los listados (No funcional, Pobre, Justo, Bueno, Muy Bueno, Excelente, Mint, B-Stock, Nuevo): uuid… |
Ejemplos de prompts
- "¿Qué pedidos de Reverb están esperando envío?"
- "Crea un listado para mi Gibson Les Paul Standard 2019 en excelente estado a 2,200 USD."
- "¿Qué ofertas de compradores están abiertas en mis listados?"
- "Envía el pedido 12345678 con seguimiento de UPS 1Z999AA10123456784."
- "Muestra mis pagos del último mes y sus líneas."
Próximos pasos
¿Te ha sido útil esta guía?