{"_id":"@nahuelalbornoz/mercadolibre-mcp-read","name":"@nahuelalbornoz/mercadolibre-mcp-read","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@nahuelalbornoz/mercadolibre-mcp-read","version":"1.0.0","description":"MCP server read-only para Mercado Libre — 7 tools de análisis y consulta de seller operations (productos, órdenes, preguntas, métricas, reputación, competencia, categorías).","license":"MIT","type":"module","main":"dist/index.js","bin":{"mercadolibre-mcp-read":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^25.6.0","tsx":"^4.19.0","typescript":"^5.7.0"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","mercadolibre","mercado-libre","mercadolivre","ecommerce","seller","latam","claude","anthropic","ai","agent","read-only"],"author":{"name":"TRAID Agency","email":"contacto@traid.agency"},"repository":{"type":"git","url":"git+https://github.com/MarcosNahuel/mercadolibre-mcp-read.git"},"bugs":{"url":"https://github.com/MarcosNahuel/mercadolibre-mcp-read/issues"},"homepage":"https://github.com/MarcosNahuel/mercadolibre-mcp-read#readme","_id":"@nahuelalbornoz/mercadolibre-mcp-read@1.0.0","gitHead":"2ac7745043ec6ff6d1be7b32f8181ad4155bac8e","types":"./dist/index.d.ts","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-oO5FVi3YOPy1PZ1w9sA1UOM5NB0AqH9bLC6Bdb1aua46A7BdXhm56XzD1DNUXi9ZZH9F/N7RROWpmDKha5SKew==","shasum":"8987487840c77caf513a09a3621aa222c0044800","tarball":"https://registry.npmjs.org/@nahuelalbornoz/mercadolibre-mcp-read/-/mercadolibre-mcp-read-1.0.0.tgz","fileCount":37,"unpackedSize":67153,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIE5f9tGgRDxKcN/M3T60aDsDg+hMVDisdo21728i7raoAiAQSvDFGi1AlmGlYc//iYPHXTrRXaySs44FZBJ6rJmDkQ=="}]},"_npmUser":{"name":"nahuelalbornoz","email":"nahuelcontador@gmail.com"},"directories":{},"maintainers":[{"name":"nahuelalbornoz","email":"nahuelcontador@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mercadolibre-mcp-read_1.0.0_1776529669573_0.6344191698825661"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-18T16:27:49.457Z","1.0.0":"2026-04-18T16:27:49.705Z","modified":"2026-04-18T16:27:49.982Z"},"maintainers":[{"name":"nahuelalbornoz","email":"nahuelcontador@gmail.com"}],"description":"MCP server read-only para Mercado Libre — 7 tools de análisis y consulta de seller operations (productos, órdenes, preguntas, métricas, reputación, competencia, categorías).","homepage":"https://github.com/MarcosNahuel/mercadolibre-mcp-read#readme","keywords":["mcp","model-context-protocol","mercadolibre","mercado-libre","mercadolivre","ecommerce","seller","latam","claude","anthropic","ai","agent","read-only"],"repository":{"type":"git","url":"git+https://github.com/MarcosNahuel/mercadolibre-mcp-read.git"},"author":{"name":"TRAID Agency","email":"contacto@traid.agency"},"bugs":{"url":"https://github.com/MarcosNahuel/mercadolibre-mcp-read/issues"},"license":"MIT","readme":"# @traid/mercadolibre-mcp-read\n\n> MCP server **read-only** para Mercado Libre. 7 tools de consulta y análisis, sin riesgo de modificar tu tienda.\n\n[![npm version](https://badge.fury.io/js/@traid%2Fmercadolibre-mcp-read.svg)](https://www.npmjs.com/package/@traid/mercadolibre-mcp-read)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nHecho por [TRAID Agency](https://traid.agency) — parte del ecosistema [GlobalStats](https://globalstats-traid.vercel.app).\n\n## ¿Por qué read-only?\n\nEste paquete expone **solo operaciones de lectura** para análisis, reporting, exploración de catálogo y consulta de competencia. Ideal para:\n\n- Dashboards de BI conectados a Mercado Libre\n- Agentes que generan reportes sobre ventas, reputación o preguntas\n- Investigación de mercado / análisis de competencia\n- Integraciones en IDEs agénticos (Claude Code, Cursor, Continue)\n\n**Si necesitás modificar la tienda** (actualizar precio, responder preguntas, gestionar ads), usá la versión completa comercial `@traid/mercadolibre-mcp` — contactar a TRAID Agency.\n\n## Tools incluidas\n\n| Tool | Qué hace |\n|------|----------|\n| `list_products` | Lista las publicaciones de un vendedor |\n| `get_orders` | Obtiene órdenes/ventas con detalle (ítems, comprador, envío) |\n| `list_questions` | Lista preguntas recibidas (filtros: item, estado) |\n| `get_item_metrics` | Métricas de una publicación: visitas, conversión, health score |\n| `get_reputation` | Reputación del vendedor y nivel MercadoLíder |\n| `search_competitors` | Busca productos de la competencia por keyword |\n| `get_categories` | Categorías y atributos oficiales de ML (para publicar) |\n\n## Instalación\n\n### Desde npm\n\n```bash\nnpm install -g @traid/mercadolibre-mcp-read\n```\n\n### Desde este repo\n\n```bash\ngit clone https://github.com/MarcosNahuel/mercadolibre-mcp-read\ncd mercadolibre-mcp-read\nnpm install\nnpm run build\n```\n\n## Configuración\n\nSoporta dos modos de autenticación OAuth2:\n\n### Opción A: Token directo (recomendado si renovás el token externo)\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@traid/mercadolibre-mcp-read\"],\n      \"env\": {\n        \"ML_ACCESS_TOKEN\": \"APP_USR-...\",\n        \"ML_SITE_ID\": \"MLA\"\n      }\n    }\n  }\n}\n```\n\n### Opción B: Auto-refresh (sin dependencias externas)\n\n1. Crear app en [developers.mercadolibre.com](https://developers.mercadolibre.com)\n2. Autorizar vía OAuth y guardar `CLIENT_ID`, `CLIENT_SECRET`, `REFRESH_TOKEN`\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@traid/mercadolibre-mcp-read\"],\n      \"env\": {\n        \"ML_CLIENT_ID\": \"...\",\n        \"ML_CLIENT_SECRET\": \"...\",\n        \"ML_REFRESH_TOKEN\": \"...\",\n        \"ML_SITE_ID\": \"MLA\"\n      }\n    }\n  }\n}\n```\n\nEl site_id para Argentina es `MLA`; para México `MLM`; para Brasil `MLB`. Ver [lista completa](https://developers.mercadolibre.com.ar/en_us/standard-countries).\n\n## Uso desde Claude Code\n\n1. Agregá el bloque `mcpServers` de arriba a `.mcp.json` o `claude.json`\n2. Reiniciá Claude Code\n3. Pedile: \"listá mis últimas 10 órdenes\" o \"cuántas preguntas sin responder tengo\"\n\n## Uso desde Cursor / Continue / otros clientes MCP\n\nCualquier cliente que respete el estándar [Model Context Protocol](https://modelcontextprotocol.io/) puede usar este server. Configurar el JSON equivalente en la config del cliente.\n\n## Ejemplos de uso\n\n```\nUser: ¿cuál es mi publicación más visitada del último mes?\nAgent: [llama list_products → identifica el más exitoso por visitas → llama get_item_metrics]\n→ Tu publicación MLA123456 (Cortinas Blackout Gris) tuvo 12,000 visitas con 3.2% de conversión...\n\nUser: ¿qué está vendiendo más mi competencia en cortinas?\nAgent: [llama search_competitors con keyword \"cortinas blackout\"]\n→ Los 5 productos top de competidores son...\n```\n\n## Limitaciones conocidas\n\n- La API de Mercado Libre cambió en 2025 y algunos endpoints públicos (ej: `/sites/MLA/search` sin auth) tienen restricciones nuevas. Este MCP usa endpoints autenticados para evitar esos problemas.\n- No soporta webhooks — para eventos en tiempo real, usar directamente la API oficial.\n- Rate limits están sujetos a los de Mercado Libre (6,000 req/hora por app por default).\n\n## Upgrade path a la versión completa\n\nCuando necesites escribir a MercadoLibre (responder preguntas automáticamente, actualizar precios, gestionar Product Ads), la versión comercial `@traid/mercadolibre-mcp` agrega:\n\n- `answer_question` — respuesta automática con guardrails\n- `update_price` — cambio de precio con historial y rollback\n- `update_stock` — sincronización de stock\n- `manage_ads` — activar/pausar Product Ads con policy\n- Observabilidad completa: logs estructurados, métricas, audit trail\n- Soporte comercial y SLA\n\nContactar: [contacto@traid.agency](mailto:contacto@traid.agency)\n\n## Licencia\n\nMIT © 2026 TRAID Agency\n\n## Contribuir\n\nIssues y PRs bienvenidos en [github.com/MarcosNahuel/mercadolibre-mcp-read](https://github.com/MarcosNahuel/mercadolibre-mcp-read).\n\n## Related\n\n- [@traid/mercadolibre-mcp](https://github.com/MarcosNahuel/mercadolibre-mcp) — versión completa comercial (11 tools con write-back)\n- [GlobalStats](https://github.com/MarcosNahuel/globalstats) — dashboard operativo para sellers LATAM que usa este MCP\n- [Model Context Protocol](https://modelcontextprotocol.io/) — especificación del protocolo\n- [Claude Agent Skills](https://agentskills.io/) — estándar interoperable de Skills para agentes\n","readmeFilename":"README.md","_rev":"1-33f066123f26ea38f368ca09e7107f68"}