AI导哈

AI代理电商市场连接服务

MercadoLibre MCP是一个连接AI代理与拉丁美洲最大电商平台MercadoLibre的服务，支持产品搜索、商品详情获取、分类浏览、趋势追踪和货币兑换等功能。

  • by dan1d
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 dan1d/mercadolibre-mcp

使用说明

mercadolibre-mcp

MercadoLibre marketplace for AI agents.

MCP server that connects AI agents to MercadoLibre, the largest e-commerce marketplace in Latin America (150M+ users). Search products, get item details, browse categories, track trends, and convert currencies across Argentina, Brazil, Mexico, Chile, Colombia, and more.

npm | GitHub

Quick Start

An access token is required. MercadoLibre now gates almost every endpoint behind an app token (search, items, categories list, sellers, trends, currency conversion return 403/401 anonymously; only get_category works without one). Create a free application at developers.mercadolibre.com and use its access token as MERCADOLIBRE_ACCESS_TOKEN in every config below.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"],
      "env": { "MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..." }
    }
  }
}

Claude Code

claude mcp add mercadolibre -e MERCADOLIBRE_ACCESS_TOKEN=APP_USR-... -- npx -y @dan1d/mercadolibre-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"],
      "env": { "MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..." }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"],
      "env": { "MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..." }
    }
  }
}

With authentication (required for all tools except get_category)

Add your access token to the env block (the Claude Desktop / Cursor / Windsurf snippets above need the same env):

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"],
      "env": {
        "MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..."
      }
    }
  }
}

Once configured, ask your AI assistant things like: "Search for iPhone 15 on MercadoLibre" or "What are the trending searches in Argentina?" or "Show me details for item MLA1234567890"

Available Tools

Tool Description
search_items Search products by keyword. Filter by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, MLC=Chile, MCO=Colombia).
get_item Get full item details: title, price, pictures, seller, condition, stock, and more.
get_item_description Get the full text description of an item.
get_categories List all top-level categories for a MercadoLibre site.
get_category Get category details including name, path from root, and children.
get_seller_info Get seller profile: reputation, ratings, and transaction stats.
get_trends Get current trending searches for a specific site/country.
get_currency_conversion Convert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.).

Supported Sites

Site ID Country
MLA Argentina
MLB Brazil
MLM Mexico
MLC Chile
MCO Colombia
MLU Uruguay
MPE Peru
MEC Ecuador
MCR Costa Rica
MPA Panama
MLV Venezuela
MRD Dominican Republic
MHN Honduras
MBO Bolivia
MNI Nicaragua
MPY Paraguay
MSV El Salvador
MGT Guatemala

Example Prompts

  • "Search for PlayStation 5 under $500000 in Argentina"
  • "Show me the details of item MLA1405857684"
  • "What are the trending searches in Brazil?"
  • "List all categories on MercadoLibre Mexico"
  • "Show me the reputation of seller 123456789"
  • "Convert 100 USD to ARS"

Programmatic Usage

npm install @dan1d/mercadolibre-mcp

import { createMercadoLibreTools } from "@dan1d/mercadolibre-mcp";

const ml = createMercadoLibreTools();

// Search products
const results = await ml.tools.search_items({
  query: "iPhone 15",
  site_id: "MLA",
  price_max: 2000000,
  limit: 5,
});

// Get item details
const item = await ml.tools.get_item({ item_id: "MLA1405857684" });

// Get trending searches in Argentina
const trends = await ml.tools.get_trends({ site_id: "MLA" });

// Browse categories
const categories = await ml.tools.get_categories({ site_id: "MLA" });

// Get seller reputation
const seller = await ml.tools.get_seller_info({ seller_id: 123456789 });

// Convert currencies
const conversion = await ml.tools.get_currency_conversion({
  from: "USD",
  to: "BRL",
  amount: 100,
});

Part of the LATAM MCP Toolkit

Server What it does
CobroYa Mercado Pago payments — create links, search payments, refunds
MercadoLibre MCP MercadoLibre marketplace — search products, categories, trends
DolarAPI MCP Argentine exchange rates — blue, oficial, CCL, crypto, conversion

License

MIT -- by dan1d

相关 MCP