Bbili-open-mcpMCP
★

商品发布

POST#68api SHOP_COMMODITY_INFO
https://member.bilibili.com/arcopen/fn/market/common/product_add

开放能力 / 交易电商 / 电商 / 接口 / 商品模块接口

调用该接口可新增商品

body 参数

名称类型必填说明
category_leaf_idint是叶子类目ID，从类目接口获取
namestring是商品标题，不能包含特殊字符，长度限制6-60
picstring是商品轮播图。多张图片用 ![](http://i0.hdslb.com/bfs/templar/open-static/cf3b2c2bba23e8341c3afb5c94ccdfc2a0c399dc.png#size=19x23&align=left) 符号隔；第一张图将用作主图；最多上传5张图片；图片链接通过图片上传接口获取
descriptionstring否商品图片描述。多张图片用 ![](http://i0.hdslb.com/bfs/templar/open-static/cf3b2c2bba23e8341c3afb5c94ccdfc2a0c399dc.png#size=19x23&align=left) 符号隔；最多上传50张图片；图片链接通过图片上传接口获取
text_descriptionstring否商品文字描述。字数限制500字；文字描述会在图片描述上方展示
freight_idint是运费模板ID。通过运费模板接口获取
delivery_delay_dayint否承诺发货时间。现货发货时必填
presell_typeint否发货模式。0-现货发货；默认0
commitbool否提交类型。false-仅保存；true-保存+提审
product_typeint否商品类型。0-普通商品；1-虚拟服务。不传时沿用历史逻辑。
operate_statusint否上架操作。0-立即上架；1-定时上架；2-下架。不传时沿用历史逻辑。
scheduled_on_shelf_timelong否定时上架时间，毫秒级时间戳。operate_status=1 时必传。
limit_per_buyerint否每个用户累计限购件数。0代表不限购；默认为0
product_formatstring否属性。格式：{"property_id":[{"value":属性值ID,"name":"属性值内容"}]}；name的类型是string，value的类型是number；用自定义属性值（diy_type=1）时，只需要填写name；要填写的属性信息通过查询类目属性列表接口获取；
after_sale_servicestruct是售后服务参数。
spec_infostruct是规格详细信息
spec_picstring是规格图片
spec_priceslist是sku参数。sku数量和规格组合数必须一致
ext_propertystruct否商品扩展属性,三谋使用。
supply_day_return_selectorstring是7天无理由选项。7-0不支持7天无理由；7-1支持七天无理由
spec_valueslist是规格内容
property_namestring是规格项名称
valueslist是规格值
value_namestiring是规格值名称
stock_numint是库存数量
priceint是价格。单位分
codestring否商家编码
sell_propertieslist是sku规格信息
value_namestring是规格值名称
extraarray<struct>是三谋账号资产属性列表。三谋发品时需要传入完整资产数据，不能为空。
namestring是属性展示名称，不能为空。示例：游戏ID、基础信息、武将。
keystring是属性键，同一次请求中不能重复。 仅支持：<br>game_id<br>base_info<br>core_info<br>overview<br>rare_stunts<br>heroes<br>skills<br>equips<br>horses<br>skin_list
valuestring是属性值。game_id 直接传数字字符串；其余字段传序列化后的 JSON 字符串，不能直接传 JSON 对象。
typestring是属性值类型。game_id 固定为 text，其余属性固定为 json。

响应字段

名称类型必填说明
product_idint否商品ID
skuslist否sku信息
sku_idint否sku_id

调用方式

javascript
// 让 AI 直接调（需要开放平台凭据）
bili_api_call { "ref": "68", "query": {…}, "body": {…} }

// 只看将要发出的请求（不需要凭据）
bili_api_call { "ref": "68", "dryRun": true }

// 生成完整调用代码
bili_codegen { "ref": "68", "lang": "python" }

官方请求示例

bash
curl --location --request POST 'https://member.bilibili.com/arcopen/fn/market/common/product_add' \
--header 'Accept: application/json' \
--header 'Access-Token: a24e56a0fc0093668bca0f3a15410ea2' \
--header 'Content-Type: application/json' \
--header 'x-bili-timestamp: 1712473117' \
--header 'x-bili-signature-method: HMAC-SHA256' \
--header 'x-bili-signature-version: 2.0' \
--header 'Authorization: afdf0ddc6dd8f5af9c7f25cf3115a03142e67df99e15f909a17c11e4c82ad4f9' \
--header 'x-bili-signature-nonce: 1712473117993237000' \
--header 'x-bili-accesskeyid: 8ca079bc20ce433d' \
--header 'x-bili-content-md5: 795a2d7e13f989cee460801379fe543c' \
--header 'Connection: keep-alive' \
--data-raw '{
    "category_leaf_id": 2303,
    "name": "名字",
    "pic": "http://i0.hdslb.com/bfs/kfptfe/floor/173c24ae8a8893ddfe84076c4785d81b9b94ce70.png",
    "description": "http://i0.hdslb.com/bfs/kfptfe/floor/173c24ae8a8893ddfe84076c4785d81b9b94ce70.png",
    "text_description": "这里是文字商品描述，最多500字",
    "freight_id": 1004258,
    "delivery_delay_day": 1,
    "presell_type": 0,
    "commit": true,
    "spec_pic": "http://i0.hdslb.com/bfs/kfptfe/floor/173c24ae8a8893ddfe84076c4785d81b9b94ce70.png",
    "limit_per_buyer": 1,
    "product_format": "{\"12\":[{\"value\":\"2529\",\"name\":\"氧化铝\"}],\"14\":[{\"name\":\"10000日元\"}],\"17\":[{\"name\":\"大小合适\"]}]",
    "after_sale_service": {
        "supply_day_return_selector": "7-1"
    },
    "spec_info": {
        "spec_values": [
            {
                "property_name": "颜色",
                "values": [
                    {
                        "value_name": "红色"
                    }
                ]
            }
        ]
    },
    "spec_prices": [
        {
            "stock_num": 100,
            "price": 10000,
            "code": "111111",
            "sell_properties": [
                {
                    "property_name": "颜色",
                    "value_name": "红色"
                }
            ]
        }
    ],
    "ext_property": {
    "extra": [
      {
        "name": "游戏ID",
        "key": "game_id",
        "value": "9566",
        "type": "text"
      },
      {
        "name": "基础信息",
        "key": "base_info",
        "value": "{\"item_id\":17569568,\"price\":77700,\"snapshot_id\":365363456,\"status\":\"VALID\"}",
        "type": "json"
      },
      {
        "name": "武将",
        "key": "heroes",
        "value": "{\"type\":\"hero\",\"name\":\"武将\",\"count\":1,\"list\":[{\"id\":\"1014\",\"attrs\":[{\"k\":\"name\",\"v\":\"乐进\"}]}]}",
        "type": "json"
      }
    ]
  }
}'

原始文档：068_商品发布.md（9221 字节）。用 bili_docs_get { "ref": "68" } 读全文，或用 bili_api_spec { "ref": "68" } 取结构化规格。