手把手教你用Python实现京东店铺数据自动诊断与监控

一、环境准备与依赖安装

在开始编写代码之前，需要确保本地环境已经安装了Python解释器。推荐使用Python 3.8及以上版本以保证库的兼容性。本文主要使用requests库进行HTTP请求，使用hashlib和time库处理签名和时间戳。

打开终端或命令行工具，执行以下命令安装必要的依赖库：

pip install requests

如果安装速度较慢，建议使用国内镜像源：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

二、京东开放平台账号配置

要获取京东店铺数据，必须通过京东开放平台（开普勒）的API接口。首先需要注册并创建应用以获取调用凭证。

1. 访问京东开普勒官网：https://open.jd.com/

2. 登录京东商家账号，进入“我的工作台” -> “创建应用”。选择“ISV”或“自研”类型，应用名称填写“店铺数据诊断工具”。

3. 创建成功后，在应用详情页获取App Key和App Secret，这两个参数是后续API调用的身份验证关键，请妥善保管。

4. 在“授权管理”中，需要给应用授权相应的API接口权限。对于数据诊断，必须勾选以下接口组：

• 京东商智-数据查询：用于获取流量、转化率等核心指标。
• 商品-读取：用于获取商品信息及库存状态。
• 订单-读取：用于核对订单数据。

三、核心签名算法实现

京东API采用MD5签名机制进行安全验证。所有接口请求都必须包含app_key、timestamp、v（版本号）、method（接口名）和sign（签名）参数。签名规则是将所有请求参数（除sign本身）按字母顺序排序，然后拼接成字符串，最后拼接上App Secret进行MD5加密并转大写。

以下是一个封装好的签名生成函数，直接复制到项目中即可使用：

import hashlib
import urllib.parse
def generate_sign(params, app_secret):
"""
生成京东API签名
:param params: 请求参数字典
:param app_secret: 应用密钥
:return: 签名字符串
"""
1. 过滤掉sign参数和空值参数
filtered_params = {k: v for k, v in params.items() if v is not None and k != 'sign'}
2. 按key的字母顺序升序排列
sorted_params = sorted(filtered_params.items())
3. 拼接字符串 key1value1key2value2...
param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
4. 在末尾追加app_secret
sign_str = param_str + app_secret
5. MD5加密并转大写
m = hashlib.md5()
m.update(sign_str.encode('utf-8'))
return m.hexdigest().upper()

四、数据获取与诊断脚本编写

我们将编写一个完整的Python脚本，模拟获取“昨日店铺数据”并进行简单的健康度诊断。这里以获取店铺流量和转化数据为例，使用京东商智常用的jd.seller.data.search接口（注：实际接口名称需根据京东最新文档调整，此处以通用逻辑为例）。

新建文件jd_diagnosis.py，填入以下完整代码：

import requests
import time
import json
================= 配置区域 =================
APP_KEY = '你的App_Key'        替换为实际的App Key
APP_SECRET = '你的App_Secret'  替换为实际的App Secret
ACCESS_TOKEN = '你的Access_Token'  需通过OAuth流程获取，此处假设已获取
GATEWAY_URL = 'https://router.jd.com/api'
===========================================
def call_api(method, params=None):
"""
通用API调用方法
"""
if params is None:
params = {}
公共参数
base_params = {
'app_key': APP_KEY,
'method': method,
'timestamp': str(int(time.time()  1000)),
'v': '2.0',
'format': 'json',
'access_token': ACCESS_TOKEN
}
合并业务参数
base_params.update(params)
生成签名
sign = generate_sign(base_params, APP_SECRET)
base_params['sign'] = sign
try:
response = requests.post(GATEWAY_URL, data=base_params, timeout=10)
return response.json()
except Exception as e:
print(f"请求异常: {e}")
return None
def diagnose_shop_health():
"""
执行店铺数据诊断逻辑
"""
print("开始执行京东店铺数据诊断...")
1. 获取流量数据 (模拟调用 jd.seller.data.search)
注意：实际字段名需参考京东API文档，此处为示例逻辑
biz_params = {
'dateType': '1',  1: 昨日
'metrics': 'pv,uv,payRate'  请求指标：浏览量、访客数、转化率
}
假设接口方法名为 jd.shop.data.get
result = call_api('jd.shop.data.get', biz_params)
if not result:
print("【严重】数据获取失败，请检查网络或Token是否过期。")
return
解析返回数据 (结构需根据实际API返回调整)
if result.get('code') == '0' or 'success_response' in result:
提取数据逻辑
data_content = result.get('success_response', {}).get('data', {})
uv = data_content.get('uv', 0)
pay_rate = data_content.get('payRate', 0)
print(f" 诊断报告 ")
print(f"昨日访客数(UV): {uv}")
print(f"昨日转化率: {pay_rate}%")
2. 诊断逻辑：流量预警
if uv < 100:
print("【警告】流量过低！建议检查：")
print("  1. 主推款是否有搜索排名下降？")
print("  2. 是否有正在进行的推广活动（如快车）预算耗尽？")
print("  3. 类目大盘流量是否整体下跌。")
else:
print("【正常】流量处于健康范围。")
3. 诊断逻辑：转化预警
if pay_rate < 2.0:  假设2%为基准线
print("【警告】转化率异常！建议检查：")
print("  1. 竞品是否在昨天进行了大幅度降价？")
print("  2. 检查差评反馈，是否有中差评出现在首页。")
print("  3. 检查库存，是否有核心SKU出现断码。")
else:
print("【正常】转化率处于健康范围。")
else:
error_msg = result.get('zh_desc', result.get('en_desc', '未知错误'))
print(f"【错误】API返回错误: {error_msg}")
if __name__ == '__main__':
diagnose_shop_health()

五、获取Access Token（OAuth 2.0）

上述代码中ACCESS_TOKEN是必须的。如果是自用型应用，可以通过京东提供的“Token获取”工具生成，有效期通常较长。如果是开发给其他商家使用，需要实现OAuth 2.0授权流程。

对于自用诊断，操作步骤如下：

1. 在京东开放平台应用详情页，找到“授权信息”或“测试授权”部分。

2. 输入你的商家账号进行授权。

3. 授权成功后，页面会显示access_token。

4. 将该Token填入上方代码的ACCESS_TOKEN变量中。

注意：Token过期会导致报错（通常错误码为10001或401），此时需要重新获取并更新代码中的变量。

六、运行与排错

将jd_diagnosis.py保存后，在命令行运行：

python jd_diagnosis.py

如果一切配置正确，你将看到控制台输出的诊断报告。

常见错误处理：

• 签名错误 (Sign Invalid)：请检查APP_SECRET是否正确，以及代码中的参数排序逻辑是否被意外修改。
• 权限不足 (Permission Denied)：请回到开放平台，确认该应用已勾选“数据查询”相关的权限包，并重新授权。
• IP白名单：如果在开放平台配置了服务器IP白名单，请确保运行脚本的公网IP已添加，或者暂时关闭白名单限制（仅开发测试时）。

七、进阶：定时任务设置

为了实现每天自动监控，不需要手动运行脚本。在Linux服务器上可以使用crontab，在Windows上可以使用“任务计划程序”。

Linux Crontab 设置示例：

1. 编辑定时任务：

crontab -e

2. 添加一行，表示每天早上9点运行一次：

0 9    /usr/bin/python3 /root/jd_diagnosis.py >> /root/jd_diagnosis.log 2>&1

这样，每天早上9点系统会自动运行诊断脚本，并将输出日志写入jd_diagnosis.log文件中，便于后续查看历史预警信息。