摘要：二手电商赛道中，竞品价格波动、商品上下架状态直接影响选品与定价策略。手动盯盘效率低下，很难及时捕捉价格异动。本文以工程实战视角，讲解如何基于闲鱼商品详情 API，搭建一套竞品价格监控方案，覆盖需求拆解、整体架构、数据处理逻辑、伪代码实现、实战踩坑，
一、业务背景
二手 3C、潮玩、奢侈品等品类，闲鱼是重要的货源与竞品观测阵地。运营人员经常面临这些问题：
- 竞品调价之后不能及时感知，定价失去竞争力；
- 商品被卖家下架、售出，人工巡检无法及时发现；
- 同类二手商品成色不一样，单纯比价容易失真；
- 商品热度（想要、浏览）变化，无法量化跟踪市场行情。
依靠人工打开网页定期刷新，商品数量一多就很难维护。通过调用闲鱼商品详情 API，定时拉取目标商品数据，做对比、存储、告警，就可以实现自动化竞品价格监控系统。二、系统整体设计思路
核心业务流程
- 维护监控商品池：录入需要监控的闲鱼商品
num_iid，存入数据库，标记商品名称、品类、目标成色、告警阈值。 - 定时任务调度：通过定时任务，分批调用商品详情接口，获取最新接口返回数据。
- 新旧数据对比：将本次返回的价格、status 状态、want_count，和上一次数据库存储快照对比。
- 规则判断触发告警：价格变动、商品下架 / 售出、热度大幅变化时触发告警。
- 持久化快照：每一次拉取的数据保存历史快照，用于回溯价格走势。
- 上层业务输出：后台报表、消息通知，给到运营人员做定价参考。
核心监控维度
- 售价变化：价格上涨、下调
- 商品状态：在售 → 已售出 / 下架
- 成色信息：成色发生变更
- 热度指标：
want_count想要人数、浏览量变化 - 卖家信息：卖家信用等级变更
三、关键数据处理要点
- 成色绑定比价
二手商品不能只看价格，相同型号，99 新和 8 成新价差巨大。业务逻辑需要把condition成色字段纳入对比条件，比价时区分成色，避免误告警。 - 状态优先判断
如果接口返回status为sold或者offline，代表商品已经失效，直接触发下架告警，不再做价格对比。 - 历史快照存储
数据库设计至少保存：num_iid、抓取时间、price、condition、status、want_count、express_fee。每次抓取生成一条快照记录，方便绘制价格曲线。 - 空值容错处理
闲鱼个人闲置很多字段为空，品牌、型号可能缺失，代码必须安全取值，防止程序异常中断定时任务。
