Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi eMAG Marketplace con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
API di eMAG Marketplace per i venditori su eMAG Romania, Bulgaria e Ungheria (e Fashion Days): prodotti e offerte, prezzi e giacenze, ordini con presa in carico e cambi di stato, etichette di spedizione AWB, resi (RMA), categorie e caratteristiche, campagne e fatture. eMAG deve abilitare l'IP chiamante.
Prova a chiedere
Prompt di esempio per eMAG Marketplace
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 → eMAG Marketplace, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
eMAG Marketplace + Meta Muse
API di eMAG Marketplace per i venditori su eMAG Romania, Bulgaria e Ungheria (e Fashion Days): prodotti e offerte, prezzi e giacenze, ordini con presa in carico e cambi di stato, etichette di spedizione AWB, resi (RMA), categorie e caratteristiche, campagne e fatture. eMAG deve abilitare l'IP chiamante.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD
Step 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti, più il tempo che eMAG impiega ad abilitare il tuo indirizzo IP.
- Nell'area venditori di eMAG Marketplace usa (o fai creare al titolare dell'account) un utente con diritti API.
- Whitelist dell'IP: eMAG accetta chiamate API solo dagli indirizzi IP registrati presso di loro. Invia al supporto di eMAG Marketplace l'IP pubblico da cui chiama questo connettore: su un'installazione self-hosted l'indirizzo del tuo server, su AnythingMCP Cloud l'indirizzo IPv4 fisso
104.248.242.235, da cui Cloud fa ogni chiamata. Finché eMAG non lo aggiunge, ogni chiamata rispondeYou are not allowed to use this API. - Imposta
EMAG_API_HOSTsull'host della tua piattaforma, senza percorso:https://marketplace-api.emag.ro(Romania),https://marketplace-api.emag.bg(Bulgaria),https://marketplace-api.emag.hu(Ungheria),https://marketplace-ro-api.fashiondays.comohttps://marketplace-bg-api.fashiondays.com(Fashion Days). Ogni piattaforma è un account separato: installa un connettore per paese. - Inserisci l'utente API in
EMAG_USERNAMEe la sua password inEMAG_PASSWORD(HTTP Basic auth). - Installa il connettore ed esegui
emag_marketplace_list_vat_rates: una chiamata leggera che conferma credenziali e IP.
Come funziona l'API: il connettore usa la eMAG Marketplace API 3 (documentazione v4.5.2). Ogni risorsa si chiama come POST <resource>/read, count o save. Le letture prendono filtri e paginazione come campi di primo livello (currentPage, itemsPerPage al massimo 100); i salvataggi prendono una lista di oggetti che il connettore racchiude in data. Le letture sono marcate come sola lettura anche se sono POST. Ogni risposta è {"isError": false, "messages": [], "results": [...]}; isError: true viene riportato come chiamata fallita con i messaggi. Un'eccezione: salvando un nuovo prodotto con un problema di documentazione eMAG risponde isError: true ma l'offerta viene salvata comunque, quindi l'AI la rilegge con emag_marketplace_list_product_offers.
Cosa legge: i tuoi prodotti e offerte con prezzo, giacenza per magazzino, tempo di evasione, stato, stato di validazione della documentazione e dell'offerta, doc_errors, posizione nel buy button e campagna, filtrati per id, codice articolo, PNK o stato e contati con gli stessi filtri; se un prodotto esiste già su eMAG tramite EAN (fino a 100 alla volta), così la tua offerta si aggancia al prodotto esistente; le categorie con caratteristiche, valori ammessi e obbligatorietà; aliquote IVA e tempi di evasione; gli ordini con cliente, indirizzo di consegna, prodotti, voucher, metodo di pagamento, costo di spedizione e allegati; la volumetria dei pacchi; gli AWB con corriere, storico degli stati, peso e contrassegno, in PDF (A4, A5, A6) o ZPL; le richieste di reso con motivo, indirizzo di ritiro e AWB; località, account corriere, i tuoi indirizzi di ritiro e reso e i pacchi predefiniti; le campagne con regole e scadenze, le offerte ammissibili con il prezzo massimo di campagna, i badge di campagna e il prezzo Smart Deals; le fatture che eMAG ti emette e le fatture sui tuoi ordini.
Ordini e spedizione: stato dell'ordine 1 nuovo, 2 in lavorazione, 3 preparato, 4 finalizzato, 0 annullato, 5 restituito. Il flusso: nuovo ordine, emag_marketplace_acknowledge_order (a 2), emag_marketplace_save_order con stato 3, un AWB con emag_marketplace_create_awb, poi stato 4. emag_marketplace_save_order richiede l'ordine intero così come è stato letto, con diversi solo i campi modificati; gli ordini si possono modificare solo in stato 2 o 3. I voucher fanno parte dei dati dell'ordine (vouchers, product_voucher_split). Per un AWB l'AI sceglie l'account corriere, l'indirizzo del mittente e gli id delle località, poi rilegge l'etichetta.
Resi (RMA): request_status 2 nuovo, 3 preso in carico, 6 ricevuto, 7 finalizzato, 4 rifiutato, 5 annullato. emag_marketplace_save_return porta avanti un reso: da 2 a 3 o 5, da 3 a 6 o 5, da 6 a 4 o 7.
Cosa scrive: prezzi, giacenze, tempo di evasione e stato delle offerte (emag_marketplace_update_offers, emag_marketplace_update_offer_stock), nuovi prodotti con la loro offerta (emag_marketplace_save_product_offers), misure, presa in carico e stato degli ordini, allegati agli ordini (fattura tipo 1, garanzia tipo 3), sblocco del corriere, AWB, stato dei resi e proposte di campagna. Agiscono sul negozio live e su corrieri reali. Prima di ogni scrittura l'AI mostra cosa cambia (id delle offerte con prezzo o giacenza vecchi e nuovi, ordine e nuovo stato, dati dell'AWB) e aspetta il tuo sì. All'installazione nulla è disattivato; un amministratore può spegnere qualsiasi strumento di scrittura che al team non serve.
Leggere i dati: id sulle offerte è il tuo id prodotto del venditore (ext_id); part_number_key (PNK) è la chiave prodotto di eMAG. Un'offerta è in vendita solo con giacenza sopra 0, stato 1, offer_validation_status 1 e validation_status 3, 9, 11 o 12. I prezzi sono senza IVA nella valuta della piattaforma (RON in Romania, EUR in Bulgaria dal 1° gennaio 2026, HUF in Ungheria). Le date sono YYYY-mm-dd HH:ii:ss nell'ora locale della piattaforma.
Paginazione e limiti: gli elenchi restituiscono al massimo 100 voci per pagina; l'AI conta prima e pagina con currentPage. Le offerte ammissibili alle campagne usano una paginazione a cursore con l'ultimo ext_id come lastId. I filtri di data degli ordini nel conteggio richiedono entrambi gli estremi, a non più di un mese di distanza. Le chiamate di salvataggio accettano al massimo 50 entità (consigliate da 10 a 50) e 4000 campi di input per richiesta. eMAG consente 12 richieste al secondo per gli ordini e 3 al secondo per tutte le altre risorse insieme; oltre risponde 429.
Errori comuni: You are not allowed to use this API. o 403 significa che l'IP non è ancora in whitelist. 401 significa nome utente o password errati, un utente senza diritti API o un host di una piattaforma diversa da quella dell'account. 429 è il limite di frequenza: aspetta un momento. Le altre risposte isError riportano i messaggi di eMAG, ad esempio caratteristiche mancanti o un prezzo non valido.
Il connettore non apre un account venditore, non registra il tuo IP presso eMAG e non lavora su più piattaforme: un connettore serve un paese.
Step 2 — Installa l'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
Step 3 — Aggiungi il connettore in Muse
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
eMAG Marketplace.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
emag_marketplace_list_vat_rates | List the VAT rates of the platform with their vat_id, which every offer you save must carry |
emag_marketplace_list_handling_times | List the handling time values (days until you hand an order to the courier) the platform accepts for the handling_time of an offer |
emag_marketplace_list_categories | Read eMAG categories |
emag_marketplace_count_categories | Count the eMAG categories you may read, to know how many pages emag_marketplace_list_categories has |
emag_marketplace_list_product_offers | Read your products and offers: price, stock per warehouse, handling time, status (1 active, 0 inactive, 2 end of life), documentation and… |
emag_marketplace_count_product_offers | Count your products and offers with the same filters as emag_marketplace_list_product_offers, e.g. how many are inactive or have an invalid… |
emag_marketplace_find_products_by_ean | Check whether products already exist on eMAG by EAN (up to 100 at once): part_number_key, name, brand, category, whether you may add an… |
emag_marketplace_list_orders | Read orders with customer, delivery address, products (price, quantity, status, campaign), vouchers, payment method, shipping tax and… |
emag_marketplace_count_orders | Count orders with the same filters as emag_marketplace_list_orders, e.g. how many new (status 1) orders wait |
emag_marketplace_list_order_attachments | Read the attachments of an order (invoices, warranties, manuals, AWBs) with their type and URL |
emag_marketplace_get_order_volumetry | Read the weight and dimensions eMAG knows for each product of an order, to fill the packages of an AWB |
emag_marketplace_get_awb | Read an AWB (shipping label) issued through the API: order or return id, AWB number and barcode, courier, status history, weight and cash… |
emag_marketplace_get_awb_pdf | Download an AWB issued through the API as a PDF in A4, A5 or A6 (or as ZPL), to print the shipping label |
emag_marketplace_get_awb_zpl | Read an AWB issued through the API in ZPL (base64), for thermal label printers |
emag_marketplace_list_returns | Read return requests (RMA) with order, products, return reason, pickup address, AWBs and status (1 incomplete, 2 new, 3 acknowledged, 4… |
emag_marketplace_count_returns | Count return requests with the same filters as emag_marketplace_list_returns, e.g. how many new (2) returns wait |
emag_marketplace_list_localities | Read localities (cities with their region, zip code and emag_id) for the sender and receiver of an AWB |
emag_marketplace_list_courier_accounts | List your courier accounts (id, courier name, type order or return, lockers or offices, status) to choose the courier_account_id of an AWB |
emag_marketplace_list_addresses | List your pickup, return and invoice addresses (address_id, type, locality, street) to use as sender or return address of an AWB or return |
emag_marketplace_list_awb_packages | List your predefined AWB packages (label, length, width, height, weight, default), used when issuing AWBs without explicit packages |
emag_marketplace_list_campaigns | Read the eMAG campaigns (Black Friday, discount, voucher, multi deals) with start, end and offer deadline and their participation rules… |
emag_marketplace_list_campaign_categories | Read the categories eligible for campaigns with restricted categories (participationRules.restrictedCategories true): id, name and parent.… |
emag_marketplace_list_campaign_eligible_offers | Read your offers that may join a campaign: current price, lowest price of the last 30 days (cmmp), maximum campaign price, stock… |
emag_marketplace_get_offer_campaign_badges | Read the campaign badges (Black Friday, Genius Days and others) active or planned for one of your offers, with label text and dates. eMAG… |
emag_marketplace_check_smart_deals_price | Get the price an offer must reach to qualify for the Smart Deals badge |
emag_marketplace_list_invoice_categories | List the categories of the invoices eMAG issues to you (e.g |
emag_marketplace_list_invoices | Read the invoices eMAG issued to you (commission, services and others): number, date, lines, totals with and without VAT and currency |
emag_marketplace_list_customer_invoices | Read the invoices issued to your customers on eMAG orders (normal or storno): order id, number, date, lines and totals |
emag_marketplace_update_offers | Update existing offers only (light offer API, up to 50 per call): price, recommended, minimum and maximum price, stock and handling time… |
emag_marketplace_update_offer_stock | Set the stock of one offer per warehouse (PATCH, stock only) |
emag_marketplace_save_product_offers | Create new products with their offer, or update offers, up to 50 per call |
emag_marketplace_save_measurements | Save the volume measurements of products (length, width, height in millimetres, weight in grams) |
emag_marketplace_acknowledge_order | Acknowledge a new order: moves it from 1 (new) to 2 (in progress) and stops eMAG notifying you about it |
emag_marketplace_save_order | Update an order: set status 3 (prepared), 4 (finalized) or 0 (canceled with reason_cancellation), remove or add products, or storno a… |
emag_marketplace_unlock_courier | Unlock the courier selection of an order so a different courier account can be used for its AWB |
emag_marketplace_save_order_attachments | Attach documents to orders by URL: invoice (type 1), warranty (type 3, with order_product_id) and other types |
emag_marketplace_create_awb | Issue an AWB (shipping label) with your eMAG courier account for an order or a return: sender, receiver (with locality_id), parcels or… |
emag_marketplace_save_return | Update a return request (RMA), mainly its request_status: 2 new to 3 acknowledged or 5 canceled, 3 to 6 received, 6 to 4 refused or 7… |
emag_marketplace_propose_campaign_offers | Propose your offers in a campaign with the campaign price (and voucher discount, maximum quantity per order or date intervals where the… |
Esempi di prompt
- "Quante delle nostre offerte eMAG sono inattive o hanno uno stato di validazione dell'offerta non valido?"
- "Elenca i nuovi ordini eMAG (stato 1) di oggi con prodotti e metodo di pagamento."
- "Abbassa il prezzo dell'offerta 10452 a 189,90 RON senza IVA e imposta la giacenza a 25. Mostrami prima i valori vecchi e nuovi."
- "Emetti un AWB per l'ordine 412398765 con il nostro account corriere e dammi il PDF in A6. Mostrami prima i dati dell'AWB."
- "Quali delle nostre offerte possono partecipare alla campagna Black Friday, e qual è il loro prezzo massimo di campagna?"
FAQ
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?