【亲测免费】 JD-Assistant 使用教程

2026-01-21 04:57:12作者：鲍丁臣Ursa

1. 项目介绍

JD-Assistant 是一个用于京东商城的抢购助手，支持登录、查询商品库存/价格、添加/清空购物车、抢购商品（下单）、查询订单等功能。该项目使用 Python 编写，旨在帮助用户更高效地进行京东商品的抢购操作。

主要功能

登录京东商城：支持手机扫码登录和保存/加载登录 cookies。
商品查询操作：提供完整的地址⇔ID对应关系，支持根据商品ID和地址ID查询库存和价格。
购物车操作：支持清空/添加购物车，获取购物车商品详情。
订单操作：获取订单结算页面信息，提交订单（直接提交、有货提交、定时提交），查询订单。
其他功能：商品预约、用户信息查询。

2. 项目快速启动

安装依赖

首先，确保你已经安装了 Python 3.4 或更高版本。然后，使用 pip 安装项目依赖：

pip install -r requirements.txt

初始化项目

在项目根目录下，运行以下代码进行初始化：

from jd_assistant import Assistant

if __name__ == '__main__':
    asst = Assistant()  # 初始化
    asst.login_by_QRcode()  # 扫码登陆
    asst.get_order_vercode()  # 获取本地服务订单验证码及状态

直接提交订单示例

以下是一个直接提交订单的示例代码：

from jd_assistant import Assistant

if __name__ == '__main__':
    asst = Assistant()  # 初始化
    asst.login_by_QRcode()  # 扫码登陆
    asst.clear_cart()  # 清空购物车（可选）
    asst.add_item_to_cart(sku_ids='100001324422')  # 根据商品id添加购物车（可选）
    asst.submit_order()  # 直接提交订单

定时提交订单示例

以下是一个定时提交订单的示例代码：

from jd_assistant import Assistant

if __name__ == '__main__':
    asst = Assistant()  # 初始化
    asst.login_by_QRcode()  # 扫码登陆
    asst.clear_cart()  # 清空购物车（可选）
    asst.add_item_to_cart(sku_ids='100001324422')  # 根据商品id添加购物车（可选）
    asst.submit_order_by_time(buy_time='2020-02-16 01:17:59.500', retry=4, interval=5)  # 定时提交订单

3. 应用案例和最佳实践

应用案例

抢购热门商品：用户可以设置定时提交订单，确保在商品开售的第一时间抢购到心仪的商品。
批量查询库存：商家或个人用户可以通过该工具批量查询多个商品的库存情况，以便做出更合理的采购决策。

最佳实践

优化网络环境：确保网络连接稳定，减少因网络延迟导致的抢购失败。
合理设置定时：根据商品开售时间，合理设置定时提交订单的时间，避免过早或过晚提交。
多账号操作：如果有多个京东账号，可以同时运行多个实例，提高抢购成功率。