vipshop-cli

一套基于原生 Node.js 构建的唯品会 (Vipshop) 现代化命令行交互系统与 AI Agent 技能池工具包。

特性 (Features)

📦 性能卓越 - 基于标准 Node.js fetch API 直接与唯品会内部接口对接，执行耗时微秒级，完美替代 Python 桥接方案。
🛡️ 原生加密环境 - 内置操作系统指纹感知 (OS, CPU, 时区)，依靠 AES-256-GCM 引擎自动生成请求头 x-vip-ctx，行为特征完全模拟真实设备。
🆔 标准标识生成 - 包含原生的 mars_cid 生成算法，支持自动持久化 device.json，确保设备会话的稳定性与安全性。
🔑 状态解耦 - 自动读取 ~/.vipshop-user-login/tokens.json。登录态采用 Agent 友好型 的单次轮询模式，适配高频异步交互。

安装 (Installation)

你可以选择全局或项目内安装：

# 全局安装，注册 vipshop 命令
npm install -g .

# 本地链接测试 
npm link

使用手册 (Usage)

直接在终端或 Agent Shell 中调用。提供四大核心服务支持：

# 获取帮助信息
vipshop --help

# 2. 获取登录状态 (1.0.1+ 新增)
vipshop status

# 3. 退出登录 (1.0.1+ 新增)
vipshop logout

# 4. 搜索商品
vipshop search-product --query "运动鞋"

# 5. 查看具体商品详情
vipshop product-detail --product-id 6921388647706229776

# 6. 获取最新的主站特卖活动与大牌日会场数据
vipshop search-promotion

Agent 轮询建议 (Polling Logic)

从 1.0.1 版本开始，vipshop login --poll <qrToken> 调整为 单次非阻塞查询。建议 Agent 采用以下策略：

• 周期：每 3 秒执行一次。
• 限制：最大执行 10 次。
• 返回：返回标准 JSON 包含 status 字段 (NOT_SCANNED | SCANNED | CONFIRMED | INVALID)。

技术堆栈

• commander.js ^14
• Native Crypto (AES-256-GCM)
• Native Zlib (Gzip Telemetry)
• Fetch API
• ESBuild (Zero-Dependency Bundler)