Mercado Libre Product Research
Mercado Product Selection MCP
Research Mercado Libre products, sellers, and keywords across five markets. Call the Mercado Product Selection API via REST or MCP with your Nexscope API key.
Mercado Product Selection AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Inspect A Mercado Product
Prompt: Look up Mercado Libre item [item ID] in [selected market] and show the available product facts. Identify missing information instead of inventing results.
2. Review Product History
Prompt: Retrieve the available history for Mercado Libre item [item ID] in [selected market], preserving reporting dates. Identify missing information instead of inventing results.
3. Find Mercado Products
Prompt: Search Mercado Libre products for [product phrase] in [selected market] and show the returned matches. Identify missing information instead of inventing results.
4. Inspect A Catalog Product
Prompt: Look up Mercado Libre catalog product [catalog product ID] in [selected market] and summarize the available details. Identify missing information instead of inventing results.
5. Review Catalog Product History
Prompt: Retrieve history for Mercado Libre catalog product [catalog product ID] in [selected market], retaining observation dates. Identify missing information instead of inventing results.
6. Find Catalog Products
Prompt: Search Mercado Libre catalog products for [product phrase] in [selected market]. Identify missing information instead of inventing results.
7. Find Daily Search Keywords
Prompt: Show Mercado Libre search keywords for [selected market] on [selected date]. Identify missing information instead of inventing results.
8. Find Monthly Search Keywords
Prompt: Show Mercado Libre search keywords for [selected market] in [selected month]. Identify missing information instead of inventing results.
9. Find Product Traffic Keywords
Prompt: Find search keywords associated with [my selected Mercado Libre product]. Identify missing information instead of inventing results.
10. Find Mercado Categories
Prompt: Find Mercado Libre categories matching [category phrase] in [selected market]. Identify missing information instead of inventing results.
11. Find Detailed Mercado Categories
Prompt: Find detailed Mercado Libre categories matching [category phrase] in [selected market]. Identify missing information instead of inventing results.
12. Review Leading Category Brands
Prompt: Show the returned leading brands in Mercado Libre category [category ID] for [selected market and period]. Identify missing information instead of inventing results.
13. Review Leading Category Products
Prompt: Show the returned leading products in Mercado Libre category [category ID] for [selected market and period]. Identify missing information instead of inventing results.
14. Review Leading Category Sellers
Prompt: Show the returned leading sellers in Mercado Libre category [category ID] for [selected market and period]. Identify missing information instead of inventing results.
15. Find New Category Products
Prompt: Show newly listed products in Mercado Libre category [category ID] for [selected market and period]. Identify missing information instead of inventing results.
16. Review Category Prices
Prompt: Show the available price distribution for Mercado Libre category [category ID] in [selected market and period]. Identify missing information instead of inventing results.
17. Review Category Sales
Prompt: Show the available sales distribution for Mercado Libre category [category ID] in [selected market and period]. Identify missing information instead of inventing results.
18. Review Category Sales History
Prompt: Show sales history for Mercado Libre category [category ID] in [selected market], preserving the returned periods. Identify missing information instead of inventing results.
19. Summarize A Mercado Category
Prompt: Show the available summary statistics for Mercado Libre category [category ID] in [selected market and period]. Identify missing information instead of inventing results.
20. Review Category Warehouse Distribution
Prompt: Show the available warehouse or inventory-type distribution for Mercado Libre category [category ID] in [selected market and period]. Identify missing information instead of inventing results.
21. Find Mercado Sellers
Prompt: Find Mercado Libre sellers matching [seller search phrase] in [selected market]. Identify missing information instead of inventing results.
22. Read Mercado Product Reviews
Prompt: Retrieve reviews for Mercado Libre item [item ID] and summarize only the returned review sample. Identify missing information instead of inventing results.
23. Check Available Exchange Rates
Prompt: Show the returned exchange-rate information, including its currencies and reporting date when available. Identify missing information instead of inventing results.
24. Check Research Usage
Prompt: Show my current research plan usage without starting another research query. Identify missing information instead of inventing results.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Operation names are documented, but full per-operation argument definitions are incomplete. Confirm the required inputs for the selected operation before submitting a request.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_mercado_product_selectionhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "mercado-product-selection-1",
"method": "tools/call",
"params": {
"name": "nexscope_mercado_product_selection",
"arguments": {
"arguments": {
"searchText": "Auriculares",
"siteId": "MLM"
},
"toolName": "categorySearch"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
toolName | string | required | Exact Mercado tool name. Example: categorySearch |
arguments | object | required | Arguments for the selected tool. Example: {
"searchText": "Auriculares",
"siteId": "MLM"
} |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | Nexscope encapsulation layer status; `"200"` on success. May be omitted in case of business error. |
msg | string | optional | Encapsulation layer message; `"ok"` on success. |
errcode | integer | optional | Gateway status code; if successful, it is `200`, if there is a business error, it is non-`200`. |
errmsg | string | optional | Gateway error or status message. |
type | string | optional | Currently usually `rawMcpToolResult`. |
toolName | string | optional | The name of the tool actually called. |
charged | boolean | optional | Is there a fee for this tool? |
data | string/object/array | optional | Business data unpacked from the MCP text content; most tools return a string. |
rawResponse | object | optional | MCP `tools/call` Raw result; the current gateway usually returns an empty object. |
contentText | string | optional | MCP text content The spliced original text. |
textParsedAsJson | boolean | optional | Whether `contentText` is successfully parsed into JSON; it may also be `true` when the text is wrapped in a JSON string. |
total | integer | optional | Returned when the number of records can be inferred by the backend; omitted when it cannot be inferred, and `null` is not returned. |
costToken | integer | optional | The token cost of this call; the free tool is `0`, and the paid tool is currently `16000`. |
costTime | integer | optional | The backend takes time in milliseconds. |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find Mercado Products for the inputs in this documentation sample.
Example Answer
In the published sample, its reported tool name is itemSearch. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"toolName": "itemSearch",
"arguments": {
"siteId": "MLB",
"title": "bengalas vstrom",
"pageNo": 1,
"pageSize": 50
}
}Response
{
"code": 0,
"msg": null,
"data": {
"data": "=== 搜索结果概览 ===\n总记录数:4\n当前页码:1\n每页条数:50\n查询耗时:18 ms\n\n--- 商品 1 ---\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\n商品ID:MLB4332260689\n商品状态:closed\n商品售价:3499.99 BRL\n原价:3499.99\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-11-27T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-2015-a-2021-_JM\n物流方式:me2\n健康分:0.00\n7天销量:1\n7天销售额:3499.99\n30天销量:1\n30天销售额:3499.99\n总访问量:34\n平均转化率:2.94%\n90天销量:1\n90天销售额:3499.99\n库存:0\n店铺名称:CONCEITOMOTOPARTS01\n店铺类型:LOCAL\n评分:0.0 星\n评价数:0\n\n--- 商品 2 ---\n商品名称:Par Bengalas Suzuki V-strom 1000 Vstrom Ano 14-17\n商品ID:MLB6100216566\n商品状态:paused\n商品售价:4488.9 BRL\n原价:4488.9\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-12-26T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-6100216566-par-bengalas-suzuki-v-strom-1000-vstrom-ano-14-17-_JM\n物流方式:me2\n健康分:0.00\n7天销量:1\n7天销售额:4488.9\n30天销量:1\n30天销售额:4488.9\n总访问量:9\n平均转化率:11.11%\n90天销量:1\n90天销售额:4488.9\n库存:0\n店铺名称:RAFA MOTOPEÇASS\n店铺注册时间:2014-07-30T19:58:06\n店铺类型:LOCAL\n评分:0.0 星\n评价数:0\n\n--- 商品 3 ---\n商品名称:Bengalas Suzuki Vstrom 1000 2008\n商品中文名称: 2008款铃木V-Strom 1000摩托车\n商品ID:MLB3959869539\n商品状态:closed\n商品售价:1500.0 BRL\n原价:1500.0\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-01-24T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-3959869539-bengalas-suzuki-vstrom-1000-2008-_JM\n物流方式:me2\n健康分:-100.00\n7天销量:0\n7天销售额:0.0\n30天销量:0\n30天销售额:0.0\n90天销量:1\n90天销售额:1500.0\n库存:0\n店铺名称:PLANETAMOTOSBRASIL\n店铺注册时间:2015-07-24T10:44:36\n店铺类型:LOCAL\n\n--- 商品 4 ---\n商品名称:Bengalas Suzuki Vstrom 1000 2018\n商品中文名称: 2018款铃木V-Strom 1000摩托车\n商品ID:MLB4002858897\n商品状态:closed\n商品售价:2999.0 BRL\n原价:2999.0\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-03-14T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-4002858897-bengalas-suzuki-vstrom-1000-2018-_JM\n物流方式:me2\n健康分:-100.00\n7天销量:0\n7天销售额:0.0\n30天销量:0\n30天销售额:0.0\n90天销量:1\n90天销售额:2999.0\n库存:0\n店铺名称:OHANNASMOTOPARTS\n店铺注册时间:2009-12-22T21:51:20\n店铺类型:LOCAL\n\n",
"rawResponse": {},
"contentText": "\"=== 搜索结果概览 ===\\n总记录数:4\\n当前页码:1\\n每页条数:50\\n查询耗时:18 ms\\n\\n--- 商品 1 ---\\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\\n商品ID:MLB4332260689\\n商品状态:closed\\n商品售价:3499.99 BRL\\n原价:3499.99\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-11-27T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-2015-a-2021-_JM\\n物流方式:me2\\n健康分:0.00\\n7天销量:1\\n7天销售额:3499.99\\n30天销量:1\\n30天销售额:3499.99\\n总访问量:34\\n平均转化率:2.94%\\n90天销量:1\\n90天销售额:3499.99\\n库存:0\\n店铺名称:CONCEITOMOTOPARTS01\\n店铺类型:LOCAL\\n评分:0.0 星\\n评价数:0\\n\\n--- 商品 2 ---\\n商品名称:Par Bengalas Suzuki V-strom 1000 Vstrom Ano 14-17\\n商品ID:MLB6100216566\\n商品状态:paused\\n商品售价:4488.9 BRL\\n原价:4488.9\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-12-26T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-6100216566-par-bengalas-suzuki-v-strom-1000-vstrom-ano-14-17-_JM\\n物流方式:me2\\n健康分:0.00\\n7天销量:1\\n7天销售额:4488.9\\n30天销量:1\\n30天销售额:4488.9\\n总访问量:9\\n平均转化率:11.11%\\n90天销量:1\\n90天销售额:4488.9\\n库存:0\\n店铺名称:RAFA MOTOPEÇASS\\n店铺注册时间:2014-07-30T19:58:06\\n店铺类型:LOCAL\\n评分:0.0 星\\n评价数:0\\n\\n--- 商品 3 ---\\n商品名称:Bengalas Suzuki Vstrom 1000 2008\\n商品中文名称: 2008款铃木V-Strom 1000摩托车\\n商品ID:MLB3959869539\\n商品状态:closed\\n商品售价:1500.0 BRL\\n原价:1500.0\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-01-24T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-3959869539-bengalas-suzuki-vstrom-1000-2008-_JM\\n物流方式:me2\\n健康分:-100.00\\n7天销量:0\\n7天销售额:0.0\\n30天销量:0\\n30天销售额:0.0\\n90天销量:1\\n90天销售额:1500.0\\n库存:0\\n店铺名称:PLANETAMOTOSBRASIL\\n店铺注册时间:2015-07-24T10:44:36\\n店铺类型:LOCAL\\n\\n--- 商品 4 ---\\n商品名称:Bengalas Suzuki Vstrom 1000 2018\\n商品中文名称: 2018款铃木V-Strom 1000摩托车\\n商品ID:MLB4002858897\\n商品状态:closed\\n商品售价:2999.0 BRL\\n原价:2999.0\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-03-14T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4002858897-bengalas-suzuki-vstrom-1000-2018-_JM\\n物流方式:me2\\n健康分:-100.00\\n7天销量:0\\n7天销售额:0.0\\n30天销量:0\\n30天销售额:0.0\\n90天销量:1\\n90天销售额:2999.0\\n库存:0\\n店铺名称:OHANNASMOTOPARTS\\n店铺注册时间:2009-12-22T21:51:20\\n店铺类型:LOCAL\\n\\n\"",
"type": "rawMcpToolResult",
"costTime": 685,
"charged": true,
"textParsedAsJson": true,
"toolName": "itemSearch"
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "mercado-product-selection-example",
"method": "tools/call",
"params": {
"name": "nexscope_mercado_product_selection",
"arguments": {
"toolName": "itemSearch",
"arguments": {
"siteId": "MLB",
"title": "bengalas vstrom",
"pageNo": 1,
"pageSize": 50
}
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "mercado-product-selection-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":\"=== 搜索结果概览 ===\\n总记录数:4\\n当前页码:1\\n每页条数:50\\n查询耗时:18 ms\\n\\n--- 商品 1 ---\\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\\n商品ID:MLB4332260689\\n商品状态:closed\\n商品售价:3499.99 BRL\\n原价:3499.99\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-11-27T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-20…\",\"rawResponse\":{},\"contentText\":\"\\\"=== 搜索结果概览 ===\\\\n总记录数:4\\\\n当前页码:1\\\\n每页条数:50\\\\n查询耗时:18 ms\\\\n\\\\n--- 商品 1 ---\\\\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\\\\n商品ID:MLB4332260689\\\\n商品状态:closed\\\\n商品售价:3499.99 BRL\\\\n原价:3499.99\\\\n总销量:1\\\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\\\n上架时间:2025-11-27T00:00:00\\\\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuk…\",\"textParsedAsJson\":true,\"toolName\":\"itemSearch\"}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": "=== 搜索结果概览 ===\n总记录数:4\n当前页码:1\n每页条数:50\n查询耗时:18 ms\n\n--- 商品 1 ---\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\n商品ID:MLB4332260689\n商品状态:closed\n商品售价:3499.99 BRL\n原价:3499.99\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-11-27T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-20…",
"rawResponse": {},
"contentText": "\"=== 搜索结果概览 ===\\n总记录数:4\\n当前页码:1\\n每页条数:50\\n查询耗时:18 ms\\n\\n--- 商品 1 ---\\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\\n商品ID:MLB4332260689\\n商品状态:closed\\n商品售价:3499.99 BRL\\n原价:3499.99\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-11-27T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuk…",
"textParsedAsJson": true,
"toolName": "itemSearch"
}
},
"isError": false
}
}