$npx -y skills add FTShare-Lab/FTShare-skills --skill economic-china-retail-sales-monthlyGet China retail sales of consumer goods monthly data (社会消费品零售总额 月度). Use when user asks about 社会消费品零售总额, 零售总额, 消费零售, 中国消费, China retail sales, 社零.
| 1 | # 中国经济 - 社会消费品零售总额(月度) |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 社会消费品零售总额(月度汇总计算结果) | |
| 8 | | 外部接口 | GET /api/v1/market/data/economic/china-retail-sales | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取中国社会消费品零售总额月度数据,含当月值、同比、累计及累计同比等 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:该接口无需请求参数。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | - | - | - | 无需参数 | - | - | |
| 19 | |
| 20 | ## 3. 用法 |
| 21 | |
| 22 | 直接执行: |
| 23 | |
| 24 | ```bash |
| 25 | python script/handler.py |
| 26 | ``` |
| 27 | |
| 28 | 脚本输出 JSON 数组,按时间倒序,每项含 `month`(如 2025年03月份)、`current`(当月值)、`yoy`(同比 %)、`cumulative`(累计值)、`cumulative_yoy`(累计同比 %)、`unit`(亿元)、`currency`(CNY),以表格展示给用户。 |
| 29 | |
| 30 | ## 4. 响应说明 |
| 31 | |
| 32 | 返回值为社会消费品零售总额月度计算结果列表,按时间倒序。 |
| 33 | |
| 34 | ### RetailSalesComputed 结构 |
| 35 | |
| 36 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 37 | |--------|------|------------|------|------| |
| 38 | | month | String | 否 | 月份,格式如 2025年03月份 | - | |
| 39 | | current | float | 是 | 当月值 | 见 unit | |
| 40 | | yoy | float | 是 | 同比增长 | % | |
| 41 | | cumulative | float | 是 | 累计值 | 见 unit | |
| 42 | | cumulative_yoy | float | 是 | 累计同比增长 | % | |
| 43 | | unit | String | 否 | 货币单位 | - | |
| 44 | | currency | String | 否 | 货币种类 | - | |
| 45 | |
| 46 | ## 5. 请求示例 |
| 47 | |
| 48 | ``` |
| 49 | GET /api/v1/market/data/economic/china-retail-sales |
| 50 | ``` |
| 51 | |
| 52 | ## 6. 注意事项 |
| 53 | |
| 54 | - 返回按月份汇总,格式如「2025年03月份」,列表已按时间倒序,最新月份在前。 |
| 55 | - 金额单位见 `unit`(通常为亿元),同比单位为 %,各数值字段可为 null。 |