Resumen
Gestiona una cuenta de vendedor de Wildberries desde un agente IA: pedidos FBS y sus estados, almacenes del vendedor y niveles de stock, estadísticas de pedidos y ventas, stock en los almacenes de WB, el detalle del informe de ventas, fichas de producto y precios, reseñas de productos y preguntas de compradores con sus respuestas, y solicitudes de devolución de compradores. 34 herramientas en los hosts de la API de WB, un solo token de API.
Configuración guiada
Conecta Wildberries a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Wildberries con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para Wildberries
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.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Wildberries, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Wildberries + Claude
Gestiona una cuenta de vendedor de Wildberries desde un agente IA: pedidos FBS y sus estados, almacenes del vendedor y niveles de stock, estadísticas de pedidos y ventas, stock en los almacenes de WB, el detalle del informe de ventas, fichas de producto y precios, reseñas de productos y preguntas de compradores con sus respuestas, y solicitudes de devolución de compradores. 34 herramientas en los hosts de la API de WB, un solo token de API.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
WILDBERRIES_API_TOKEN
Paso 1 — Obtener credenciales
Un solo token cubre todas las herramientas; cada herramienta llama por sí sola al host correcto de la API de Wildberries.
- En el portal de vendedores, abre Settings → API integrations (Настройки → Доступ к API) y haz clic en Create token.
- Elige el tipo Base token. Wildberries indica que los Personal tokens no deben usarse en servicios en la nube. Un Base token tiene límites más bajos en varios métodos (ver abajo).
- Marca las categorías que necesitas: Marketplace (pedidos FBS, almacenes, stock), Statistics, Analytics (stock en los almacenes de WB), Finance (informe de ventas), Content (fichas de producto), Prices and Discounts, Feedbacks and Questions y Buyers Returns. Elige Read only, salvo que la IA deba actualizar stock o precios, responder reseñas y preguntas o decidir sobre devoluciones.
- Copia el token, que se muestra una sola vez, en
WILDBERRIES_API_TOKENsinBearer. Es válido durante 180 días; crea uno nuevo antes de que caduque. - Llama a
wildberries_pingpara comprobar el token y luego awildberries_list_new_orderspara ver los pedidos FBS pendientes de empaquetar.
Un 401 significa que el token es incorrecto o ha caducado; un 403, que le falta la categoría para esa parte de la API.
Reseñas, preguntas y devoluciones: la IA cuenta las reseñas y preguntas de compradores que siguen esperando respuesta, las lista, redacta borradores de respuesta y publica cada una después de que apruebes el texto. Las respuestas aparecen en la página del producto, y una respuesta se puede cambiar una vez, en un plazo de 60 días. Las solicitudes de devolución de los últimos 14 días llegan con las decisiones que Wildberries permite para cada una, y la IA envía la que elijas. Una decisión de devolución no se puede deshacer. wildberries_reject_question está desactivado al instalar.
Base token: 5 llamadas por hora para reseñas y preguntas. Con un Base token, todas las llamadas de reseñas y preguntas juntas están limitadas a 5 por hora, una cada 12 minutos, así que en una hora caben pocas respuestas. Planifica el lote con la IA: ante un 429 se detiene y continúa tras el tiempo de espera que indica Wildberries. Las solicitudes de devolución permiten 1 llamada por hora con un Base token.
Otros límites de frecuencia: Marketplace permite 300 solicitudes por minuto, y cada respuesta 4xx cuenta como 10. Estadísticas de pedidos y ventas: una llamada por minuto, y solo una cada 3 horas con un Base token, así que la IA las llama una vez con una fecha de inicio y trabaja con el resultado. Detalle del informe de ventas: 2 al día con un Base token. Precios: 4 por hora con un Base token. Ante un 429, el tiempo de espera está en X-Ratelimit-Retry.
Stock en los almacenes de WB: wildberries_get_wb_warehouse_stocks responde 403 a un Base token. En su lugar funciona el flujo por informe: wildberries_create_stock_report, luego wildberries_get_stock_report_status y luego wildberries_download_stock_report.
Stock y precios: wildberries_update_stocks sobrescribe la cantidad en stock (no la suma) y wildberries_set_prices cambia los precios en vivo, así que la IA te confirma ambos. Vuelve a leer el stock después de actualizarlo: con nombres de campo incorrectos se recibe igualmente un 204 sin que cambie nada.
¿Ya lo tienes instalado? Las herramientas de reseñas, preguntas y devoluciones llegan a un conector instalado antes mediante su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tu token y las herramientas que añadiste tú se quedan como están, y wildberries_reject_question llega desactivado, como en una instalación nueva. Marca Feedbacks and Questions y Buyers Returns en el token, o crea uno nuevo, si antes no estaban marcadas.
Paso 2 — Instalar el adapter
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 Claude
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.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
- Pulsa + Add y después Add custom connector.
- Escribe un nombre, por ejemplo
Wildberries, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Continue, deja los ajustes detectados y vuelve a pulsar Continue. - Elige Sign in now, pulsa Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
wildberries_ping | Check that the API token is valid and reaches the WB API |
wildberries_get_seller_info | Get the seller account behind the token: legal name, seller id (sid), tax number and trade mark |
wildberries_list_new_orders | List every new FBS assembly order (order to pack and ship from your own warehouse) that exists right now: id, nmId, chrtId, article, price… |
wildberries_list_orders | List FBS assembly orders created in a period (at most 30 days per call, up to 3 months back), without their current status |
wildberries_get_order_statuses | Get the current status of up to 1000 FBS assembly orders by id: supplierStatus (new, confirm, complete, cancel), wbStatus (waiting, sorted… |
wildberries_list_supplies | List FBS supplies (shipments that group assembly orders for hand-over to Wildberries): id, name, done, created and closed dates, cargo type |
wildberries_list_warehouses | List the seller's own warehouses (id, name, linked WB office, cargo and delivery type) |
wildberries_list_wb_offices | List Wildberries offices (WB warehouses and sorting centres) that a seller warehouse can be linked to: id, name, city, address… |
wildberries_get_stocks | Read the stock on one seller warehouse for up to 1000 product sizes |
wildberries_update_stocks | Overwrite the stock of up to 1000 product sizes on one seller warehouse |
wildberries_list_statistics_orders | Orders statistics from the statistics host: one row per ordered unit with date, lastChangeDate, warehouse, region, article, nmId, barcode… |
wildberries_list_statistics_sales | Sales and returns statistics: one row per sold or returned unit with saleID (S for sale, R for return), dates, warehouse, article, nmId… |
wildberries_get_wb_warehouse_stocks | Current stock on Wildberries warehouses (FBW), one row per product size per WB warehouse, updated every 30 minutes |
wildberries_create_stock_report | Start generating the WB warehouses inventory report (stock per product on Wildberries warehouses), which also works with a Base token |
wildberries_get_stock_report_status | Check whether a WB warehouses inventory report task is ready |
wildberries_download_stock_report | Download a finished WB warehouses inventory report: per product (brand, subject, vendorCode, nmId, barcode, size) the quantity on each… |
wildberries_get_sales_report_detail | Detail lines of the sales (realisation) reports for a period: sales, returns, logistics, storage, fines and payouts per line, from 29… |
wildberries_list_product_cards | List product cards (listings) with nmID, vendorCode, brand, title, subject, characteristics, photos and sizes (chrtID, barcodes) |
wildberries_list_prices | List products with their prices: nmID, vendorCode, currency, discount, WB Club discount and per-size price and discounted price |
wildberries_set_prices | Set prices and discounts for up to 1000 products in one upload |
wildberries_get_price_upload_status | Get the state of a processed price and discount upload by its id: status, upload and activation dates, total and failed product counts |
wildberries_get_card_limits | Get the free and paid limits for creating product cards |
wildberries_count_unanswered_feedbacks | Count the feedbacks (product reviews) still waiting for the seller's answer: countUnanswered over all time and countUnansweredToday |
wildberries_count_unanswered_questions | Count the buyer questions still waiting for the seller's answer: countUnanswered over all time and countUnansweredToday |
wildberries_check_new_feedbacks_questions | Tell whether there are feedbacks or questions the seller has not seen yet (hasNewFeedbacks, hasNewQuestions) |
wildberries_list_feedbacks | List product feedbacks (reviews) with their id, text, pros, cons, rating (productValuation), product (nmId, name), date and the seller's… |
wildberries_get_feedback | Read one feedback by its id: text, pros, cons, rating, photos, product and the seller's answer |
wildberries_answer_feedback | Publish the seller's answer to a feedback; buyers see it on the product page |
wildberries_edit_feedback_answer | Replace the seller's published answer to a feedback |
wildberries_list_questions | List buyer questions about products with their id, text, product (nmId, name), date and the seller's answer if any |
wildberries_answer_question | Answer a buyer question, or change an answer already given (once, within 60 days); the question is then shown with the answer on the… |
wildberries_reject_question | Reject a buyer question so it does not appear on the product page (state none) |
wildberries_list_return_claims | List buyer return applications (claims) of the last 14 days: id, product (nm_id, imt_name), buyer comment, photos, status, dates and… |
wildberries_answer_return_claim | Decide on a buyer return application: send one of the values in the claim's actions array from wildberries_list_return_claims, such as… |
Ejemplos de prompts
- "¿Cuántas reseñas y preguntas de compradores esperan respuesta hoy?"
- "Redacta respuestas amables a las reseñas de 4 y 5 estrellas sin responder y muéstramelas antes de publicarlas."
- "Muestra las solicitudes de devolución abiertas y las decisiones que puedo tomar en cada una."
- "¿Qué pedidos FBS son nuevos ahora mismo y cuánto stock de esas tallas queda en mi almacén?"
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
- Página del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?