Mercado Libre Product Data

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install mercadolibre-product-data
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 mercadolibre-product-data。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Mercado Libre Product Data 为 Openclaw Skills 和 AI agent 提供了一种切实有效的方式，来调研墨西哥、巴西、阿根廷和哥伦比亚的公开电商平台商品列表。通过 Scavio 的 API，它能够为关键词和卖家搜索、单个商品、评价、买家提问以及分类热销榜返回结构化 JSON——无需您解析电商平台 HTML 或配置 Mercado Libre OAuth 凭证。
使用该技能可以比较价格、折扣、分期付款、物流和卖家详情；查看商品的 buy-box 卖家、库存、变体、规格和星级分布；或者探索客户反馈和分类需求。结果使用各个国家的货币，API 响应中包含 credit 使用情况，以便 agent 保持调研过程透明且不超预算。

应用场景

按关键词、价格、折扣、物流、分期付款、品相或官方旗舰店状态比较 Mercado Libre 或 Mercado Livre 的商品列表。
追踪商品的挂牌价格和折扣随时间的变化，或查找符合价格或折扣门槛的商品列表。
通过公开昵称或卖家 ID 浏览卖家商品目录，支持可选的搜索和商品列表筛选器。
通过 URL、目录商品 ID 或 item ID 查看商品或列表，包括其 buy-box 卖家、信誉度、库存、变体、规格和评分分布。
使用分页评价、可选的星级筛选器、翻译后的文本以及可用的原始评价文本来分析客户反馈。
查看买家提问和卖家回复，以识别常见的客户关切。
获取墨西哥、阿根廷或哥伦比亚某分类中排名前 20 的热销商品。
使用结构化商品数据研究拉美跨境电商需求、竞争对手价格、商品目录空白和市场定位。

工作原理

将 Scavio API key 配置为 SCAVIO_API_KEY，以便技能可以对请求进行身份验证。
按国家和关键词、卖家 ID 或卖家昵称进行搜索。搜索结果包括列表和商品标识符、URL、价格、折扣、显示的卖家详情以及分类信息。
将结果的 product_id、item_id 或 URL 传递给商品端点，以检索详细的列表数据，包括 buy-box 卖家、库存、变体、规格和星级分布。
通过商品 ID、item ID 或 URL 请求评价；可选择按 1–5 星评分进行筛选，并按每页 15 条评价进行分页。
使用列表 item ID 或 URL 请求买家提问。持续使用每个响应中的 next_offset，直到其变为 null。
对于支持的国家，使用匹配的分类 ID 检索该分类排名前 20 的热销商品。
在继续操作之前检查响应元数据和分页：每个响应都包含 credit 信息，且每一页都会计费。在结果中一并报告限制和数据说明。

配置指南

