In breve
Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.
Configurazione guidata
Collega Wish a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Wish 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 Wish
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.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Wish, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Wish
Wish Marketplace API v3 per i commercianti: ordini e evasione con tracciamento, prodotti e varianti con prezzi e inventario per magazzino, categorie e attributi, ticket di supporto clienti, valutazioni, penalità, magazzini e impostazioni di spedizione. Token di accesso OAuth da un'app privata.
Configurazione
La configurazione richiede circa 10 minuti.
- Nel pannello di controllo del commerciante Wish (https://merchant.wish.com) apri il menu Account, Impostazioni API, e clicca su Registrare un'app privata. Inserisci un nome e un URI di reindirizzamento HTTPS di tua proprietà (qualsiasi pagina funziona, il codice deve solo apparire nel suo indirizzo). Wish consente un'app privata per commerciante.
- Apri
https://merchant.wish.com/v3/oauth/authorize?client_id=seguito dall'ID client dell'app, accedi e approva. Wish reindirizza al tuo URI di reindirizzamento con?code=nell'indirizzo; il codice è valido per 5 minuti e funziona una sola volta. - Scambia il codice: apri
https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=...con i tuoi valori. Copiadata.access_tokeninWISH_ACCESS_TOKENe conservadata.refresh_tokenal sicuro.
Durata del token: I token di accesso Wish scadono dopo 30 giorni. Prima di ciò, apri https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... e incolla il nuovo token di accesso nel connettore (quello vecchio viene revocato). Wish rinnova i token solo con richieste GET, che il rinnovo automatico OAuth del connettore non invia, quindi il rinnovo è manuale per ora.
Da dove iniziare: wish_test_token controlla il token e mostra i suoi ambiti. wish_list_orders con stati APPROVED elenca gli ordini da spedire; wish_list_products elenca il catalogo; wish_list_warehouses fornisce gli ID dei magazzini necessari per l'inventario.
Ordini: wish_list_orders, wish_get_order. Spedisci con wish_fulfill_order (corriere da wish_list_shipping_carriers, numero di tracciamento, paese di origine); la stessa chiamata corregge il tracciamento in seguito. Spedizioni e rimborsi sono asincroni: leggi di nuovo l'ordine per il risultato. wish_list_refund_reasons mostra motivi validi; wish_refund_order rimborsa il cliente ed è installato disattivato.
Prodotti: wish_list_products, wish_get_product, wish_create_product, wish_update_product (prezzo, inventario per magazzino, stato delle varianti per ID variante), wish_create_variation. Categorie: wish_get_categories, wish_get_category, wish_get_category_attributes. wish_delete_product è installato disattivato; disabilita le varianti invece. wish_get_product_rating legge la valutazione.
Ticket clienti: wish_list_tickets (stato AWAITING_MERCHANT necessita di una risposta), wish_get_ticket, wish_reply_to_ticket, wish_update_ticket (chiudi, riapri, appello).
Account: wish_get_account_details, wish_list_penalties, wish_get_shipping_settings, wish_list_warehouses.
Paging: le liste restituiscono fino a limit elementi ordinati per tempo; per la pagina successiva chiama di nuovo con updated_at_max (o created_at_max) impostato sull'ora dell'ultimo elemento. Ogni risposta ha la forma code, message, data; code 0 significa successo.
Ids e formati: gli ID di ordine, prodotto, variante, ticket e magazzino sono stringhe esadecimali di 24 caratteri. I tempi sono in ISO 8601 (2026-11-01T00:00:00Z). I prezzi sono oggetti con amount e currency_code. Gli ambiti del token decidono cosa funziona: un ambito mancante restituisce 403.
Limiti di richiesta: per commerciante e app; l'intestazione Wish-Rate-Limit-Remaining mostra cosa è rimasto e un 429 porta Wish-Rate-Limit-Reset. Cita l'intestazione Wish-Request-Id quando contatti Wish riguardo a una chiamata.
Prerequisiti: WISH_ACCESS_TOKEN
Installa il connettore 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
Apri http://localhost:3000/connectors/store, scegli Wish e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
wish_test_token | Controlla che il token di accesso funzioni: restituisce l'ID del commerciante e gli ambiti del token |
wish_get_account_details | L'account del commerciante: id, nome visualizzato, contatto, paese, stato e altri dettagli dell'account |
wish_list_orders | Elenca gli ordini, aggiornati più di recente per impostazione predefinita: id, stato (APPROVED per spedire, SHIPPED, REFUNDED, REQUIRE_REVIEW), tipo di ordine, prodotto… |
wish_get_order | Un ordine per ID: stato, prodotto e variante, quantità, prezzi e pagamento, indirizzo di spedizione, requisiti di evasione e scadenza… |
wish_list_shipping_carriers | Corrieri di spedizione accettati: tutti i corrieri (GENERAL) o quelli accettati per la politica di Consegna Confermata verso un paese di destinazione… |
wish_fulfill_order | Segna un ordine come spedito, o aggiorna il suo tracciamento: corriere, numero di tracciamento e paese di origine. Asincrono; leggi di nuovo l'ordine per vedere il… |
wish_list_refund_reasons | Motivi di rimborso validi per un ordine in questo momento (cambiano durante la vita dell'ordine). Leggili appena prima di un rimborso |
wish_refund_order | Rimborso o annulla un ordine con un motivo da wish_list_refund_reasons. Il cliente riceve indietro i soldi e non può essere annullato; i rimborsi… |
wish_list_products | Elenca i prodotti, aggiornati più di recente per impostazione predefinita: id, parent_sku, nome, stato, categoria, immagini, varianti (id, sku, prezzo, inventario… |
wish_get_product | Un prodotto per ID con le sue varianti, prezzi, inventario per magazzino, immagini, attributi, stato di spedizione e revisione |
wish_create_product | Crea un prodotto con almeno una variante. Necessita di nome, descrizione (testo semplice, fino a 4.000 caratteri), SKU principale, categoria, principale… |
wish_update_product | Aggiorna un prodotto: nome, descrizione, tag, categoria, immagini, prezzi di spedizione predefiniti, stato, o le sue varianti esistenti (per ID variante… |
wish_delete_product | Elimina un'inserzione di prodotto. Non può essere annullato. Installato disattivato; disabilita le varianti con wish_update_product invece |
wish_create_variation | Aggiungi una variante a un prodotto esistente: sku, prezzo, inventario per magazzino, valori delle opzioni e immagine |
wish_get_categories | La radice dell'albero delle categorie di Wish con le sue categorie figlie (id, nome, is_leaf). Scendi con wish_get_category fino a una foglia per category_id |
wish_get_category | Una categoria per ID con i suoi figli; le categorie foglia possono essere utilizzate come category_id |
wish_get_category_attributes | Attributi di una categoria (nome, richiesto, valori consentiti) per compilare attributi e opzioni quando si creano prodotti |
wish_get_product_rating | Valutazione complessiva di un prodotto: valutazione media e conteggi delle valutazioni |
wish_list_tickets | Ticket di supporto clienti, aggiornati più di recente per impostazione predefinita: id, tipo (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), stato (AWAITING_MERCHANT… |
wish_get_ticket | Un ticket di supporto con i suoi messaggi, ordine correlato e stato |
wish_reply_to_ticket | Rispondi a un ticket nello stato AWAITING_MERCHANT (fino a 2.000 caratteri, Markdown consentito). Wish aggiorna lo stato dopo la risposta |
wish_update_ticket | Chiudi un ticket (CLOSED), riapri uno chiuso (AWAITING_MERCHANT, quando consentito) o fai appello al supporto Wish (AWAITING_WISH) |
wish_list_penalties | Penalità sull'account, le più recenti per prime: id, tipo, importo e valuta, motivo, ordine o prodotto, tempo di creazione e annullamento. Fino a 500 per… |
wish_get_shipping_settings | Impostazioni di spedizione del commerciante per ogni paese di destinazione a cui Wish spedisce: paesi abilitati, prezzi di spedizione e regioni |
wish_list_warehouses | I magazzini del commerciante: id, nome, tipo (magazzino standard per primo), indirizzo. Gli ID dei magazzini sono necessari per l'inventario e i prezzi di spedizione |
Esempi di richieste
- "Quali ordini Wish necessitano di evasione oggi?"
- "Evasione dell'ordine 64a1b2c3d4e5 con tracciamento USPS 9400111899223197428490."
- "Quali ticket di supporto stanno aspettando la mia risposta?"
- "Ci sono nuove penalità sul mio account questo mese?"
- "Qual è la valutazione del prodotto 5f9e8d7c6b5a?"
Passi successivi
Questa guida ti è stata utile?