Back Market MCP Server: pedidos, anuncios y Backbox

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Back Market, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Back Market

API de vendedor de Back Market para reacondicionadores: pedidos con aceptación y envío con seguimiento, listados con precio y stock, precios de Backbox y competidores, categorías, carpetas y mensajes de atención al cliente, entregas de BackShip y pedidos de BuyBack. Token de API, por plataforma (Europa, Estados Unidos, Asia-Pacífico).

Configuración

Configurar lleva unos 3 minutos.

1. Inicia sesión en la oficina de Back Market de tu plataforma: https://www.backmarket.fr/bo-seller (Europa), https://www.backmarket.com/bo-seller (Estados Unidos) o https://www.backmarket.co.jp/bo-seller (Japón y Australia). El acceso a la API viene con una cuenta de vendedor que Back Market ha validado.
2. Abre la página de Integraciones en Opciones y crea un token de API.
3. Pega el token como se muestra en BACK_MARKET_TOKEN, sin la palabra Basic delante: el conector lo envía como Authorization: Basic seguido del token.
4. Elige tu plataforma en BACK_MARKET_HOST y tu mercado principal en BACK_MARKET_MARKET (por ejemplo fr-fr en Europa, en-us en Estados Unidos, ja-jp en Asia-Pacífico). El mercado debe pertenecer a la plataforma.

Cada llamada lleva el mercado en Accept-Language y el User-Agent BM-AnythingMCP-Connector, que Back Market requiere. Las herramientas con un argumento market pueden mirar a otro mercado de la misma plataforma para una llamada.

Por dónde empezar: back_market_list_orders con estado 1 muestra pedidos pagados cuyas líneas debes aceptar, estado 3 los pedidos a enviar. back_market_list_listings muestra tus ofertas; back_market_list_backbox indica cuáles de ellas tienen el Backbox.

Flujo de trabajo de pedidos: un pedido llega en estado 1 una vez que se valida el pago (nunca envíes en estados 0, 8 o 10). Acepta cada línea con back_market_accept_order_line (estado de línea 1 a 2); el pedido luego pasa a estado 3. Envía con back_market_ship_order y un número de seguimiento (todas las líneas van en un solo paquete, estado del pedido 9). back_market_get_order muestra los estados de las líneas. back_market_set_order_line_identifiers almacena el IMEI o número de serie del dispositivo; no puede corregirse después. back_market_cancel_order_line y back_market_refund_order_line están instalados apagados: ambos reembolsan al cliente y no pueden deshacerse, y las cancelaciones afectan al Backbox.

Listados: un listado cubre todos los mercados de la plataforma. La cantidad es compartida; el precio, comentario y garantía son por mercado. back_market_get_listing encuentra un listado por SKU; back_market_update_listing cambia el precio o stock en tiempo real (cantidad 0 lo saca de línea). back_market_import_listings (apagado) envía un CSV para muchos listados a la vez y responde con un id de tarea para back_market_get_task. back_market_get_competitors muestra el precio necesario para ganar el Backbox por mercado. back_market_get_category_tree y back_market_get_category_branch dan las categorías y los atributos que necesita un nuevo producto.

Atención al cliente: back_market_list_care_folders y back_market_get_care_folder leen casos de postventa con sus mensajes; back_market_send_care_message responde al cliente. back_market_create_care_refund está instalado apagado.

BackShip y BuyBack: back_market_list_deliveries y back_market_list_returns solo devuelven datos para vendedores que utilizan las etiquetas de envío BackShip de Back Market. back_market_list_buyback_orders y back_market_get_buyback_order leen pedidos de intercambio; validar o contrarrestar uno decide lo que se le paga al cliente y no está incluido.

Formatos: los precios son cadenas decimales con impuestos, en la moneda del mercado (160.99). Los ids de pedidos y los ids de líneas de pedidos son enteros; los ids de listados son UUIDs (el id de listado numérico está en desuso). Las fechas son RFC 3339; los filtros de carpetas de atención utilizan YYYY-MM-DD-hh-mm. Las listas responden con count, next, previous y results; next es nulo en la última página.

Límites: más de 200 llamadas en 10 segundos están bloqueadas durante 10 segundos (llamadas de catálogo: 20 en 10 segundos), con un 429. Las actualizaciones de listados están limitadas a aproximadamente 2,000 líneas de SKU por hora. Las llamadas de atención tienen límites diarios (lista de carpetas 4,000 al día, reembolsos 500 al día).

Respuestas 403: Back Market está detrás de Cloudflare. Un 403 con una página HTML o el código bot-need-challenge significa que el cortafuegos bloqueó al llamador, no que el token es incorrecto: envía el valor cf-ray de la respuesta a tu contacto de Back Market. Un token incorrecto o faltante también responde con 403 o 401, con un error JSON.

Requisitos previos: BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET

Instalar 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 Back Market y pega las variables de entorno listadas en Requisitos previos.

Herramientas disponibles

Ejemplos de consultas

• "¿Qué pedidos de Back Market tienen líneas esperando mi aceptación?"
• "¿Cuál de mis listados perdió el Backbox, y qué precio lo ganaría de nuevo?"
• "Establece el stock de mi listado de iPhone 13 reacondicionado de 128 GB a 12."
• "Envía el pedido 41234567 con seguimiento de Colissimo 6A12345678901 y el IMEI de cada línea."
• "¿Qué carpetas de atención al cliente están abiertas, y qué preguntan los clientes?"

Próximos pasos

• Conectar a Claude
• Conectar a ChatGPT