MCP：销售数据查询指南

一、功能介绍
UpSeller 现已支持通过 MCP（AI 工具连接）访问数据模块。

您可以将 UpSeller MCP 连接至 Claude、Codex、ChatGPT、Cursor 等 AI 工具，查询销售业绩、产品销量及商品销量数据，帮助您更便捷地获取和分析店铺销售数据。
二、适用范围
该功能面向以下用户开放：


	
专业版及以上套餐用户
	
组合套餐用户

注意：

1.该功能无需额外付费

2.仅主账号可进入【开放平台】并申请 MCP Token，子账号暂不支持查看入口或申请 Token

三、支持的查询模块
目前，UpSeller MCP 支持查询以下三个数据模块：


	
销售业绩：支持按日期、按店铺两个维度查询销售业绩
	
产品销量：支持按产品、按变种、按产品 SKU、按变种 SKU 四个维度查询产品销量
	
商品销量：支持按全部商品、按新品、按畅销品、按滞销品四个维度查询商品销量

注意： 以上三个模块的单次查询周期最长均为 7 天

四、销售业绩模块
支持通过 MCP 查询店铺销售业绩数据，可按日期或店铺两个维度进行查询

1. 查询维度

	
按日期查询： 按日期查看销售业绩数据
	
按店铺查询： 按店铺查看销售业绩数据

2.请求字段







3.返回字段




五、产品销量模块
1.查询维度：


	
按产品查询
	
按变种查询
	
按产品 SKU 查询
	
按变种 SKU 查询

注意：


	
单次查询日期范围最长为 7 天
	
当返回数据量较大时，接口将采用分页方式返回数据

2.请求字段







3.返回字段

接口数据基于 t_product_statistics_summary 和 t_product_variation_statistics_summary 两张表进行聚合处理，数据量较大时采用分页方式返回。

t_product_statistics_summary（产品统计数据）







t_product_variation_statistics_summary（变种统计数据）







接口最终返回字段

接口聚合后的统一返回字段如下




六、商品销量模块
1.查询维度


	
按全部商品   
	
按新品
	
按畅销品
	
按滞销品

2.请求字段







3.返回字段

当返回数据量较大时，接口将采用分页方式返回数据。




七、MCP Tool 说明

1、MCP Tool概览
①销售业绩（店铺 / 日期）（2 个）


	
page_sales_performance_by_shop
	
page_sales_performance_by_date

②产品销量（产品 / 变种 / SKU）（4 个）


	
page_product_sales_by_product
	
page_product_sales_by_variation
	
page_product_sales_by_product_sku
	
page_product_sales_by_variation_sku

③商品销量（列表 / 销量 / 滞销 / 库存）（2 个）


	
page_warehouse_sales
	
page_warehouse_unsold_sales


2、具体内容