项目定位：抢购工具的正确打开方式
项目地址: https://gitcode.com/gh_mirrors/jd/jd-assistant 🚀 什么是京东抢购助手？
京东抢购助手是一款自动化辅助工具（非官方），能帮你完成京东商城的商品监控、库存查询和自动下单。它就像你的"24小时专属抢购员"，特别适合热门商品、限量商品的抢购场景。
⚖️ 工具特性速览
| 优势 | 注意事项 |
|---|---|
| 支持扫码登录（安全免密） | 需手动完成支付 |
| 多商品库存监控 | 不支持多账号操作 |
| 定时/有货自动下单 | 依赖京东接口稳定性 |
环境准备：3步搭建运行环境
📦 第1步：安装Python环境
🔍 Python（编程语言）是工具运行的基础，需安装3.4及以上版本。
📌 验证安装：打开终端输入以下命令，能看到版本号即表示成功
python --version # 查看Python版本，需≥3.4
📥 第2步：获取项目代码
🔍 从代码仓库下载完整项目文件，保存到电脑任意目录（建议路径不要有中文）。
🧩 第3步：安装依赖库
🔍 依赖库（工具运行所需的辅助模块）需通过pip命令安装：
📌 操作步骤：
# 进入项目文件夹后执行以下命令
pip install -r requirements.txt # 自动安装所有必要依赖
⚠️ 风险提示：若安装失败，尝试使用管理员权限运行终端
核心功能：五大引擎助力抢购
🔍 智能库存侦探
实时监控商品库存状态，支持：
- 单商品精准查询（指定地区）
- 多商品批量监控（同时跟踪）
- 定时循环检测（自定义间隔）
🛒 购物车管家
一键管理购物车商品：
- 添加商品（支持带数量格式：
12345:2表示2件） - 清空购物车（下单前建议操作）
- 查看商品详情（价格/库存/商家信息）
🕒 预约抢购引擎
针对预约商品设计的抢单功能：
- 自动完成商品预约
- 开抢时间精准卡点
- 库存释放即时捕捉
📊 订单管理器
订单全流程跟踪：
- 获取待结算信息
- 提交订单（支持重试机制）
- 查询订单状态（区分已付款/未付款）
📨 消息推送器
抢购结果实时通知：
- 下单成功推送
- 库存变动提醒
- 异常情况告警
操作流程：新手也能秒上手
🔖 快速开始四步法
1️⃣ 初始化配置
📌 核心步骤：
# 打开main.py文件，找到以下代码段
asst = Assistant() # 创建助手实例
asst.login_by_QRcode() # 调用扫码登录功能
2️⃣ 配置目标商品
📌 设置抢购商品ID和数量：
# 格式1：单个商品（默认1件）
sku_ids = '100001324422'
# 格式2：多个商品带数量
sku_ids = '12345:2,67890:1' # 商品12345买2件，67890买1件
3️⃣ 设置监控参数
📌 配置抢购策略：
# 调用有货自动下单功能
asst.buy_item_in_stock(
sku_ids=sku_ids, # 商品ID
area='1_72_4211', # 地区ID
stock_interval=5 # 库存查询间隔（秒）
)
4️⃣ 启动抢购程序
📌 运行命令：
python main.py # 启动抢购助手
🔍 程序运行后会显示二维码，用京东APP扫码登录即可
📝 完整操作示例
from jd_assistant import Assistant # 导入助手类
if __name__ == '__main__':
# 1. 创建助手实例
asst = Assistant()
# 2. 扫码登录（推荐方式）
asst.login_by_QRcode()
# 3. 配置抢购参数
sku_ids = '100001324422' # 目标商品ID
area = '1_72_4211' # 收货地址ID
# 4. 启动有货抢购
asst.buy_item_in_stock(
sku_ids=sku_ids,
area=area,
wait_all=False, # 有一个商品有货就下单
stock_interval=3 # 每3秒查一次库存
)
配置说明：打造个性化抢购方案
📋 核心配置文件解析
config.ini是工具的"控制面板"，位于项目根目录：
🔑 账号配置区（[account]）
[account]
payment_pwd = 123456 # 支付密码（选填项）
# 仅当使用京券/京豆支付时需要，若无则留空
⚙️ 系统参数区（[config]）
[config]
# 以下四项为必填项（获取方法见常见问题）
eid = xxxxxxxxxx # 设备标识
fp = xxxxxxxxxx # 设备指纹
track_id = xxxxxxxxxx # 跟踪ID
risk_control = xxxxxxx # 风控参数
timeout = 10 # 查询超时时间（选填项，默认10秒）
random_useragent = false # 随机浏览器标识（选填项）
📨 消息推送区（[messenger]）
[messenger]
enable = false # 是否开启消息推送（选填项）
sckey = # 推送密钥（选填项，开启推送时必填）
🌍 地区ID查询
项目提供完整的地区ID映射表：
- 路径：
area_id/文件夹下按省份分类 - 使用方法：查找对应地区的文本文件，复制第一行的数字ID
常见问题速解
登录相关
Q: 账号密码登录提示失败怎么办？
A: 京东已停用账号密码登录，请使用扫码登录asst.login_by_QRcode()
Q: 扫码后提示"验证失败"？
A: 可能是Cookies（用户登录状态数据）已过期，删除cookies文件夹后重试
配置相关
Q: eid/fp等参数如何获取？
A: 打开项目中的get_eid_fp.html文件，按页面提示操作即可获取
Q: 地区ID在哪里查找？
A: 项目area_id文件夹中包含全国各地区ID，例如北京对应1.北京.txt
运行相关
Q: 程序运行后没有反应？
A: 检查Python版本是否≥3.4，依赖库是否全部安装成功
Q: 提示"库存查询超时"？
A: 尝试增大timeout参数值，或检查网络连接
Q: 下单成功但没有生成订单？
A: 检查config.ini中必填参数是否填写正确，特别是eid和fp
总结：抢购成功的关键因素
- 准备充分：提前配置好所有参数，测试运行流程
- 网络稳定：抢购高峰期建议使用有线网络
- 参数正确：eid/fp等系统参数必须准确获取
- 策略合理：根据商品特性调整查询间隔和重试次数
祝大家都能顺利抢购到心仪的商品！使用过程中遇到问题，欢迎提交反馈帮助完善工具。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
