Mercadolibre美客多API上架

参考Mercadolibre API文档：https://global-selling.mercadolibre.com/devsite/en_us

1. 身份验证和授权：https://global-selling.mercadolibre.com/devsite/zh_cn/shen-fen-yan-zheng-he-shou-quan

2. 查找应用：https://global-selling.mercadolibre.com/devcenter
   获取App ID/Client ID,Client Secret,Client Secret

3. 刷新令牌refresh_token(6h有效期):
   curl -X POST https://api.mercadolibre.com/oauth/token?grant_type=refresh_token&client_id=$APP_ID&client_secret=$SECRET_KEY&refresh_token=$REFRESH_TOKEN

4. Mercado Libre 的 MCP 服务器:https://global-selling.mercadolibre.com/devsite/zh_cn/lai-zi-mercado-libre-de-mcp-fu-wu-qi

一、总入口 / 概览

• Global Selling 开发者首页https://global-selling.mercadolibre.com/devsite

• Global Selling 介绍https://global-selling.mercadolibre.com/devsite/introduction-globalselling

二、应用配置 & 授权登录

• 应用管理（Application Manager）https://global-selling.mercadolibre.com/devsite/application-manager-gs

• 认证与授权（OAuth2）https://global-selling.mercadolibre.com/devsite/authentication-and-authorization-global-selling

• 测试账号说明https://global-selling.mercadolibre.com/devsite/start-testing-global-selling

三、上架 / 更新商品（Global Listing）

• 发布商品（Global Listing，POST /global/items，含 net_proceeds）https://global-selling.mercadolibre.com/devsite/global-listing

• 更新 / 同步商品（修改价格、库存等）https://global-selling.mercadolibre.com/devsite/sync-and-modify-listings-gs

• 校验与错误码（Validations CBT）https://global-selling.mercadolibre.com/devsite/validations-cbt

• 多站点工具（multi‑marketplace tool）https://global-selling.mercadolibre.com/devsite/multi-marketplace-tool

• 管理 Global 用户与站点账号（Manage users）https://global-selling.mercadolibre.com/devsite/manage-users-global-selling

四、价格 / Net Proceeds / 自动调价

• 定价参考（Pricing reference）https://global-selling.mercadolibre.com/devsite/pricing-reference

• 价格自动化 / 自动调价（Manage automations）https://global-selling.mercadolibre.com/devsite/manage-automations

五、类目 / 属性 / 规格相关

• 属性文档（Attributes）https://global-selling.mercadolibre.com/devsite/atributtes-global-selling

• 产品唯一标识（Product identifiers）https://global-selling.mercadolibre.com/devsite/product-identifiers-gs

• 商品变体（Variations）https://global-selling.mercadolibre.com/devsite/variations-global-selling

• 商品描述（Item description）https://global-selling.mercadolibre.com/devsite/item-description

• 类目预测（Category predictor）https://global-selling.mercadolibre.com/devsite/category-predictor

六、图片 / Listing 类型

• 图片（Pictures）https://global-selling.mercadolibre.com/devsite/pictures

• Listing 类型与曝光（Listing types and exposures）https://global-selling.mercadolibre.com/devsite/listing-types-and-exposures

1.用账号获取 access_token
账号信息是：

{

"id": 32000,

"nickname": "TESTUSER83569",

"password": "Rsk0G0000P",

"site_status": "active",

"email": "test_user_8356@testuser.com"

}

要让它在 Global Selling (CBT) 上架商品，流程是：

1. 你先准备好自己的 开发者应用（APP）：

• 有 APP_ID、CLIENT_SECRET；

• 配置好 redirect_uri。

1. 浏览器打开授权 URL（用这个测试账号登录）：
   https://global-selling.mercadolibre.com/authorization?response_type=code&client_id=APP_ID&redirect_uri=REDIRECT_URI

• 用账号 nickname + password 登录；

• 点击“Authorize”；

• 浏览器会跳回 REDIRECT_URI?code=XXXX，把这个 code 记下来。

1. 用 code 换 access_token：

curl -X POST \

  -H 'accept: application/json' \

  -H 'content-type: application/x-www-form-urlencoded' \

  'https://api.mercadolibre.com/oauth/token' \

  -d 'grant_type=authorization_code' \

  -d 'client_id=APP_ID' \

  -d 'client_secret=CLIENT_SECRET' \

  -d 'code=SERVER_GENERATED_AUTHORIZATION_CODE' \

  -d 'redirect_uri=REDIRECT_URI'

• 响应里会有：

{

  "access_token": "APP_USR-.....",

  "refresh_token": "TG-.....",

  "user_id": 3232942406,

  ...

}

这里的 access_token 就是你之后 POST /global/items 要用的。

2. 用这个 token 上架你刚才那个产品（MLC/MLB 等可用站点）

示例请求体（建议你先用这份测试）

