摘要：美客多作为拉美主流跨境电商平台，在跨境 ERP 开发、竞品情报监控、选品数据分析、批量刊登素材采集场景下，经常需要获取商品结构化数据。依靠网页手动复制信息效率低下，很难完成多站点批量处理、变体解析、行情统计。本文从工程实战角度，围绕mercadolibre.item_get商品详情接口，讲解接口参数、返回结构、业务处理流程、Python 调用示例以及拉美项目开发踩坑，为拉美跨境系统开发提供实践参考。
一、业务背景
开发美客多相关跨境工具时，会面临下面这些现实问题：
- 平台站点众多，MLM 墨西哥、MLB 巴西、MLA 阿根廷、MLC 智利，各站点语言、货币、类目体系相互独立；
- 大量商品存在多变体，不同 SKU 拥有独立价格、图片、库存，人工整理很容易出现规格遗漏错乱；
- 做竞品分析需要批量抓取标题、价格、评分、销量数据，人工浏览页面无法形成历史快照；
- 批量刊登业务需要采集源商品素材，原始接口返回数据不能直接发布，需要做图片、语种、类目预处理；
- 公开接口返回库存属于参考区间，并非真实精确库存，直接使用会带来业务风险。
mercadolibre.item_get美客多商品详情API，可以传入item_id与站点编码，输出完整结构化商品数据，作为 ERP、选品、监控系统的数据来源。
二、接口基础说明
- 接口标识：mercadolibre.item_get（美客多商品详情 API，taobaoapi2014移步获取）
- 请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
- 请求方式：GET / POST
- 请求入参：
- 返回内容：商品标题、图集、描述、类目、品牌、规格属性、评分销量、履约模式、卖家信息、variants 变体数组。
适用业务场景：
- 跨境 ERP 素材采集，为批量刊登提供原始素材
- 竞品价格、口碑常态化监控
- 拉美市场选品数据分析
- 商品情报归档、类目行情统计
重要提醒：接口返回属于网页快照数据，库存字段为区间参考值，不可直接用于下单、刊登库存赋值。
三、整体业务处理流程
- 输入商品item_id与对应站点编码；
- 调用mercadolibre.item_get获取原始接口返回；
- 数据解析：提取基础信息，完整解析variants变体数组；
- 业务预处理：图片防盗链处理、币种换算、文本清洗、属性提取；
- 持久化存储：保存商品基础信息，同时保存价格、评分历史快照；
- 上层业务调用：给到竞品分析模块 / ERP 刊登草稿模块；
- 异常处理：捕获限流、参数错误、商品失效，记录日志。
四、核心返回字段简要说明
| 字段 | 说明 |
|---|---|
| item_id | 商品唯一业务 ID |
| site | 站点编码 |
| title | 商品标题，当地语言（西语 / 葡语） |
| brand | 品牌名称 |
| images | 商品图片数组，带有防盗链 |
| price | 页面展示售价 |
| currency | 站点货币编码 |
| description | HTML 格式商品长描述 |
| category_path | 类目层级路径 |
| attributes | 规格参数数组 |
| rating、review_count | 评分、评论数量 |
| available_quantity | 参考库存，区间映射，非真实库存 |
| sold_quantity | 历史销量 |
| fulfillment_type | 履约模式 FULL 海外仓 / FBM 自发货 |
| variants | 变体 SKU 数组，变体业务核心数据源 |
