Resumen
API de Reverb para vendedores de equipos musicales: gestión de listados propios con borradores, 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 Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Reverb con la configuración guiada y añade tu URL MCP a Gemini. 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 + Gemini
API de Reverb para vendedores de equipos musicales: gestión de listados propios con borradores, 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.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
REVERB_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda 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 & 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. Un conector cuyo alcance falte será rechazado. - Copia el token en
REVERB_TOKEN. Los tokens de acceso personal no caducan.
Reverb pide a cada vendedor que tenga configurada la facturación 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 que incluye 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 se instala desactivado.
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 se instalan desactivados, porque ambos te comprometen a un precio.
Reembolsos y pagos: reverb_list_refund_requests lee las solicitudes de reembolso. reverb_respond_to_refund_request y reverb_create_refund_request se instalan desactivados: aprobar un reembolso acredita al comprador y te debita a la vez. 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 desplazamiento. 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 next estás en la última página. Usa page y per_page para moverte. Cada objeto también lista las acciones disponibles 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.
Paso 2 — Instalar el adaptador
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
Paso 3 — Añadir el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Reverb.
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 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 indica 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 los 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 indica en… |
reverb_list_conversations | Lista tus conversaciones de mensajes en Reverb, cada una con su id (necesaria 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 puede ser retirado, 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 está, 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 puede ser retirado; 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 indicaciones
- "¿Qué pedidos de Reverb están esperando envío?"
- "Crea un borrador 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."
Preguntas frecuentes
¿Dónde obtengo el token? En reverb.com: menú de usuario, Mi Perfil, API & Integraciones, Generar Nuevo Token, con los alcances de listado, pedido, mensaje, oferta, pago y perfil. Los tokens de acceso personal no caducan. Reverb pide facturación y un listado creado manualmente antes de que la API funcione.
¿Qué cubre? Tu propia tienda: listados desde borrador hasta publicación, pedidos y envíos, conversaciones con compradores, ofertas, solicitudes de reembolso, pagos y datos de la tienda. Buscar en todo el mercado sin un token es el conector de Listados de Reverb.
¿Qué herramientas se instalan desactivadas? reverb_end_listing, reverb_accept_offer, reverb_counter_offer, reverb_respond_to_refund_request y reverb_create_refund_request, porque venden, reembolsan o finalizan un listado. Actívalas en la página del conector solo si la IA debe usarlas.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?