{
  "sites_to_sell": [
    {
      "site_id": "MLB",
      "logistic_type": "remote",
      "title": "Bola De Futebol Reflexiva Que Brilha Test"
    },
    {
      "site_id": "MLC",
      "logistic_type": "remote",
      "title": "Bola de fútbol reflectante que brilla Test"
    }
  ],
  "currency_id": "USD",
  "catalog_listing": false,
  "category_id": "CBT1287",
  "sale_terms": [
    {
      "id": "WARRANTY_TYPE",
      "name": "Warranty type",
      "value_id": "2230279",
      "value_name": "Factory warranty"
    },
    {
      "id": "WARRANTY_TIME",
      "name": "Warranty time",
      "value_name": "90 days"
    }
  ],
  "attributes": [
    {
      "id": "BRAND",
      "name": "Brand",
      "value_id": "276243",
      "value_name": "Generic"
    },
    {
      "id": "COLOR",
      "name": "Color",
      "value_id": "3801470",
      "value_name": "Multicolor"
    },
    {
      "id": "GTIN",
      "name": "Universal product code",
      "value_name": "8429412807090"
    },
    {
      "id": "ITEM_CONDITION",
      "name": "Item condition",
      "value_id": "2230284",
      "value_name": "New"
    },
    {
      "id": "MODEL",
      "name": "Model",
      "value_id": "15341587",
      "value_name": "Soccer balls"
    },
    {
      "id": "PACKAGE_HEIGHT",
      "name": "Package height",
      "value_name": "30 cm"
    },
    {
      "id": "PACKAGE_LENGTH",
      "name": "Package length",
      "value_name": "30 cm"
    },
    {
      "id": "PACKAGE_WEIGHT",
      "name": "Package weight",
      "value_name": "1 kg"
    },
    {
      "id": "PACKAGE_WIDTH",
      "name": "Package width",
      "value_name": "30 cm"
    },
    {
      "id": "SELLER_SKU",
      "name": "SKU",
      "value_name": "SC-1520-TEST"
    }
  ],
  "title": "Test Items Reflective Glow-in-the-Dark Soccer Ball",
  "description": {
    "plain_text": "Bring your game to life, day or night, with our Reflective Soccer Ball! ..."
  },
  "price": 65.99,
  "available_quantity": 40,
  "pictures": [
    {
      "source": "https://http2.mlstatic.com/D_647917-CBT52638413527_112022-O.jpg"
    }
  ]
}

对应 curl（你只需要把 $ACCESS_TOKEN 替换掉）

curl -X POST \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.mercadolibre.com/global/items \
  -d '{
    "sites_to_sell": [
      {
        "site_id": "MLB",
        "logistic_type": "remote",
        "title": "Bola De Futebol Reflexiva Que Brilha Test"
      },
      {
        "site_id": "MLC",
        "logistic_type": "remote",
        "title": "Bola de fútbol reflectante que brilla Test"
      }
    ],
    "currency_id": "USD",
    "catalog_listing": false,
    "category_id": "CBT1287",
    "sale_terms": [
      {
        "id": "WARRANTY_TYPE",
        "name": "Warranty type",
        "value_id": "2230279",
        "value_name": "Factory warranty"
      },
      {
        "id": "WARRANTY_TIME",
        "name": "Warranty time",
        "value_name": "90 days"
      }
    ],
    "attributes": [
      {
        "id": "BRAND",
        "name": "Brand",
        "value_id": "276243",
        "value_name": "Generic"
      },
      {
        "id": "COLOR",
        "name": "Color",
        "value_id": "3801470",
        "value_name": "Multicolor"
      },
      {
        "id": "GTIN",
        "name": "Universal product code",
        "value_name": "8429412807090"
      },
      {
        "id": "ITEM_CONDITION",
        "name": "Item condition",
        "value_id": "2230284",
        "value_name": "New"
      },
      {
        "id": "MODEL",
        "name": "Model",
        "value_id": "15341587",
        "value_name": "Soccer balls"
      },
      {
        "id": "PACKAGE_HEIGHT",
        "name": "Package height",
        "value_name": "30 cm"
      },
      {
        "id": "PACKAGE_LENGTH",
        "name": "Package length",
        "value_name": "30 cm"
      },
      {
        "id": "PACKAGE_WEIGHT",
        "name": "Package weight",
        "value_name": "1 kg"
      },
      {
        "id": "PACKAGE_WIDTH",
        "name": "Package width",
        "value_name": "30 cm"
      },
      {
        "id": "SELLER_SKU",
        "name": "SKU",
        "value_name": "SC-1520-TEST"
      }
    ],
    "title": "Test Items Reflective Glow-in-the-Dark Soccer Ball",
    "description": {
      "plain_text": "Bring your game to life, day or night, with our Reflective Soccer Ball! ..."
    },
    "price": 65.99,
    "available_quantity": 40,
    "pictures": [
      {
        "source": "https://http2.mlstatic.com/D_647917-CBT52638413527_112022-O.jpg"
      }
    ]
  }'

执行成功后，响应会给出：

• item_id（CBT 全局 ID）；

• site_items 里各站点的真实 item_id（比如 MLBxxxx, MLCxxxx）。