JD-Assistant 使用教程
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. 应用案例和最佳实践
应用案例
- 抢购热门商品:用户可以设置定时提交订单,确保在商品开售的第一时间抢购到心仪的商品。
- 批量查询库存:商家或个人用户可以通过该工具批量查询多个商品的库存情况,以便做出更合理的采购决策。
最佳实践
- 优化网络环境:确保网络连接稳定,减少因网络延迟导致的抢购失败。
- 合理设置定时:根据商品开售时间,合理设置定时提交订单的时间,避免过早或过晚提交。
- 多账号操作:如果有多个京东账号,可以同时运行多个实例,提高抢购成功率。
4. 典型生态项目
相关项目
- go-jd-assistant:一个使用 Go 语言重写的京东抢购助手,旨在提高抢购效率。项目地址:go-jd-assistant
- jd-assistant-web:一个基于 JD-Assistant 的 Web 界面项目,方便用户通过浏览器进行操作。项目地址:jd-assistant-web(假设存在)
通过这些生态项目,用户可以更灵活地选择适合自己需求的工具,进一步提升抢购效率和体验。