AliExpress MCP Server: ordini, prodotti e scorte

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Venditore AliExpress, incolla la chiave dell'app e il segreto, clicca su Authorize e accedi con l'account venditore del negozio, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Venditore AliExpress

Lascia che la tua AI gestisca il tuo negozio AliExpress: ordini e indirizzi di consegna, dichiarazioni di spedizione con il tuo corriere, prodotti con prezzi e stock, categorie, controversie e rendiconti di liquidazione. Utilizza la tua app venditore sulla Piattaforma Aperta di AliExpress.

Configurazione

Cosa ti serve: un account venditore AliExpress, un account sviluppatore sulla Piattaforma Aperta di AliExpress e un'app di tua proprietà nella categoria Sviluppatore interno venditore. AliExpress esamina il profilo dello sviluppatore e deve approvare quella categoria di app prima che l'app possa essere creata: nessuno tranne AliExpress può accelerare questo processo, e può rifiutare. Le sue FAQ cinesi indicano da 2 a 5 giorni lavorativi per la revisione dello sviluppatore; non viene fornito alcun tempo per la categoria.

1. Su https://openservice.aliexpress.com clicca su Crea Account (o accedi). Poi completa il tuo profilo sotto il tuo ID utente, Profilo: scegli il tipo di sviluppatore, compila i campi e carica i documenti richiesti da AliExpress. AliExpress esamina il profilo.
2. Apri la Console App e clicca su Crea. Nella lista delle categorie di app clicca su Richiedi su Sviluppatore interno venditore (per un venditore AliExpress che costruisce un'app per uso personale), scrivi perché ne hai bisogno nel campo Motivo e clicca su OK. La categoria mostra In attesa fino a quando AliExpress non la approva, poi Attiva. Può essere creata solo un'app per categoria.
3. Sulla categoria approvata clicca su Crea App. Inserisci un nome per l'app e, come URL di callback, l'indirizzo di questo server seguito da /api/iop-auth/callback (su AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), poi clicca su Invia.
4. Clicca su Panoramica APP, poi su Gestisci sulla tua app. Copia la Chiave App in ALIEXPRESS_SELLER_APP_KEY. Sotto Informazioni di Base clicca su Visualizza e copia il Segreto App in ALIEXPRESS_SELLER_APP_SECRET.
5. Nella stessa pagina guarda Gruppo di Permessi API: un gruppo contrassegnato come Inattivo deve essere richiesto con Richiedi e un motivo prima che le sue API rispondano.
6. Sotto Console App, Gestione App, Gestione Autenticazione inserisci l'account venditore del tuo negozio nella whitelist di autorizzazione venditore e invia. Un'app auto-sviluppata può legarsi a un massimo di 50 negozi, e solo negozi che sono legalmente collegati allo sviluppatore: la stessa azienda, controllante e controllata, la stessa società madre, o lo stesso rappresentante legale o azionista di maggioranza.
7. Sulla pagina del connettore clicca su Authorize. AliExpress mostra la sua pagina di accesso: seleziona il paese, inserisci l'account venditore e la password del negozio e clicca su Sign in And Authorize. Torni su AnythingMCP da solo.

Durata del token: AnythingMCP mantiene il token di accesso e il token di aggiornamento criptati, legge quanto durano dalla risposta di AliExpress (expires_in e refresh_expires_in, in secondi) e rinnova il token di accesso autonomamente. Un rinnovo porta un nuovo token di aggiornamento ma non sposta la data di scadenza del token di aggiornamento. Quando quella data viene raggiunta (o AliExpress risponde refresh_expires_in 0), clicca di nuovo su Authorize. La pagina Gestione Autenticazione mostra le durate della tua app; la guida cinese di AliExpress indica 365 giorni per il token di accesso e 730 giorni per il token di aggiornamento di un'app venditore auto-sviluppata.

Come firma: ogni chiamata va a /sync con il nome API in method, più app_key, access_token, un timestamp in millisecondi, sign_method=sha256 e sign, l'HMAC-SHA256 in maiuscolo di tutti i parametri ordinati per nome, chiave con il Segreto App. Il segreto non lascia mai AnythingMCP.

Da dove iniziare

• Il negozio: aliexpress_seller_get_seller_profile (id venditore, paese, valuta di quotazione, conteggi dei prodotti) e aliexpress_seller_get_shop_info (id negozio, nome e URL).
• Ordini: aliexpress_seller_list_orders con order_status WAIT_SELLER_SEND_GOODS elenca ciò che deve essere spedito; aliexpress_seller_get_order fornisce importi, sotto-ordini e tracciamento; aliexpress_seller_get_order_receipt_info l'indirizzo di consegna.
• Spedizione con il tuo corriere: aliexpress_seller_list_order_shipping_services indica per sotto-ordine se spedisce con il tuo corriere (DBS) o con la logistica della piattaforma; aliexpress_seller_list_shipment_providers fornisce i codici dei fornitori; aliexpress_seller_declare_shipment invia il corriere e il numero di tracciamento ad AliExpress e non costa nulla; aliexpress_seller_modify_shipment lo corregge (massimo due volte, entro dieci giorni). aliexpress_seller_list_packages mostra i pacchi e il loro stato.
• Logistica della piattaforma (disattivata all'installazione, perché ordinano un servizio di logistica per il negozio): aliexpress_seller_list_seller_addresses per l'indirizzo di ritiro, aliexpress_seller_pack_order per creare il pacco, aliexpress_seller_ship_platform_package per consegnarlo, aliexpress_seller_cancel_package per annullare un pacco. La stampa della lettera di vettura non è inclusa: AliExpress la restituisce come file all'interno della risposta, stampala dal centro venditore.
• Prodotti: aliexpress_seller_list_products per stato, aliexpress_seller_get_product con ogni SKU, aliexpress_seller_update_prices e aliexpress_seller_update_stock per sku_code, aliexpress_seller_set_products_online, e aliexpress_seller_set_products_offline (disattivato). Pubblicare, modificare e cancellare prodotti non sono inclusi.
• Impostazioni del catalogo: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories e aliexpress_seller_list_freight_templates.
• Controversie: aliexpress_seller_list_disputes e aliexpress_seller_get_dispute sono letture. aliexpress_seller_accept_dispute_solution è disattivato: accettare una proposta è vincolante e può rimborsare l'acquirente.
• Denaro: aliexpress_seller_list_settlement_bills elenca i rendiconti di liquidazione. Il connettore non paga, rimborsa o preleva mai da solo.

Ids e formati

• Gli id di ordine, sotto-ordine, prodotto e controversia sono numeri lunghi: passali come testo, solo cifre. L'id del sotto-ordine (child_id nella lista degli ordini, id in child_order_list di un ordine) è ciò che gli strumenti di spedizione chiamano tradeOrderItemId.
• I tempi degli ordini sono Orario del Pacifico degli Stati Uniti, scritti yyyy-MM-dd HH:mm:ss. I filtri per pacchi e controversie prendono il tempo Unix in millisecondi. I periodi di liquidazione sono scritti YYYY/MM/dd, le loro date di rilascio sono millisecondi Unix.
• Gli importi sono oggetti con amount (una stringa decimale) e currency_code; i prezzi che invii sono stringhe decimali nella valuta del prodotto.
• Le pagine delle liste partono da 1: ordini e controversie fino a 50 per pagina, pacchi fino a 50, prodotti meno di 100. Gli aggiornamenti di prezzo e stock prendono al massimo 20 prodotti con 200 SKU ciascuno.
• order_status FINISH copre ordini completati e chiusi allo stesso modo, e viene restituito solo quando richiesto. endReason nella extend_map dei suoi sotto-ordini li distingue.

Risposte e errori: i risultati si trovano sotto aliexpress_..._response (il nome API con underscore). Molte chiamate rispondono 200 e portano il proprio verdetto all'interno: result.success con errorCode e errorMessage (o error_code e error_message), update_success con update_failed_list per aggiornamenti di prezzo e stock. Leggi sempre prima di dire all'utente che una scrittura ha funzionato. I rifiuti del gateway arrivano come error_response con un code: IllegalAccessToken quando l'autorizzazione è scaduta (AnythingMCP rinnova il token una volta e riprova), InvalidAppkey o IncompleteSignature quando chiave e segreto non corrispondono, InsufficientPermission quando l'app manca del gruppo di permessi API, e un codice di limite di chiamata quando la quota della categoria dell'app è esaurita.

Prerequisiti: ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

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 Venditore AliExpress e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

Esempi di richieste

• "Quali ordini AliExpress stanno aspettando che io spedisca?"
• "Dichiara la spedizione dell'ordine 8187654321098765 con tracciamento Cainiao LP00123456789012."
• "Quali controversie sono aperte e cosa chiedono gli acquirenti?"
• "Imposta lo stock di SKU AE-CASE-14-BLK a 300 e il prezzo a 4,99 USD."
• "Mostra i rendiconti di liquidazione del mese scorso."

Prossimi passi

• Collegati a Claude
• Collegati a ChatGPT