A
licenseB
qualityD
maintenanceIntegrates with the Mercado Livre API to enable management of sales, shipments, and shipping labels directly through Claude.
7
1
MIT
MercadoLibre Sellers MCP
by kokesaurio
It connects Claude to a MercadoLibre seller account via OAuth so you can monitor sales, listings, ads and competition — and, with confirmation, make write changes to the real store (this schema exposes 32 tools; the README advertises more, like the dashboard, workers, nichos, agenda and cerebro).
Account management: connect one or multiple stores (
ml_conectar,ml_cuentaswith a ⭐ default,ml_desconectar) and check the installed version/updates (ml_version).Sales & orders: list orders by date/status (
ml_ordenes), get a daily panel with revenue, top products, shipping methods and provinces (ml_panel_ventas), and period-over-period metrics consolidated across stores (ml_metricas,cuenta="todas"), plus shipment tracking (ml_envios).Listings: list and inspect publications with price, stock, photos and video (
ml_publicaciones,ml_publicacion), see visit traffic (ml_visitas), and audit them with a 🔴🟡🟢 quality score and concrete fixes (ml_auditar_publicaciones).Write actions (real store): update price/stock/pause (
ml_actualizar_publicacion), create or clone a listing (ml_crear_publicacion), answer buyer questions (ml_responder_pregunta), accept promotions (ml_aceptar_promocion), and upload/delete Clips (ml_subir_clip,ml_borrar_clip).Buyer interaction: read unanswered/answered questions (
ml_preguntas) and reply to them.Profitability: real ML fees for a price (
ml_comisiones), live Product Ads metrics with CTR/CPC/ACOS (ml_publicidad), and a peso-by-peso net margin calculator with max sustainable ACOS (ml_rentabilidad).Catalog & reputation: check buy-box status and the price needed to win it (
ml_precio_catalogo), and see reputation color, claims and delay rates (ml_reputacion).Promotions: list offered campaigns and eligible items (
ml_promociones).Competition & market research: search public listings (
ml_buscar), manage a watchlist of rivals/listings/keywords/trends (ml_vigilar), get only-what-changed reports (ml_novedades_competencia), and browse stored competitor history (ml_historial_competencia).Discovery: find winning products by category highlights or keyword analysis (
ml_descubrir_ganadores) and see site/category search trends (ml_tendencias).Clips: map your store's short videos and moderation status, with rejection reasons (
ml_clips).Safety: read-only tools are annotated
readOnlyHint: true; write tools are flagged and meant to be used only with explicit user confirmation (the README also notesML_SOLO_LECTURA=1disables writes).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MercadoLibre Sellers MCP ¿Cómo vienen las ventas de la semana?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP de MercadoLibre para vendedores — conectá tu tienda a Claude sin servidor
Palabras clave: MCP MercadoLibre · MercadoLibre Claude · conectar MercadoLibre a Claude · API MercadoLibre IA · Model Context Protocol MercadoLibre · vendedores MercadoLibre · automatizar MercadoLibre con IA
Conectá tu cuenta de MercadoLibre a Claude y manejá tu tienda en lenguaje natural:
"¿cómo vienen las ventas hoy?" → tablero con facturación, top productos, envíos y provincias
"¿qué preguntas tengo sin responder?" → te propone todas las respuestas y publica las que apruebes
"auditá mis publicaciones" → semáforo 🔴🟡🟢 con qué arreglar en cada una (fotos, título, video faltante, catálogo)
"armame las imágenes de esta publicación" → el set de 4 infografías profesionales con tus fotos reales
"hacé un video para Reels de este producto" → guion por escenas y video con tus datos verdaderos
"¿qué cambió en la competencia?" → solo las novedades: precios movidos, publicaciones nuevas, ventas estimadas del rival
30 herramientas · 18 skills · multicuenta con consolidado · sin servidor propio · tokens solo en tu computadora — hecho por Algoritmo Digital, consultora especializada en MercadoLibre.
Claude ──MCP──► este conector ──OAuth 2.0 + PKCE──► API oficial de MercadoLibre⭐ ¿Te sirve el conector? Dejanos una estrella — es gratis para vos y hace que más vendedores lo encuentren en GitHub y Google.
Por qué este y no otro
Este conector | Alternativas típicas | |
Onboarding | Guiado desde cero: decile "setup" a Claude y te deja operativo | Asumen que ya tenés los tokens de ML (conseguirlos es la parte difícil) o exigen una base Supabase |
Infraestructura | Ninguna: tokens en un archivo local (0600), refresh automático serializado | Backend propio, Supabase o VPS |
Idioma | Castellano, pensado para vendedores | Inglés técnico, pensado para developers |
Seguridad | PKCE, escrituras opcionales ( | Varía |
Pruebas | Suite E2E de 42 casos contra un MercadoLibre simulado, corriendo en CI en cada cambio | Rara vez |
Skills | 18 skills incluidas, del reporte diario al video del producto | No |
¿Tenés varias tiendas, querés rentabilidad real con tus costos, caja de MercadoPago y vigilancia de competidores gestionada? Eso es nuestro conector premium con CRM — este conector directo es gratis y para cualquier vendedor.
Related MCP server: Amazon Seller MCP
Guía de instalación (10 minutos, sin servidor, paso a paso)
No hace falta saber programar. Necesitás: una cuenta de vendedor de MercadoLibre, Claude Desktop y Node.js LTS instalados (ambos gratis, se instalan con "siguiente, siguiente").
⚡ Vía rápida A — Instalador automático (1 solo comando)
Abrí una terminal (Windows: Win + R → escribí cmd → Enter · Mac: app Terminal) y pegá:
npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital instalarEl instalador te guía para crear tu app gratis de MercadoLibre, te pide el App ID y el Secret, y configura Claude Desktop solo: respeta los conectores que ya tengas, hace backup de tu configuración anterior y te deja a un reinicio de usarlo. (Si ya tenés las credenciales: agregá --app-id TU_APP_ID --secret TU_SECRET.)
⚡ Vía rápida B — Que Claude lo instale por vos (Cowork / Claude Code)
¿Usás Claude Cowork o Claude Code? Pegale este prompt tal cual y listo:
Instalame el conector de MercadoLibre de Algoritmo Digital:
1. Si todavía no tengo App ID y Secret, guiame a crearlos gratis en
https://developers.mercadolibre.com.ar (app nueva, URI de redirect EXACTA
https://kokesaurio.github.io/mercadolibre-sellers-mcp-algoritmo-Digital/conectar.html
y scopes read, write y offline_access) y pedímelos.
2. Ejecutá: npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital instalar --app-id <MI_APP_ID> --secret <MI_SECRET>
3. Verificá que claude_desktop_config.json quedó con el conector "mercadolibre"
y avisame que reinicie Claude Desktop.
4. Después del reinicio te digo "conectá mi cuenta de MercadoLibre" y me guiás.
Guía: https://github.com/kokesaurio/mercadolibre-sellers-mcp-algoritmo-DigitalVía manual paso a paso (con imágenes)
¿Preferís hacerlo a mano o entender cada paso? Seguí la guía ilustrada:
Paso 1 — Creá tu aplicación gratis en MercadoLibre
Entrá a developers.mercadolibre.com.ar con tu cuenta de vendedor → Mis aplicaciones → Crear nueva aplicación y completá así:
URI de redirect (el campo que más errores causa — copiala exacta, sin barra final):
https://kokesaurio.github.io/mercadolibre-sellers-mcp-algoritmo-Digital/conectar.htmlScopes: marcá
read,writeyoffline_access— sin este último, la conexión se corta cada 6 horas.
Paso 2 — Anotá el App ID y el Secret Key
Al guardar, MercadoLibre te muestra los dos datos que van en Claude:
⚠️ El Secret Key es como una contraseña: no lo compartas ni lo publiques.
Paso 3 — Agregá el conector a Claude Desktop
Abrí el archivo de configuración:
Windows: apretá
Win + R, pegá%APPDATA%\Claude\claude_desktop_config.jsony Enter (se abre con el Bloc de notas).Mac: Claude Desktop → Settings → Developer → Edit Config.
Si el archivo está vacío, pegá este bloque completo (reemplazando tus dos datos del paso 2). Si ya tenés otros conectores, agregá solo la parte "mercadolibre":
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital"],
"env": {
"ML_APP_ID": "TU_APP_ID",
"ML_APP_SECRET": "TU_SECRET_KEY"
}
}
}
}Guardá y reiniciá Claude Desktop (cerralo del todo y volvé a abrirlo).
¿Usás Claude Code? Un solo comando:
claude mcp add mercadolibre \
-e ML_APP_ID=TU_APP_ID -e ML_APP_SECRET=TU_SECRET_KEY \
-- npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-DigitalPaso 4 — Conectá tu cuenta (una sola vez)
En un chat nuevo decile a Claude: "conectá mi cuenta de MercadoLibre" — o directamente "setup" para que la skill de puesta en marcha haga todo esto por vos.
Claude te da un link → abrilo e iniciá sesión con tu cuenta de vendedor.
Tocá Autorizar → la página te muestra un código.
Copiá el código y pegáselo a Claude. Listo: la sesión se renueva sola para siempre. ¿Más de una tienda? Repetí este paso con cada cuenta.
Si algo falla (los 5 errores clásicos)
Síntoma | Causa y solución |
El conector no aparece en Claude | Claude no se reinició del todo (en Windows, cerralo también desde la bandeja junto al reloj), o el JSON quedó mal (una coma de más). Validá el archivo en jsonlint.com |
"Faltan ML_APP_ID y ML_APP_SECRET" | Quedaron los textos |
MercadoLibre dice "invalid redirect_uri" | La URI en tu app del DevCenter no es idéntica a la del paso 1 (revisá mayúsculas y que no tenga barra final) |
"code inválido" al pegar el código | El código vence en minutos y es de un solo uso: repetí "conectá mi cuenta" y pegá el nuevo |
La conexión se corta a las horas | Faltó el scope |
¿Seguís trabado? Escribinos por WhatsApp y te ayudamos.
📋 El tablero del día
Todo lo que encuentra el equipo, en una página que se ve linda y se entiende de un vistazo: la frase del día ("En octubre facturaste $… y te quedan $… limpios. Hoy hay 2 cosas urgentes…"), lo que está funcionando y lo que necesita atención (urgente primero, cada cosa con la skill que la resuelve), el total de hoy en vivo con los gráficos de ventas y de publicidad día por día (30 días, con el detalle de cada día al pasar el mouse y vista de tabla), tus números, la planilla de los 19 trabajadores (tocás uno y ves su tabla), lo que viene, la evolución de 30 días y la bitácora filtrable.
Con los colores de MercadoLibre (franja amarilla, azul y tarjetas blancas). Decile a Claude "abrí el tablero" (ml_tablero). Es una página local, privada y sin servidor: funciona sin internet, se actualiza sola con cada control del equipo, tiene modo oscuro, se ve bien en el celular y la primera vez arranca con un tutorial guiado. Mirala con datos de ejemplo en panel/tablero.html.
👷 El equipo de trabajadores 24/7
Dieciocho trabajadores con nombre que vigilan solos y constantemente a tus seguidos — no hace falta que se lo pidas cada vez. Cada uno tiene su oficio, su frecuencia y sus skills a cargo: cuando encuentra algo, la alerta trae la skill exacta para resolverlo.
Trabajador | Vigila | Cada | Skills a cargo |
🕵️ Vera · Centinela de precios | precios de rivales; con tu publicación ( | 30 min | vigilancia-ml |
📦 Tomás · Contador de ventas | ventas estimadas del rival (ritmo/día y $/mes), quiebres de stock y pausas = tus oportunidades | 60 min | panel-ventas-ml |
🏆 Martina · Vigía de búsquedas | top 50 de tus keywords: líder, precio líder y tu puesto | 60 min | imagenes-ml |
🎯 Bruno · Cazador de rivales nuevos | vendedores que aparecen por primera vez en tus búsquedas | 3 h | revisar-publicaciones-aldi |
🩺 Lucía · Auditora de publicaciones | cada 15 días audita TODAS tus publicaciones y te dice cuáles quedaron desactualizadas: preguntas que te repiten y no están en la descripción, días sin tocar, precio congelado o fuera de mercado, sin stock, fotos chicas, sin marca/modelo o garantía — y qué mejoró o empeoró desde la auditoría anterior | 15 días | mejorar-publicaciones-ml · visualizador-publicaciones-ml · copiar-publicaciones-ml · faq-descripcion-ml |
🗓️ Clara · Agenda comercial | el cronograma de promociones de MercadoLibre y las fechas cruciales (Hot Sale, CyberMonday, Black Friday, Día de la Madre/Padre/Infancias, Navidad…). Por cada una te pregunta si querés participar y te recuerda antes del cierre hasta que decidas — nunca se inscribe sola. Cuando arranca tu evento, te arma la actualización de Mi página | 1 día | agenda-comercial-ml · mi-pagina-ml |
💰 Ramiro · Analista de rentabilidad | la ganancia neta real de cada producto que vendiste (comisión real + publicidad por unidad + impuestos + envío + costo); avisa cuando uno te hace perder plata, cuando cae el margen y qué productos vendidos no tienen costo cargado | 1 día | calculadora-ml · cerebro-ml |
📣 Ana · Gestora de anuncios | tus campañas de Product Ads: gasto, ventas por ads y ACOS; avisa la campaña que gasta sin vender, el ACOS que se dispara y —cruzando con Ramiro— el anuncio cuyo ACOS supera lo que aguanta su margen | 1 día | publicidad-ml |
🚚 Leo · Coordinador de logística | qué despachar y hasta cuándo, envíos demorados, no entregados o devueltos, y si sube tu tasa de despachos con demora (lo que más castiga la reputación) | 2 h | logistica-ml |
🧾 Carmen · Contadora | tus números del mes: facturación, comisiones de ML, publicidad, impuestos, mercadería y neto, contra el mes anterior; el día 1 te da el cierre; si faltan costos, avisa que es parcial | 1 día | contabilidad-ml · reporte-ventas-ml |
📦 Nico · Encargado de stock | cuántos días de stock te quedan de cada producto según lo que vendés por día: avisa lo que se corta esta semana, lo que quedó sin stock vendiendo y el stock parado | 6 h | stock-ml |
💬 Paula · Atención al comprador | preguntas sin responder (y las que llevan más de 2 h) y mensajes de postventa sin leer | 30 min | responder-preguntas-ml |
🛡️ Iván · Reclamos y mediaciones | reclamos nuevos con su plazo, los que vencen en 24 h, los que pasan a mediación y los que se cierran | 1 h | reclamos-ml |
⭐ Valen · Reputación y opiniones | tu color, MercadoLíder y las métricas que lo mueven, y las opiniones negativas nuevas de tus más vendidos | 1 día | reputacion-ml |
🏷️ Gabi · Catálogo | el momento en que perdés el catálogo (buy box), con qué precio lo recuperás y si a ese precio ganás plata | 6 h | competencia-ml |
🚫 Sole · Moderaciones | publicaciones pausadas, en revisión o penalizadas por ML (y portada de baja calidad), con el motivo en castellano | 6 h | moderaciones-ml |
🔄 Fede · Proveedores | precio y stock de tus proveedores (su publicación en ML o la página de su tienda): te dice a cuánto vender con tu recargo y cuándo pausar porque se quedaron sin stock | 6 h | proveedores-ml |
📈 Sofía · Radar de tendencias | keywords que entran, salen o suben en tendencias | 12 h | descubrir-ganadores-ml · video-publicaciones-ml · clips-ml · ugc-ml |
🧭 Emma · Exploradora de nichos | cada semana analiza tus nichos candidatos con la API oficial (rotación, si se venden hoy, oportunidad o monopolio, techo de demanda, tendencia/estacional/evergreen) y arma el ranking de oportunidades; toma tus búsquedas seguidas y las que le asignes, y sin ninguna explora las tendencias del sitio. Avisa cuando un nicho pasa a 🟢 o deja de serlo | 7 días | nichos-ml |
🎩 El jefe de equipo
Le das un objetivo, él reparte el trabajo entre los 19. "Quiero vender más este mes", "¿por qué gano poco?", "preparame para el CyberMonday", "mejorá mi reputación": el jefe (ml_jefe, skill jefe-de-equipo-ml) elige qué trabajadores tienen que ver, los pone a trabajar en ese momento, junta lo que encontraron y te da el plan en orden (urgentes primero), cada paso con su responsable y la skill que lo resuelve. Lo que toca tu tienda, siempre con tu OK.
Ponele el nombre que quieras. Decile a Claude "el jefe se llama Don Ramón" (y si querés, un emoji: "que sea 👑"). Desde ahí aparece con ese nombre en los planes, en la lista del equipo y en el tablero, y le hablás directo: "Don Ramón, ¿cómo vendo más este mes?".
Dales tareas hablando: "Vera, vigilá MLA123 contra mi MLA456 y avisame si baja más de 2%" · "Martina, decime en qué puesto estoy para 'termo 1 litro'" · "¿qué encontró el equipo?" · "Lucía, auditá la tienda ahora" · "Clara, ¿qué fechas vienen?". Sin tareas propias, cada uno vigila tus seguidos de ml_vigilar de su tipo.
Cuándo trabajan:
Mientras Claude está abierto: se despiertan solos (cero configuración).
24/7 con la PC prendida: un comando y arrancan solos al iniciar sesión (sin permisos de administrador):
npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital trabajadores instalarEstado:
... trabajadores estado· Sacarlo:... trabajadores desinstalar. Nunca corren dos veces a la vez (candado con latido) y la sesión de ML se renueva con candado entre procesos, así Claude y el servicio no se pisan el token.Opcional:
ML_TRABAJADORES_WEBHOOK=https://...en el config manda cada alerta a tu CRM, n8n o WhatsApp.
🗄️ Base de datos incluida, cero instalación (ideal Windows): el equipo guarda cada medición y cada alerta en SQLite, que ya viene adentro de Node.js — no hay servidor, ni Docker, ni compilar nada. Es un solo archivo, equipo.db, en %USERPROFILE%\.meli-sellers-mcp (Windows) o ~/.meli-sellers-mcp.
Guarda 400 días de historial: "historial de MLA123" muestra día por día el precio del rival vs el tuyo, cuánto vendió cada día, tu puesto en una búsqueda o el top de tendencias, con mínimos, máximos y variación.
Claude y el servicio 24/7 la usan a la vez sin trabarse (modo WAL, probado con 3 procesos escribiendo en paralelo).
"estado de la base" te dice cuánto ocupa y hace backup en un toque. Si querés mirarla por dentro:
winget install -e --id DBBrowserForSQLite.DBBrowserForSQLite.¿Node viejo? Necesita Node 22.5+ (
winget install OpenJS.NodeJS.LTSen Windows). Con uno anterior el equipo sigue funcionando igual, solo sin historial.
📊 Resultados, no solo alertas: "mostrame los resultados del equipo" trae una tabla por trabajador con todo lo que sabe — precio de cada rival vs el tuyo, ritmo de ventas y facturación estimada por mes del rival, tu puesto en cada búsqueda, rivales nuevos de la semana y el top de tendencias.
📁 Todo en tu Google Drive, actualizado solo ("conectá el equipo a Drive"):
Planilla de Google en vivo (24/7, sin crear apps en Google Cloud): pegás este script en Extensiones → Apps Script de una planilla nueva, con la clave secreta que te da Claude, y la implementás como App web. Queda una pestaña Alertas, una pestaña Historial (60 días de mediciones de la base) y una pestaña por trabajador que se reescribe en cada control.
Carpeta de Google Drive para escritorio: se detecta sola y se crea MercadoLibre - Equipo de trabajadores con Alertas.csv, Historial.csv (90 días), un CSV por trabajador y un resumen.
Seguro: la planilla rechaza envíos sin tu clave, y ningún texto de un rival (ej. un título con
=IMPORTXML(...)) se guarda como fórmula.
Las 32 skills — tu equipo de trabajo
El conector trae 32 skills listas con guía de uso de cada una. Se suben una vez en Claude (Configuración → Capacidades → Skills → Cargar skill) y convierten las herramientas en flujos completos: vos pedís en una frase, la skill sabe el procedimiento.
🚀 Empezá por acá: subí setup-ml y decile a Claude "setup" — conecta tus cuentas, arma la vigilancia inicial y te entrega tu primera foto del negocio con las 3 acciones más urgentes.
📊 Operación diaria
Skill | Pedila así |
"¿cómo venimos hoy?" — facturación de hoy y del mes, top productos, envíos FULL/Flex/Colecta y provincias | |
"reporte de ventas" — el resumen de 4 líneas apto WhatsApp | |
"respondamos las preguntas" — todas las respuestas propuestas juntas, publica solo lo que apruebes |
🔍 Optimización de publicaciones
Skill | Pedila así |
"auditá mis publicaciones" — semáforo 🔴🟡🟢 con la acción concreta por ítem, las peores primero. "Mejorá esta publicación" — el mejorador: medidas en las fotos, video, resumen en los 5 primeros renglones → medidas → características → qué viene, y FAQ de 20 con las preguntas de 90 días | |
"me preguntan siempre lo mismo" — las preguntas repetidas de tus compradores pasan a la descripción como preguntas frecuentes, con tus respuestas reales (Lucía te avisa cuáles faltan) | |
"¿qué fechas vienen?" — el cronograma de ML y las fechas cruciales; te pregunta si participás en cada una y arma la participación validada por margen | |
"actualizá Mi página" — banner del evento y tus productos destacados, aplicado en tu navegador con tu OK (y sacarlo cuando termina) | |
"abrí el tablero" — el parte del día visual: lo que funciona, lo que necesita atención y tus números de un vistazo | |
"quiero vender más este mes" — le das un objetivo y reparte el trabajo entre los 11 trabajadores, con el plan en orden | |
"¿qué tengo que despachar?" — despachos del día con horario, demorados, devoluciones y cuidado de la reputación | |
"¿cuánto gané este mes?" — el resultado neto del mes y el cierre mensual para vos o tu contador | |
"¿qué tengo que reponer?" — días de stock por producto, qué pedir y cuánto antes del quiebre | |
"me hicieron un reclamo" — responder bien y antes del plazo, mediaciones incluidas | |
"¿cómo está mi reputación?" — qué mueve tu color y qué hacer con cada opinión negativa | |
"me pausaron una publicación" — el motivo en castellano y cómo corregirla para reactivarla | |
"vigilá a mi proveedor" — precio y stock del proveedor atados a tu precio y tu stock | |
"armame el visualizador" — tablero interactivo con foto y semáforo: tocás cuáles mejorar y te genera el pedido | |
"copiá esta publicación a la otra tienda" — clona entre tus cuentas; lo ajeno se redacta, nunca se clona | |
"pasá esta publicación por Aldi" — segunda opinión con Aldi 2.0, el GPT revisor de Algoritmo Digital |
🎨 Kit creativo: imágenes y videos
Skill | Pedila así |
"armame las imágenes de MLA..." — el set fijo de 4 infografías con tus fotos reales (abajo hay ejemplos) | |
"hacé un video para Reels de MLA..." — guion por escenas y producción con HyperFrames desde datos reales | |
"¿qué clips tengo?" — mapa de Clips de la tienda, estado de moderación con motivos, y subida por API validando los requisitos de ML | |
"hacé un UGC de este producto" — estilo usuario real con avatar de IA siempre y castellano latino neutro |
🥊 Competencia y crecimiento
Skill | Pedila así |
"buscame un nicho" · "dame el ranking de oportunidades" — con la API oficial (sin Nubimetrics): rotación, ¿se vende hoy o vendió en el pasado?, oportunidad o monopolio, techo de demanda, tendencia/estacional/evergreen y si cierran los números con tu costo | |
"¿qué conviene vender?" — más vendidos oficiales por categoría, tendencias y análisis de mercado por keyword, validado por margen | |
"¿qué encontró el equipo?" — los 19 trabajadores 24/7 y su jefe: darles tareas, leer sus alertas y despachar cada una a su skill | |
"¿qué cambió en la competencia?" — solo novedades: precios movidos, publicaciones nuevas, ventas estimadas del rival, keywords en alza | |
"¿estoy ganando el catálogo?" — semáforo de precios y buy box, con recomendaciones validadas por margen | |
"revisemos la publicidad" — Product Ads con regla ACOS vs margen y promociones separando tu aporte del de ML | |
"acordate que el costo es..." — la memoria del negocio: costos, impuestos, medidas y notas guardados UNA vez, usados por todas las herramientas. Todas las skills ofrecen guardar lo que aprenden acá | |
"¿cuánto gano con este producto?" — el desglose peso por peso: comisión real + publicidad en vivo + impuestos + costo → ganancia neta, margen y ACOS máximo | |
"setup" — la puesta en marcha guiada de todo lo anterior |
Rutina sugerida: diaria = panel + preguntas (5 min) · semanal = vigilancia → visualizador → mejoras → publicidad · al publicar algo nuevo = copiar → imágenes → video → revisión con Aldi.
El set de imágenes de venta (así salen)
La skill imagenes-ml genera el set fijo de 4 — beneficio (foto 2), características (foto 4), medidas con cotas (foto 5) y qué incluye (foto 6) — en 1200×1200, con las fotos reales de tu publicación incrustadas y cumpliendo las reglas de imágenes de MercadoLibre (sin datos de contacto, sin "OFERTA", legible en miniatura):
Foto 2 — Beneficio | Foto 5 — Medidas |
|
|
Las plantillas son SVG paramétricos y el generador es un comando: python3 plantillas/generar.py --plantilla medidas --datos datos.json --foto tu-foto.png --salida foto-5-medidas.png. El método completo (orden de publicación foto 2→10, solo datos confirmados, revisión pieza por pieza) está grabado en la skill.
Herramientas (43)
Herramienta | Qué hace |
ml_conectar / ml_cuentas / ml_desconectar | Vincular varias tiendas, elegir la predeterminada (⭐) y desconectar |
ml_ordenes | Ventas con filtros de fecha y estado |
ml_panel_ventas | El tablero completo: facturación de hoy y del mes, top productos, métodos de envío y en qué provincias se concentra la venta |
ml_metricas | Facturación, unidades y ticket vs período anterior; con |
ml_envios | Estado y tracking del envío de una orden |
ml_publicaciones / ml_publicacion | Tus publicaciones y su detalle (incluye fotos y si tiene video) |
ml_auditar_publicaciones | Semáforo 🔴🟡🟢 de TUS publicaciones con cómo mejorar cada una: título, fotos, descripción, envío, stock, video faltante, tipo y catálogo — las peores primero |
ml_faq_descripcion ✏️ | Las preguntas de tus compradores → preguntas frecuentes en la descripción, con TUS respuestas reales: agrupa las repetidas, descarta stock/precio/envíos y cualquier dato de contacto, no repite lo que ya está y actualiza el bloque sin duplicar. Primero muestra la propuesta; aplica con tu OK (una o todas las que marcó Lucía) |
ml_visitas | Tráfico de una publicación |
ml_actualizar_publicacion ✏️ | Cambiar precio, stock o pausar/activar |
ml_mejorar_publicacion 🛠️ | El mejorador de publicaciones, multicuenta (encuentra solo de qué tienda es cada publicación; sin item_id barre todas tus tiendas y marca el mismo producto repetido entre ellas): te muestra las fotos para ver si tienen las medidas, chequea el video y que la descripción tenga el resumen en los 5 primeros renglones → medidas → características principales → qué viene en la caja, y audita las preguntas de los últimos 90 días en un FAQ de 20 con tus respuestas |
ml_aplicar_mejora ✏️ | Reescribe la descripción con esa estructura y el FAQ de 20 al final (vista previa primero, con tu OK la escribe y guarda un respaldo de la anterior). Con |
ml_crear_publicacion ✏️ | Crear una publicación nueva, o clonar una existente ( |
ml_preguntas / ml_responder_pregunta ✏️ | Ver y responder preguntas de compradores |
ml_cerebro 🧠 | La memoria del negocio: guarda costos, impuestos, envío, medidas y notas por producto o del negocio entero (local, en tu máquina) — y las demás herramientas lo usan solas. El costo va por SKU: lo comparten todas las publicaciones del mismo producto |
ml_publicidad | Product Ads EN VIVO: inversión, impresiones, clics, CPC, ACOS y ventas por ads de una publicación o de todas las campañas |
ml_rentabilidad | La calculadora real: precio − comisión real de ML − publicidad por unidad (en vivo) − impuestos − envío − costo = ganancia neta, margen y ACOS máximo que aguanta. Usa el 🧠 cerebro: lo que le enseñaste no te lo vuelve a preguntar, y lo nuevo lo aprende solo |
ml_comisiones | Cuánto cobra ML por vender a un precio dado |
ml_precio_catalogo | Si ganás la buy box del catálogo y qué precio la gana |
ml_buscar | Espiar competencia y precios de mercado |
ml_reputacion | Color, reclamos, demoras y cancelaciones |
ml_promociones / ml_aceptar_promocion ✏️ | Promociones ofrecidas y aceptación por ítem |
ml_agenda 🗓️ | La agenda comercial: fechas cruciales del año (calculadas solas cada año, por país) + el cronograma de campañas de MercadoLibre con cierre de inscripción y candidatas. Guarda tu decisión de participar o no (Clara te sigue preguntando hasta que decidas), fechas propias, y arma el kit para actualizar Mi página (banner y destacados del evento) |
ml_tablero 📋 | El tablero del día: arma (y con |
ml_jefe 🎩 | El jefe de equipo: le das un objetivo en una frase y reparte el trabajo entre los trabajadores que corresponden, los hace trabajar ya y te devuelve el plan en orden con responsable y skill por paso. Con |
ml_numeros 🧾 | Los números del mes de Carmen: facturación, comisiones reales de ML, publicidad, impuestos, mercadería, envíos → resultado neto y margen, contra el mes anterior (marca "parcial" si faltan costos) |
ml_despachos 🚚 | La lista de Leo: qué despachar y hasta cuándo, demorados, devueltos/no entregados, por tipo de envío, y tu % de despachos con demora |
ml_nichos 🧭 | Descubrir nichos con la API oficial: rotación de cada publicación, si se vende hoy o vendió en el pasado, oportunidad o monopolio, techo de demanda y cuánto vende un nuevo, tendencia/estacional/evergreen y, con tu costo, si cierran los números. Con varias búsquedas, el ranking de oportunidades (0-100) |
ml_tendencias | Qué está buscando la gente en ML |
ml_descubrir_ganadores | Artículos ganadores con datos de la API: ranking oficial de más vendidos por categoría (highlights) + análisis de mercado por keyword (competencia, precios, dominancia, señal de oportunidad) |
ml_vigilar / ml_novedades_competencia | Lista de rivales 🥊, productos seguidos 📦, búsquedas y trends — y el control que reporta solo lo que cambió: precios, publicaciones nuevas, ventas estimadas del rival, cambios de líder y keywords en alza |
ml_trabajadores 👷 | El equipo 24/7 (19 trabajadores; a Emma se le asigna |
ml_historial_competencia | La base de datos de competencia: evolución de precios, ventas y líderes de cada objetivo vigilado — se alimenta sola con cada control |
ml_clips | Los Clips (videos verticales) de tus publicaciones y cuáles sirven: mapa de la tienda + estado de moderación por clip (publicado/en revisión/rechazado con el motivo y cómo corregirlo) |
ml_subir_clip ✏️ / ml_borrar_clip ✏️ | Subir un clip por API (valida formato, duración y peso antes) y borrar los rechazados para resubir corregidos |
ml_version | Versión instalada, chequeo de actualizaciones y cómo actualizar |
✏️ = escribe en tu tienda real. Claude siempre pide confirmación antes, y con ML_SOLO_LECTURA=1 esas 9 herramientas directamente no existen.
Varias tiendas
Corré ml_conectar una vez por cada cuenta. Todas las herramientas aceptan cuenta (el user_id) para elegir tienda; sin indicarla se usa la predeterminada (⭐, se cambia con ml_cuentas), y si hay varias sin predeterminada el conector pide elegir en vez de adivinar — nunca opera en la tienda equivocada. "¿Cómo vienen las ventas de todas las tiendas?" usa el consolidado.
Actualizaciones
El conector se chequea solo contra GitHub (una vez por día, sin enviar ningún dato): cuando publicamos una mejora, la primera respuesta de tu sesión te avisa que hay versión nueva. También podés preguntarle a Claude "¿qué versión del conector tengo?" (ml_version). Para actualizar:
npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital actualizar…y reiniciá Claude: al arrancar baja la última versión automáticamente. Historial de cambios en el CHANGELOG y en los releases.
Seguridad
OAuth 2.0 con PKCE; los tokens viven en
~/.meli-sellers-mcp/cuentas.jsoncon permisos 0600, en tu máquina y en ningún otro lado.El refresh token de ML es de un solo uso: el conector serializa los refresh (single-flight) para que dos llamadas concurrentes no revoquen tu cuenta.
La página del código de autorización es estática (GitHub Pages) y no envía nada a ningún servidor.
Cero telemetría, cero base de datos externa.
¿Encontraste una vulnerabilidad? Leé la política de seguridad — reporte privado, respuesta en 72 hs.
Desarrollo y comunidad
npm install
npm test # 42 pruebas E2E contra un MercadoLibre simulado
npm run dev # levanta el simulado en :9990 (conectar con code CODE-OK)Cada push corre la suite completa en GitHub Actions. ¿Querés sumar algo? Leé cómo contribuir — regla de oro: todo cambio deja npm test en verde y cada funcionalidad nueva trae su caso E2E. ¿Encontraste un error o te falta una herramienta? Abrí un issue.
Comunidad
📲 Sumate al grupo de WhatsApp de vendedores — novedades del conector, tips de MercadoLibre y ayuda entre vendedores que ya lo usan.
¿Querés más?
Algoritmo Digital hace consultoría, gestión de cuentas y desarrollo a medida sobre MercadoLibre hace más de 15 años. Escribinos: WhatsApp
Licencia
MIT — Algoritmo Digital.
Available Tools
32 toolsml_aceptar_promocionAceptar promociónA
ACTIVA una publicación dentro de una promoción de MercadoLibre, al precio indicado. Visible para compradores: usar solo con confirmación explícita por ítem.
Inputs: tipo (required), item_id (required), promocion_id (required), cuenta, +1 more.
ml_actualizar_publicacionActualizar publicaciónA
MODIFICA una publicación real: precio, stock o estado (pausar/activar). Usar solo con confirmación explícita del usuario.
Inputs: item_id (required), stock, cuenta, estado, +1 more.
ml_auditar_publicacionesAuditar mis publicacionesARead-only
Lista las publicaciones del vendedor con un semáforo de calidad y cómo mejorar cada una: título corto o con relleno, pocas fotos, sin descripción, sin envío gratis, stock crítico, catálogo perdido, publicación pausada. Devuelve las peores primero con la acción concreta. Ideal para "¿qué publicaciones tengo que mejorar?".
Inputs: cuenta, estado, limite.
ml_borrar_clipBorrar un clipA
Borra un clip de una publicación (por ejemplo uno rechazado, para subir la versión corregida). Funciona en cualquier estado de moderación.
Inputs: item_id (required), clip_uuid (required), cuenta.
ml_buscarBuscar en MercadoLibreBRead-only
Busca publicaciones públicas en MercadoLibre (para espiar competencia y precios de mercado).
Inputs: consulta (required), sitio, cuenta, limite.
ml_clipsClips de las publicacionesARead-only
Consulta los Clips (videos verticales cortos) de tus publicaciones por la API y dice cuáles sirven: con item_id muestra cada clip y su estado de moderación (publicado ✅, en revisión ⏳ 24-48 hs, rechazado ❌ con el motivo y cómo corregirlo); sin item_id recorre tus publicaciones activas y arma el mapa de video de la tienda (clips + video clásico) con cuáles priorizar.
Inputs: cuenta, item_id.
ml_comisionesComisiones y costos de ventaARead-only
Cuánto cobra MercadoLibre por vender a un precio dado (comisión por tipo de publicación), para calcular márgenes.
Inputs: precio (required), sitio, cuenta, categoria.
ml_conectarConectar cuenta de MercadoLibreARead-only
Vincula una cuenta de MercadoLibre. Sin argumentos devuelve la URL para autorizar en el navegador; con code (el código que muestra la página al autorizar) completa la conexión. Requiere ML_APP_ID y ML_APP_SECRET configurados.
Inputs: code, sitio.
ml_crear_publicacionCrear publicaciónA
CREA una publicación real en la tienda. Con copiar_de clona una publicación existente (título, categoría, atributos, fotos, descripción) y permite pisar título/precio/stock — ideal para duplicar entre tus propias cuentas. Usar solo con confirmación explícita del usuario.
Inputs: tipo, stock, cuenta, precio, +6 more.
ml_cuentasCuentas conectadasBRead-only
Lista las cuentas de MercadoLibre conectadas (soporta varias tiendas). Con predeterminada fija cuál usar cuando no se indica cuenta.
Inputs: predeterminada.
ml_desconectarDesconectar cuentaA
Elimina los tokens guardados de una cuenta (deja de estar conectada en esta computadora).
Inputs: cuenta (required).
ml_descubrir_ganadoresDescubrir artículos ganadoresARead-only
Encuentra artículos ganadores dentro de lo que permite la API: por CATEGORÍA usa el ranking oficial de más vendidos (highlights) + las tendencias de esa categoría; por BÚSQUEDA analiza el mercado de una keyword (competencia, precios, envío gratis, vendedores que dominan y ventas visibles). Indicar categoria (id tipo MLA1234) o busqueda (keyword).
Inputs: sitio, cuenta, busqueda, categoria.
ml_enviosEnvío de una ordenBRead-only
Estado del envío de una orden: tracking, estado y fechas.
Inputs: orden_id (required), cuenta.
ml_historial_competenciaHistorial de competenciaARead-only
La base de datos de competencia: evolución en el tiempo de un objetivo vigilado — precio y ventas de una publicación rival, líder y precio líder de una búsqueda, o cantidad de publicaciones y precio mediana de un vendedor. Se alimenta sola con cada control de ml_novedades_competencia.
Inputs: ref (required).
ml_metricasMétricas de ventasARead-only
Facturación, unidades y ticket promedio de un período, comparado contra el período anterior. Ideal para "¿cómo vienen las ventas?". Con cuenta="todas" consolida todas las tiendas conectadas.
Inputs: dias, cuenta.
ml_novedades_competenciaNovedades de competencia y tendenciasARead-only
Recorre toda la lista de seguimiento y reporta SOLO lo que cambió desde la última corrida: precios que subieron/bajaron, publicaciones nuevas o dadas de baja, ventas estimadas de competidores, cambios de líder en búsquedas y keywords que entraron/salieron de tendencias. Ideal como rutina semanal.
Inputs: cuenta.
ml_ordenesÓrdenes de ventaARead-only
Lista las ventas (órdenes) del vendedor, de la más reciente a la más vieja. Filtrable por fecha y estado.
Inputs: dias, cuenta, estado, limite.
ml_panel_ventasPanel de ventasARead-only
El tablero del vendedor en una llamada: facturación de HOY y del MES, productos más vendidos del mes, reparto por método de envío (FULL/Flex/Colecta...) y dónde se concentran las ventas por provincia. Ideal para "¿cómo venimos hoy?" o el panel del mes.
Inputs: cuenta.
ml_precio_catalogoPrecio para ganar el catálogoBRead-only
Para publicaciones de catálogo: si estás ganando la buy box y qué precio necesitás para ganarla.
Inputs: item_id (required), cuenta.
ml_preguntasPreguntas de compradoresCRead-only
Preguntas de compradores; por defecto las pendientes de respuesta.
Inputs: cuenta, estado, limite.
ml_promocionesPromociones ofrecidasBRead-only
Campañas y promociones que MercadoLibre le ofrece al vendedor; con promocion_id y tipo, lista las publicaciones elegibles con su descuento.
Inputs: tipo, cuenta, promocion_id.
ml_publicacionDetalle de una publicaciónBRead-only
Detalle completo de una publicación: precio, stock, ventas, tipo, garantía, envío, link.
Inputs: item_id (required), cuenta.
ml_publicacionesMis publicacionesBRead-only
Lista las publicaciones del vendedor con precio, stock y estado.
Inputs: cuenta, estado, limite.
ml_publicidadMétricas de Product Ads en vivoARead-only
Métricas de Product Ads al momento de la consulta: con item_id, el detalle del anuncio de esa publicación (inversión, impresiones, clics, CTR, CPC, ACOS, unidades y facturación por ads); sin item_id, las campañas del anunciante con su estado, presupuesto y resultados. Parámetro dias para el período (1 = hoy, default 30).
Inputs: dias, cuenta, item_id.
ml_rentabilidadCalculadora de rentabilidad realARead-only
El desglose real peso por peso de un producto: precio de venta MENOS comisión de MercadoLibre (tarifa real del tipo de publicación) MENOS publicidad por unidad (gasto de Product Ads en vivo del período) MENOS impuestos MENOS costo de envío MENOS costo del producto = ganancia neta y margen. Pide lo que falta (costo e impuestos NUNCA se inventan) y dice hasta qué ACOS aguanta el producto.
Inputs: costo, cuenta, precio, item_id, +3 more.
ml_reputacionReputación del vendedorCRead-only
Color de reputación, ventas y tasas de reclamos, demoras y cancelaciones.
Inputs: cuenta.
ml_responder_preguntaResponder preguntaA
PUBLICA una respuesta real y visible a una pregunta de comprador. Irreversible: usar solo con el texto confirmado por el usuario.
Inputs: texto (required), pregunta_id (required), cuenta.
ml_subir_clipSubir un clipA
Sube un Clip (video vertical corto) a una publicación por la API. Requisitos de MercadoLibre: MP4/MOV/MPEG/AVI, vertical, 10 a 61 segundos, mínimo 360x640, máximo 280 MB, publicación activa. La moderación tarda 24-48 hs (verificar después con ml_clips).
Inputs: archivo (required), item_id (required), cuenta.
ml_tendenciasTendencias de búsquedaCRead-only
Las búsquedas más populares del sitio o de una categoría: qué está queriendo comprar la gente.
Inputs: sitio, cuenta, categoria.
ml_versionVersión del conectorARead-only
Muestra la versión instalada del conector, chequea si hay una actualización publicada y explica cómo actualizar.
Inputs: no named parameters.
ml_vigilarLista de seguimientoBRead-only
Administra la lista de seguimiento de competencia y tendencias (se guarda local). Tipos: vendedor (nickname o id de un competidor), publicacion (item_id ajeno o propio), busqueda (keyword para vigilar su top 10) y tendencias (sitio o categoría). Acciones: listar, agregar, quitar.
Inputs: accion (required), ref, nota, tipo, +1 more.
ml_visitasVisitas de publicacionesARead-only
Visitas de una publicación en una ventana de días, para medir tráfico y conversión.
Inputs: item_id (required), dias, cuenta.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
B3.2/5.0
Scored across 32 tools
Disambiguation4/5
Most tools have clearly distinct purposes, especially around publications, orders, promotions, ads, clips, and competition tracking. Some analytical tools (ml_panel_ventas, ml_metricas, ml_rentabilidad, ml_publicidad) and market-research tools (ml_buscar, ml_descubrir_ganadores, ml_tendencias) have adjacent scopes, but the descriptions generally distinguish them well.
Naming Consistency4/5
All tools use a consistent ml_ prefix and lower snake_case, which is easy to scan. The main deviation is that read tools are mostly noun-only (ml_ordenes, ml_publicaciones) while mutating tools use verb_noun (ml_actualizar_publicacion, ml_responder_pregunta), but this pattern is still fairly predictable.
Tool Count2/5
With 32 tools, the server is well beyond the ideal 3-15 range and exceeds the 25+ threshold for being heavy. The domain is broad, so not every tool is unjustified, but the set would benefit from consolidation or grouping.
Completeness4/5
The surface covers connection, accounts, sales, shipping, publication lifecycle, questions, promotions, ads, profitability, clips, and competition research. It is very broad, with only minor gaps such as a dedicated order-detail tool or hard-delete publication operation.
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues
Related MCP Connectors
Connect Amazon Seller Central to Claude or ChatGPT via MCP. Orders, inventory, pricing, fees, FBA.
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
Your SMB workspace in Claude or ChatGPT: tasks, notes, sales and Michèle's memory, via OAuth.
Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.
Related MCP Servers
- FlicenseAqualityCmaintenanceConnects Claude to your Amazon Seller Central account via the Selling Partner API, enabling queries for recent orders, sales summaries, FBA inventory, and financial events.4-
- FlicenseNot gradedqualityDmaintenanceConnects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.-
- AlicenseAqualityCmaintenanceEnables sellers to connect their MercadoLibre accounts to Claude AI and query consolidated multi-store sales, real profitability, stock, listings, buyer questions, claims, Product Ads, and competitor prices in natural language.33MIT