内容
# MercadoLibre 连接工具
**为 AI 代理连接 MercadoLibre 市场。**
[](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp)
[](https://github.com/dan1d/mercadolibre-mcp/actions)
[](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp)
[](./LICENSE)
连接 AI 代理到 [MercadoLibre](https://www.mercadolibre.com)，拉丁美洲最大的电子商务市场（1.5亿+用户）。搜索产品、获取商品详情、浏览类别、跟踪趋势，并在阿根廷、巴西、墨西哥、智利、哥伦比亚等国家进行货币兑换。
[npm](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp) | [GitHub](https://github.com/dan1d/mercadolibre-mcp)
---
## 快速开始
公共端点（搜索、商品、类别、趋势）不需要 API 密钥。
### Claude 桌面版
在您的 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}
```
### Claude 代码
```bash
claude mcp add mercadolibre -- npx -y @dan1d/mercadolibre-mcp
```
### Cursor
在 `.cursor/mcp.json` 中添加：
```json
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}
```
### Windsurf
```json
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}
```
### 带有身份验证（可选）
对于需要身份验证的端点（未来的高级功能），请添加您的访问令牌：
```json
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"],
"env": {
"MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..."
}
}
}
}
```
> 配置完成后，询问您的 AI 助手类似问题： *"在 MercadoLibre 上搜索 iPhone 15"* 或 *"阿根廷当前的热门搜索是什么？"* 或 *"显示我商品 MLA1234567890 的详情"*
---
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `search_items` | 按关键词搜索产品。根据类别、价格范围和站点（MLA=阿根廷，MLB=巴西，MLM=墨西哥，MLC=智利，MCO=哥伦比亚）进行筛选。 |
| `get_item` | 获取完整商品详情：标题、价格、图片、卖家、条件、库存等。 |
| `get_item_description` | 获取商品的完整文本描述。 |
| `get_categories` | 列出 MercadoLibre 站点的所有顶级类别。 |
| `get_category` | 获取类别详情，包括名称、路径和子类别。 |
| `get_seller_info` | 获取卖家资料：声誉、评分和交易统计。 |
| `get_trends` | 获取特定站点/国家的当前热门搜索。 |
| `get_currency_conversion` | 使用 MercadoLibre 汇率（ARS、BRL、MXN、USD 等）进行货币兑换。 |
---
## 支持的站点
| 站点 ID | 国家 |
|---------|---------|
| `MLA` | 阿根廷 |
| `MLB` | 巴西 |
| `MLM` | 墨西哥 |
| `MLC` | 智利 |
| `MCO` | 哥伦比亚 |
| `MLU` | 乌拉圭 |
| `MPE` | 秘鲁 |
| `MEC` | 厄瓜多尔 |
| `MCR` | 哥斯达黎加 |
| `MPA` | 巴拿马 |
| `MLV` | 委内瑞拉 |
| `MRD` | 多米尼加共和国 |
| `MHN` | 洪都拉斯 |
| `MBO` | 玻利维亚 |
| `MNI` | 尼加拉瓜 |
| `MPY` | 巴拉圭 |
| `MSV` | 萨尔瓦多 |
| `MGT` | 危地马拉 |
---
## 示例提示
- "在阿根廷搜索价格低于 $500000 的 PlayStation 5"
- "显示我商品 MLA1405857684 的详情"
- "巴西当前的热门搜索是什么？"
- "列出 MercadoLibre 墨西哥的所有类别"
- "显示卖家 123456789 的声誉"
- "将 100 美元兑换成 ARS"
---
## 编程用法
```bash
npm install @dan1d/mercadolibre-mcp
```
```typescript
import { createMercadoLibreTools } from "@dan1d/mercadolibre-mcp";
const ml = createMercadoLibreTools();
// 搜索产品
const results = await ml.tools.search_items({
query: "iPhone 15",
site_id: "MLA",
price_max: 2000000,
limit: 5,
});
// 获取商品详情
const item = await ml.tools.get_item({ item_id: "MLA1405857684" });
// 获取阿根廷的热门搜索
const trends = await ml.tools.get_trends({ site_id: "MLA" });
// 浏览类别
const categories = await ml.tools.get_categories({ site_id: "MLA" });
// 获取卖家声誉
const seller = await ml.tools.get_seller_info({ seller_id: 123456789 });
// 货币兑换
const conversion = await ml.tools.get_currency_conversion({
from: "USD",
to: "BRL",
amount: 100,
});
```
---
## LATAM 连接工具包的一部分
| 服务器 | 功能 |
|--------|-------------|
| [CobroYa](https://github.com/dan1d/mercadopago-tool) | Mercado Pago 支付 — 创建链接、搜索支付、退款 |
| **MercadoLibre 连接工具** | MercadoLibre 市场 — 搜索产品、类别、趋势 |
| [DolarAPI 连接工具](https://github.com/dan1d/dolar-mcp) | 阿根廷汇率 — 蓝色、官方、CCL、加密货币、兑换 |
---
## 许可证
[MIT](./LICENSE) -- by [dan1d](https://dan1d.dev/)
