In breve
Gestisci un account venditore Wildberries da un agente AI: ordini FBS e relativi stati, magazzini del venditore e livelli di stock, statistiche su ordini e vendite, stock nei magazzini WB, il dettaglio del report vendite, schede prodotto e prezzi, recensioni dei prodotti e domande degli acquirenti con le risposte, e richieste di reso degli acquirenti. 34 strumenti sugli host delle API WB, un solo token API.
Configurazione guidata
Collega Wildberries a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Wildberries con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Wildberries
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Wildberries, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Wildberries
Gestisci un account venditore Wildberries da un agente AI: ordini FBS e relativi stati, magazzini del venditore e livelli di stock, statistiche su ordini e vendite, stock nei magazzini WB, il dettaglio del report vendite, schede prodotto e prezzi, recensioni dei prodotti e domande degli acquirenti con le risposte, e richieste di reso degli acquirenti. 34 strumenti sugli host delle API WB, un solo token API.
Setup
Un solo token copre tutti gli strumenti; ogni strumento chiama da solo l'host API Wildberries giusto.
- Nel portale venditori apri Settings → API integrations (Настройки → Доступ к API) e clicca Create token.
- Scegli il tipo Base token. Wildberries indica che i Personal token non vanno usati nei servizi cloud. Un Base token ha limiti più bassi su diversi metodi (vedi sotto).
- Spunta le categorie che ti servono: Marketplace (ordini FBS, magazzini, stock), Statistics, Analytics (stock nei magazzini WB), Finance (report vendite), Content (schede prodotto), Prices and Discounts, Feedbacks and Questions e Buyers Returns. Scegli Read only, a meno che l'AI non debba aggiornare stock o prezzi, rispondere a recensioni e domande o decidere sui resi.
- Copia il token, che viene mostrato una sola volta, in
WILDBERRIES_API_TOKENsenzaBearer. Vale 180 giorni; creane uno nuovo prima della scadenza. - Chiama
wildberries_pingper verificare il token, poiwildberries_list_new_ordersper gli ordini FBS in attesa di essere imballati.
Un 401 significa che il token è errato o scaduto; un 403 che gli manca la categoria per quella parte dell'API.
Recensioni, domande e resi: l'AI conta le recensioni e le domande degli acquirenti ancora in attesa di risposta, le elenca, prepara le bozze delle risposte e pubblica ciascuna dopo che hai approvato il testo. Le risposte compaiono nella pagina prodotto, e una risposta si può modificare una volta, entro 60 giorni. Le richieste di reso degli ultimi 14 giorni arrivano con le decisioni che Wildberries consente per ciascuna, e l'AI invia quella che scegli. Una decisione sul reso non si può annullare. wildberries_reject_question è disattivato all'installazione.
Base token: 5 chiamate all'ora per recensioni e domande. Con un Base token, tutte le chiamate su recensioni e domande insieme sono limitate a 5 all'ora, una ogni 12 minuti, quindi in un'ora rientrano solo poche risposte. Pianifica il blocco con l'AI: con un 429 si ferma e riprende dopo il tempo di attesa indicato da Wildberries. Le richieste di reso consentono 1 chiamata all'ora con un Base token.
Altri limiti di frequenza: Marketplace consente 300 richieste al minuto, e ogni risposta 4xx conta come 10. Statistiche su ordini e vendite: una chiamata al minuto, e solo una ogni 3 ore con un Base token, quindi l'AI le chiama una volta con una data di inizio e lavora sul risultato. Dettaglio del report vendite: 2 al giorno con un Base token. Prezzi: 4 all'ora con un Base token. Con un 429, il tempo di attesa è in X-Ratelimit-Retry.
Stock nei magazzini WB: wildberries_get_wb_warehouse_stocks risponde 403 a un Base token. Funziona invece il flusso tramite report: wildberries_create_stock_report, poi wildberries_get_stock_report_status, poi wildberries_download_stock_report.
Stock e prezzi: wildberries_update_stocks sovrascrive la quantità in stock (non la somma) e wildberries_set_prices cambia i prezzi live, quindi l'AI li conferma entrambi con te. Dopo un aggiornamento rileggi lo stock: nomi di campo sbagliati restituiscono comunque 204 senza cambiare nulla.
Già installato? Gli strumenti per recensioni, domande e resi arrivano a un connettore installato in precedenza tramite il suo aggiornamento di catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e clicca Apply update. Il tuo token e gli strumenti che hai aggiunto tu restano come sono, e wildberries_reject_question arriva disattivato, come in una nuova installazione. Spunta Feedbacks and Questions e Buyers Returns sul token, oppure creane uno nuovo, se prima non erano spuntate.
Prerequisiti: WILDBERRIES_API_TOKEN
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Wildberries e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| 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… |
Esempi di prompt
- "Quante recensioni e domande degli acquirenti aspettano una risposta oggi?"
- "Prepara risposte cordiali alle recensioni a 4 e 5 stelle ancora senza risposta e mostramele prima di pubblicarle."
- "Mostrami le richieste di reso aperte e le decisioni che posso prendere su ciascuna."
- "Quali ordini FBS sono nuovi in questo momento, e quanto stock di quelle taglie resta nel mio magazzino?"
Prossimi passi
Questa guida ti è stata utile?