创建 Scavio 账号并从 Dashboard 复制 API key。新账号赠送 50 credits；无需绑定支付卡即可开始使用。
在 agent 使用的环境中导出该 key。切勿将 API key 提交到源码控制系统。
export SCAVIO_API_KEY=sk_live_your_key
请求使用 POST 发送到 https://api.scavio.dev，带 JSON 请求体和 Bearer token。例如：
curl -X POST https://api.scavio.dev/api/v1/mercadolibre/search
-H "Authorization: Bearer $SCAVIO_API_KEY"
-H "Content-Type: application/json"
-d '{"country":"mx","query":"iphone 15","free_shipping":true,"sort":"price_asc"}' 可选的 Python SDK：
pip install scavio==0.21.0
from scavio import ScavioClient
client = ScavioClient() # Reads SCAVIO_API_KEY from the environment
results = client.mercadolibre.search(
"iphone 15", country="mx", free_shipping=True, sort="price_asc"
)
可选的 Node.js SDK：
npm install scavio@0.21.0
要使用 Scavio MCP server，请在其环境配置中通过将 mercadolibre 包含在 SCAVIO_PLATFORMS 中来启用 Mercado Libre 平台。该服务器将所有五个端点作为 agent 工具暴露。有关当前配置和端点详情，请参阅 Scavio 文档。
该 API 支持墨西哥（mx）、巴西（br）、阿根廷（ar）和哥伦比亚（co）。热销榜查询适用于墨西哥、阿根廷和哥伦比亚，但不适用于巴西。没有有效 key 的请求将返回 401；credit 余额耗尽将返回 402，并在响应中附带 billing_url。
Mercado Libre Product Data 数据架构与分类体系
所有端点都返回一个包含 data、response_time、credits_used 和 credits_remaining 的响应外壳。
Endpoint Main data Pagination and cost
POST /api/v1/mercadolibre/search 搜索元数据、已应用和可用的筛选器，以及包含 ID、URL、价格、原价、折扣、分期付款、显示的卖家信息、评分、物流标记、赞助状态和分类的列表结果 每页约 48 个列表；最多 42 页；每页 2 credits
POST /api/v1/mercadolibre/product 商品或列表详情、buy-box 卖家、库存、物流、评分和星级分布、变体、规格、描述、图片和分类 无分页；2 credits
POST /api/v1/mercadolibre/reviews 评价 ID、评分、文本、可用的原始文本、翻译标记、日期、点赞数、国家和媒体 每页 15 条评价；每页 1 credit
POST /api/v1/mercadolibre/questions 列表提问和卖家回复及回复日期 使用 next_offset 继续；每页 2 credits
POST /api/v1/mercadolibre/best-sellers 包含列表样式价格和销量标签字段的分类前 20 名热销商品 无分页；2 credits；仅限墨西哥、阿根廷和哥伦比亚
标识符和国家代码： 搜索结果可以包含 item_id（列表）、product_id（可用的目录商品）、user_product_id、url 和 category_id。国家代码为 mx、br、ar 和 co。商品 ID 和 URL 也会标识其电商平台；热销榜分类前缀必须与请求的国家相匹配（墨西哥为 MLM，阿根廷为 MLA，哥伦比亚为 MCO）。
搜索字段： 搜索接受国家以及 query、seller_id 或 seller_nickname 中的至少一个。可选筛选器包括品相、最低和最高价格、最低折扣、包邮、Full 履约、官方旗舰店和无息分期付款。排序选项有相关性、价格升序和价格降序。
重要数据说明： 价格使用该市场的货币（MXN、BRL、ARS 或 COP）。sold_quantity_min 是一个下限，不是确切的销量计数。搜索卡片中可能缺少卖家信息，而商品详情仅报告 buy-box 卖家——而不是提供该商品的所有卖家。搜索涵盖每个查询约 2,000 个结果；使用价格区间或其他筛选器来分段更大的搜索，并通过 item_id 进行去重。Mercado Libre 可能会自动应用搜索筛选器，这些筛选器会在 auto_applied_filters 中返回。评价文本可能会被翻译；在可用时请参考 original_text、translated 和国家字段。

高级特性

五个专注的端点：
通过单个 API 集成搜索列表、查看商品、检索评价、读取买家提问与回复以及获取分类热销榜。
卖家目录发现：
通过公开卖家昵称搜索以获取卖家 ID，然后使用该 ID 筛选、排序和分页浏览目录列表。
实用的电商平台筛选器：
按价格、折扣、品相、物流、Full 履约、官方旗舰店状态和无息分期付款缩小搜索范围。
评价和提问分页：
按星级评分筛选评价，并使用 API 的
next_offset
游标对提问进行分页。
Agent 和 MCP 支持：
Scavio 的 MCP server 将五个端点暴露为工具：
search_mercadolibre
、
get_mercadolibre_product
、
get_mercadolibre_reviews
、
get_mercadolibre_questions
get_mercadolibre_best_sellers
。Mercado Libre 可通过
SCAVIO_PLATFORMS
选择性启用。
SDK 选项：
使用 Scavio Python 或 Node.js SDK，或直接发起带身份验证的 JSON POST 请求。
预算感知工作流：
调用会报告已用和剩余 credits。搜索和评价页面按页单独计费，因此在分页或进行大规模调研前请预估成本。
可靠的异常处理：
响应修正无效参数，检查 API key 以应对
，补充 credits 以应对
，并在重试
或临时
/
错误前稍作等待。切勿将下限销量标签视为确切计数，也不要推断缺失的列表数据。

name: mercadolibre-product-data description: Mercado Libre product data as structured JSON for Mexico, Brazil (Mercado Livre), Argentina and Colombia - keyword or seller search with price, discount, installments, shipping and sponsored flags, one product with the buy-box seller and star distribution, product reviews, buyer questions with seller answers, and the top 20 best sellers in a category. 5 endpoints, 1-2 credits each. version: 1.0.0
tags: mercado-libre, mercadolibre, mercado-livre, mercadolivre, mercado-libre-api, mercadolibre-api, mercado-livre-api, latam-ecommerce, mexico, brazil, argentina, colombia, product-data, product-search, price-monitoring, competitor-prices, seller-catalog, product-reviews, product-questions, best-sellers, ecommerce, retail, structured-data, json, ai-agents, mcp