Filtmall-Shopping-Skill

环境要求

• Node.js 18 或更高版本
• 可联网的终端环境（使用 npx 安装）
• 支持 Claude Skills、OpenClaw 等技能生态的智能体客户端（可选）
• 支持文件夹或 ZIP 导入的客户端可直接导入仓库根目录

安装与启动步骤

1. 1安装技能包

   用 npx 从 GitHub 拉取并全局安装 filtmall-shopping 技能，无需单独执行 npm install。

   npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g

   复制

2. 2以仓库方式导入

   若客户端支持文件夹或 ZIP 导入，直接把仓库根目录导入即可，无需走 npx 安装流程。

3. 3检查运行时

   在项目目录执行 doctor，确认技能自带的 CLI 运行时可用、运行环境正常。

   node scripts/filtalgo.js doctor --json

   复制

4. 4搜索商品

   用自然语言描述需求即可搜索实时商品库，--json 输出便于智能体解析结果。

   node scripts/filtalgo.js search "想要保湿一点的面膜，预算 100 元以内，但别太黏" --json

   复制

5. 5登录授权

   涉及购物车、下单等操作前先走 OAuth Device Flow 登录，再用 auth status 查看登录状态。

   node scripts/filtalgo.js auth login
   node scripts/filtalgo.js auth status --json

   复制

6. 6加购与创建结账

   把搜索得到的 sku_id 加入购物车，创建结账会话并生成支付链接。

   node scripts/filtalgo.js cart add-item --way CART --sku-id <sku_id> --quantity 1 --json
   node scripts/filtalgo.js checkout create --way CART --json
   node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --link-channel mobile_h5 --json

   复制

7. 7查订单与物流

   下单后可列出订单、查看订单明细（含商品项）并跟踪配送状态。

   node scripts/filtalgo.js order list --page-size 5 --json
   node scripts/filtalgo.js order get <order_sn> --include-items true --json
   node scripts/filtalgo.js logistics get <order_sn> --json

   复制

8. 8查看完整命令

   不确定可用子命令时执行 help，列出 CLI 支持的全部命令。

   node scripts/filtalgo.js help

   复制

如何确认成功

执行 node scripts/filtalgo.js doctor --json 返回正常运行状态，且 auth status 显示已登录，即表示环境与授权就绪。

常见问题

注意事项

• 当前商品目录聚焦美妆个护品类，其他品类可能尚无结果。
• 实际价格会随账户、地区、会员状态和促销活动变化，展示的价格优势具有时效性。
• 命令中的 <sku_id>、<checkout_session_id>、<order_sn> 需替换为上一步返回的真实值。
• 遇到不认识的命令时先运行 node scripts/filtalgo.js help 查看完整命令列表。