3 分钟跑通 jd-happy：京东商品库存监控与自动下单完整指南

3 分钟跑通 jd-happy：京东商品库存监控与自动下单完整指南

【免费下载链接】jd-happy[DEPRECATED]Node 爬虫，监控京东商品到货，并实现下单服务项目地址: https://gitcode.com/gh_mirrors/jd/jd-happy

补货通知还没看完，刷新页面就显示售罄。jd-happy 是一个面向京东的库存监控与自动下单 Node.js 工具：定时轮询指定商品的库存，一旦显示有货，就自动加购并提交订单。下单成功后，你只需要去付款。

jd-happy 能做什么，不能做什么

它负责三件事：扫码登录京东账号、按地区查询某个商品的库存状态、库存大于 0 时自动加入购物车并提交订单。

它不负责的事：不付款、不缓存登录状态（每次运行都要重新扫码）、也暂不支持抢购类（秒杀）商品。

技术路线一句话就能说清：启动时驱动一个真实浏览器拿到登录页的隐藏参数，之后全部改用普通 HTTP 请求完成。你不需要理解底层细节，只需记住"浏览器管登录，请求管其余"。

快速上手：安装与启动

环境要求

• Node.js 12.0.0 及以上版本
• yarn 包管理器
• 机器能启动浏览器——工具启动时需要短暂开一个浏览器实例抓取页面参数

安装与启动

git clone https://gitcode.com/gh_mirrors/jd/jd-happy cd jd-happy yarn install

装好后直接启动监控（参数含义下一节细说）：

yarn start -a 2_2830_51810_0 -g 5008395

运行后会自动弹出一张二维码图片，用京东 APP 扫码、手机确认，终端就开始实时输出商品详情了。

参数配置：4 个核心参数

所有配置都通过命令行参数传入，不用改源码。

记不住参数写法时，执行yarn start -h会打印完整的帮助说明和示例。

典型场景实操：盯一个补货的 CPU

怎么设置：执行yarn start -a 2_2830_51810_0 -g 5008395 -t 5000，每 5 秒轮询一次；buy 参数默认就是 true，检测到有货会自动下单。

看到什么反馈：终端每隔几秒滚动输出一次商品详情块，包含时间戳、商品名、价格、库存状态。无货时状态一行显示"无货"；一旦变成"有货"，程序自动转入加购流程，不再等待。

得到什么结果：终端先打印"商品已成功加入购物车"，接着输出订单详情——订单总金额、收货地址、收货人——最后给出订单号，提示你前往京东尽快付款。

如果只想看库存、不想自动买，加-b false并把间隔拉长到30000（30 秒）。它变成一台纯提醒机器，有货后由你手动下单。

工作原理通俗讲

登录阶段。启动时工具先打开浏览器访问京东登录页，从页面里取出 token、uuid 等几个隐藏参数——类似进游乐场先取"入园卡"，后面所有请求都要出示它。然后它申请一张登录二维码并自动打开图片，每隔 1 秒追问一次"扫了没有"，直到扫码成功、拿到登录凭证。全程不经过你的账号密码。

库存轮询阶段。登录后，每个间隔它并行打三个数据源：商品价格、库存状态、商品页面。其中库存接口直接返回状态码：33 表示有货，34 表示无货。相当于保安每 10 秒查一次仓库台账，不用进店逛。状态码变成 33，轮询循环立刻跳出，进入下单流程。

下单阶段。先访问商品页里的加购链接把商品放进购物车，根据返回的提示文案判断是否成功；再请求订单页，把订单总金额、收货地址打印出来供你核对；最后提交订单，返回订单号。

网络抖动导致某次请求失败时，工具不会立刻退出，而是等一个间隔重试；实在不行整个进程会带着报错退出，重跑一次即可。

进阶技巧与避坑

💡 几个能帮你省时间的细节：

• 查询频率别拍脑袋：-t的单位是毫秒，5000 是 5 秒，别写成 5000000。热门商品 3~5 秒，普通商品 10~15 秒，长期挂着监控用 30 秒以上。
• 地区编号要查对：它同时决定查哪个地区的库存、订单发往哪里。填错的表现是明明本地有货却一直显示"无货"，或者订单寄到别处。可以在京东 APP 的收货地址管理里对照自己的地址查编码。
• 留意账号风控：查询过于频繁可能触发限流。需要长期监控时可以备一个账号轮换，别用同一账号同时开多个实例。
• 遵守平台规则：这个工具定位是个人购物辅助，请把查询频率控制在合理范围，不要拿它做批量抓取或商业用途。

边界与限制：跑之前先看

⚠️jd-happy 只下单，不付款。下单成功后你仍需在京东 APP 或网页端限时完成支付（通常 30 分钟），超时订单自动取消，前面全白等。

另外几条边界：

• 登录状态不做本地缓存，每次运行都要重新扫码。
• 不支持抢购（预售/秒杀）类商品。
• 项目本身已标记 DEPRECATED：京东页面更新后部分接口已过期，运行时若遇到报错，需要自行排查修复对应的接口调用。

适合谁

想蹲一个限量或长期缺货的商品，它是省心的自动化助手；只想看库存提醒，把自动下单关掉就能当监控脚本用。对开发者来说，整个项目就是src/下几个小文件，主流程都在 src/index.js 里：浏览器取参 → 请求登录 → 轮询库存 → 加购 → 下单，链路清晰，很适合当作 Node.js 结合浏览器做自动化任务的入门样本。

【免费下载链接】jd-happy[DEPRECATED]Node 爬虫，监控京东商品到货，并实现下单服务项目地址: https://gitcode.com/gh_mirrors/jd/jd-happy