In breve
Il più grande marketplace dell'America Latina: leggi articoli, prodotti del catalogo e gli annunci che vi competono, ordini, costi di spedizione, commissioni, visite, tendenze e domande degli acquirenti, gestisci gli annunci del venditore (crea, valida, cambia prezzo, stock e descrizione, metti in pausa o chiudi) e le promozioni e leggi campagne e metriche di Product Ads su Brasile (MLB), Argentina (MLA), Messico (MLM), Cile (MLC), Colombia (MCO), Perù (MPE) e Uruguay (MLU). Accedi con l'account Mercado Libre del venditore.
Configurazione guidata
Collega Mercado Libre a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Mercado Libre 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 Mercado Libre
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 → Mercado Libre, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Mercado Libre
Il più grande marketplace dell'America Latina: leggi articoli, prodotti del catalogo e gli annunci che vi competono, ordini, costi di spedizione, commissioni, visite, tendenze e domande degli acquirenti, gestisci gli annunci del venditore (crea, valida, cambia prezzo, stock e descrizione, metti in pausa o chiudi) e le promozioni e leggi campagne e metriche di Product Ads su Brasile (MLB), Argentina (MLA), Messico (MLM), Cile (MLC), Colombia (MCO), Perù (MPE) e Uruguay (MLU). Accedi con l'account Mercado Libre del venditore.
Setup
- Apri il developer center del tuo paese su
https://developers.mercadolibre.com/devcentere crea un'applicazione. - Registra il redirect URI
https://cloud.anythingmcp.com/api/mcp-oauth/callbackesattamente come è scritto. Se ospiti AnythingMCP in autonomia, è<your AnythingMCP URL>/api/mcp-oauth/callback. - Copia l'App ID in
MERCADO_LIBRE_CLIENT_IDe la Secret Key inMERCADO_LIBRE_CLIENT_SECRET. - Imposta
MERCADO_LIBRE_SITE_DOMAINsul sito del tuo paese:mercadolivre.com.br,mercadolibre.com.ar,mercadolibre.com.mx,mercadolibre.cl,mercadolibre.com.co,mercadolibre.com.peomercadolibre.com.uy. Da questo dipende quale pagina di accesso nazionale si apre. - Installa il connettore, fai clic su Authorize with Provider e accedi con l'account venditore. Mantieni gli scope
offline_access read write: gli strumenti per gli annunci richiedono write.
Siti e id: MLB è il Brasile, MLA l'Argentina, MLM il Messico, MLC il Cile, MCO la Colombia, MPE il Perù e MLU l'Uruguay. Gli id di articoli e categorie portano il prefisso del sito, ad esempio MLB1234567890. Gli strumenti del venditore rispondono solo per il venditore che ha effettuato l'accesso; mercado_libre_get_user con me restituisce il tuo id venditore.
Creare un annuncio: Mercado Libre non ha una sandbox, quindi un nuovo annuncio va online subito e può già vendere. L'AI segue questo flusso:
- Prevede la categoria a partire dal titolo del prodotto.
- Legge gli attributi della categoria (invia tutti quelli obbligatori, spesso marca, modello e GTIN), le condizioni di garanzia, i tipi di annuncio (gold_special è il classico, gold_pro il premium) e i limiti, come la lunghezza massima del titolo, il numero di immagini e il prezzo minimo.
- Valida l'annuncio completo senza pubblicarlo.
- Crea l'annuncio, poi aggiunge la descrizione in testo semplice.
family_name o title: i venditori sul modello User Products, che dal 2025 riguarda la maggior parte dei venditori, inviano un family_name, cioè un nome generico del prodotto come "Apple iPhone 15 128GB", e nessun title: il titolo lo scrive Mercado Libre. I venditori ancora sul modello precedente inviano title. L'errore "The fields [title] are invalid" significa che ti serve family_name. Un annuncio con family_name non accetta modifiche al titolo.
Modificare gli annunci: puoi cambiare prezzo, stock, immagini, attributi e condizioni di vendita; immagini e attributi sostituiscono l'intera lista. Con stock 0 l'annuncio va in pausa finché lo stock non torna. Gli annunci si possono mettere in pausa e riattivare, e la descrizione si può sostituire. Titolo, condizione e modalità di acquisto restano bloccati non appena un annuncio ha delle vendite.
Prima la conferma: ogni scrittura agisce sul tuo negozio reale, quindi l'AI ti chiede conferma per ciascuna. Tre strumenti sono disattivati all'installazione: mercado_libre_close_listing, che chiude un annuncio in modo definitivo (la pausa è l'alternativa reversibile), mercado_libre_post_answer e mercado_libre_remove_item_from_promotion.
Ordini, commissioni, domande, promozioni e Product Ads: l'AI legge anche i singoli ordini e il costo della loro spedizione, calcola la commissione di vendita per un prezzo e quanto ti costerebbe la spedizione gratuita, e legge fino a 20 annunci alla volta. Mostra le visite dei tuoi annunci, le parole chiave più cercate di una categoria e, per gli annunci di catalogo, gli altri venditori sulla stessa pagina prodotto e il prezzo con cui la vinceresti. Elenca le domande degli acquirenti ancora senza risposta, legge gli inviti e le campagne promozionali, aggiunge un annuncio a una promozione e legge campagne, inserzioni e metriche di Product Ads (fino a 90 giorni indietro; Product Ads deve essere attivo in Mercado Ads). mercado_libre_post_answer è disattivato perché una risposta è subito pubblica sull'annuncio e non si può modificare, mercado_libre_remove_item_from_promotion perché l'annuncio torna al suo prezzo normale. Attivali consapevolmente nella pagina del connettore; l'AI chiede conferma prima di ogni modifica.
Già installato? I nuovi strumenti arrivano su un connettore installato in precedenza tramite l'aggiornamento del catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e fai clic su Apply update. Le tue credenziali e gli strumenti che hai aggiunto tu restano come sono, e gli strumenti di chiusura, risposta e rimozione dalle promozioni arrivano disattivati, come in una nuova installazione.
Limiti di frequenza: Mercado Libre risponde 429 quando un'applicazione invia troppe richieste, quindi i grandi lotti di modifiche agli annunci vengono eseguiti uno dopo l'altro, non in parallelo.
Prerequisiti: MERCADO_LIBRE_CLIENT_ID, MERCADO_LIBRE_CLIENT_SECRET, MERCADO_LIBRE_SITE_DOMAIN
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 Mercado Libre e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
mercado_libre_get_item | Fetch full details for a Mercado Libre item by id |
mercado_libre_get_user | Get a user's public profile (typically used to inspect a seller) |
mercado_libre_list_orders | List orders for an authenticated seller |
mercado_libre_predict_category | Suggest the category for a new listing from its title (the category predictor) |
mercado_libre_get_category | Read a category and the rules a listing in it must follow: path_from_root, listing_allowed, status, and settings such as max_title_length… |
mercado_libre_get_category_attributes | List the attributes (technical specifications) of a category: id, name, value_type, allowed values with their value_id, and tags |
mercado_libre_get_category_sale_terms | List the sale terms of a category, such as WARRANTY_TYPE and WARRANTY_TIME with their allowed values and units, to fill sale_terms when… |
mercado_libre_list_listing_types | List the listing types of a site (e.g. gold_pro, gold_special, free) with their names |
mercado_libre_list_seller_items | List the ids of a seller's listings, 50 per page by default (max 100), optionally filtered by status or SKU |
mercado_libre_validate_listing | Check a new listing without publishing it |
mercado_libre_create_listing | Publish a new listing on the seller's account; it goes live and can sell at once |
mercado_libre_update_listing | Change a listing: price, stock (available_quantity), pictures, attributes, sale terms, video or shipping |
mercado_libre_set_listing_status | Pause a listing (hidden from buyers, can be reactivated) or reactivate a paused one |
mercado_libre_close_listing | End a listing for good (status closed) |
mercado_libre_get_listing_description | Read the description text of a listing (plain_text), with its creation and update dates |
mercado_libre_add_listing_description | Add the description to a listing that has none yet, typically right after mercado_libre_create_listing |
mercado_libre_update_listing_description | Replace the description of a listing |
mercado_libre_get_items | Read up to 20 listings in one call (items multiget) |
mercado_libre_get_order | Get one order by id: status, date, buyer nickname, order_items (listing, variation, quantity, unit price), payments, total_amount, shipping… |
mercado_libre_get_shipment_costs | Get the cost breakdown of a shipment: what the buyer paid (receiver) and what the seller pays (senders), with discounts and the gross amount |
mercado_libre_get_free_shipping_cost | Quote what the seller pays to offer free shipping (Mercado Envios) for a listing or for a package size: returns the coverage cost the… |
mercado_libre_get_listing_prices | Work out the selling fees for a price on a site: per listing type, the sale_fee_amount Mercado Libre keeps on each sale (with… |
mercado_libre_get_item_visits | Get the total visits of one or more listings between two dates |
mercado_libre_get_item_visits_by_day | Get the daily visits of one listing over the last N days (time window up to 150 days) |
mercado_libre_get_product | Get a catalog product by id: name, family, attributes, pictures, main features, the domain and buy_box_winner (the listing currently… |
mercado_libre_list_product_items | List the listings that compete on a catalog product page: item_id, seller_id, price, currency, condition, listing type, shipping (free… |
mercado_libre_get_item_price_to_win | Check how a catalog listing competes for the product page: status (winning, sharing_first_place, competing, listed), price_to_win (the… |
mercado_libre_get_category_trends | Get the most searched keywords of a category on a site, by recent growth and volume |
mercado_libre_search_questions | Search buyers' questions on the seller's listings: by seller (all listings) or by one listing, optionally only UNANSWERED ones |
mercado_libre_post_answer | Publish the seller's answer to a buyer's question on a listing |
mercado_libre_list_seller_promotions | List the promotions the seller is invited to or runs (seller-promotions API): id, type (DEAL, MARKETPLACE_CAMPAIGN, PRICE_DISCOUNT… |
mercado_libre_get_promotion | Get the details of one promotion: name, type, status, dates, deadline to join, benefits and, for seller campaigns, the discount rules |
mercado_libre_list_promotion_items | List the seller's listings in a promotion with their status there (candidate = invited, pending, started, finished), price and… |
mercado_libre_get_item_promotions | List every promotion a listing takes part in or is invited to: promotion id, type, status (candidate, pending, started), the price in the… |
mercado_libre_add_item_to_promotion | Add a listing to a promotion, or accept an invitation, at a promotional price |
mercado_libre_remove_item_from_promotion | Take a listing out of a promotion; it goes back to its normal price |
mercado_libre_list_advertisers | List the Mercado Ads advertiser accounts the signed-in user can reach for Product Ads: advertiser_id, site_id and name |
mercado_libre_search_ad_campaigns | List Product Ads campaigns of an advertiser with their status, budget, strategy and ACOS target and, with a date range and metrics, their… |
mercado_libre_get_ad_campaign | Get one Product Ads campaign: name, status, budget, strategy, ACOS or ROAS target and, with a date range and metrics, its results (clicks… |
mercado_libre_search_product_ads | List the Product Ads (one per promoted listing) of an advertiser with their status and campaign and, with a date range and metrics, each… |
mercado_libre_search_ad_groups | Find the Product Ads ad groups of an advertiser, e.g. the ad group of given listings: returns each ad group's id, name, status, campaign_id… |
Esempi di prompt
- "Elenca i miei annunci attivi con prezzo e stock e segnala quelli con meno di 5 unità rimaste."
- "Crea un annuncio per un nuovo Apple iPhone 15 128GB a 4.999 R$ con 10 pezzi in stock. Validalo e mostrami il risultato prima di pubblicarlo."
- "Abbassa del 10% il prezzo dell'annuncio MLB1234567890 e aggiorna la descrizione con il nuovo testo sulla garanzia."
- "Mostrami i miei ordini degli ultimi 7 giorni con stato e totale."
- "Elenca le domande degli acquirenti ancora senza risposta sui miei annunci e prepara una bozza di risposta per ciascuna."
- "Per l'annuncio MLB1234567890 mostrami le visite degli ultimi 30 giorni, la commissione di vendita al prezzo attuale e il prezzo con cui vincerebbe la sua pagina prodotto del catalogo."
Prossimi passi
Questa guida ti è stata utile?