Filtmall 智能购物
让 AI 助手按需求搜商品、核对同款价格,并协助完成购物与订单跟进。
- Star 数
- ★ 409
- 最近更新
- 6 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 想在预算内买面膜的消费者,用自然语言描述预算和肤感要求,让助手搜索候选并比较规格与价格。
- 不适合
- 需要购买非美妆及个人护理商品的用户
- 希望让代理直接完成授权和付款的用户
- 官网
- filtalgo.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16最新版本 v2.2.0(2026-11-16)
- 源码审查
- 75/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Filtmall Shopping 是筛电(Filtmall/Filtalgo)提供的购物技能,面向 AI 助手提供实时商品、同商品同规格价格证据,以及交易后的订单、物流和售后流程。仓库包含 SKILL.md、按需加载的 references/ 工作流说明、scripts/filtalgo.js 命令行包装器和打包运行时 assets/filtalgo-cli.cjs。助手通过 node scripts/filtalgo.js <command> --json 调用商品与交易服务,返回结构化结果,并可将商品、授权、付款和订单页面交给用户打开。当前商品目录侧重美妆和个人护理,账户授权、订单确认及付款由买家完成。适合希望在一次对话中从选品延伸到订单跟进的用户;如果需要更广的商品品类或无人参与的付款流程,则不太适合。
技能将自然语言购物需求交给 search 命令,在筛电实时目录中查找候选商品,并提供价格、规格、库存、商品详情及适配需求的信息;有同规格外部价格证据时,还能显示来源平台、记录时间和节省比例。用户选定商品后,可用购物车或隔离的单 SKU BUY_NOW 流程继续购买,通过 checkout create 创建结账,并用 checkout prepare-payment 生成桌面网页或移动 H5 付款链接。认证流程使用 OAuth Device Flow;后续命令可查询订单与物流、管理地址、取消符合条件的订单或进入售后流程。涉及账户或交易数据的操作应先征求用户同意,授权和付款等页面由买家打开并确认。
- 想在预算内买面膜的消费者,用自然语言描述预算和肤感要求,让助手搜索候选并比较规格与价格。
- 需要核实优惠是否对应同款同规格的买家,查看外部价格、来源平台和记录时间再决定是否购买。
- 已选好商品的用户,通过购物车或单 SKU 的
BUY_NOW流程继续到结账,并自行打开付款链接。 - 付款后不确定订单是否成功的买家,查询订单状态及订单明细。
- 等待包裹或需要处理符合条件的订单的用户,查询物流、管理收货地址、取消订单或发起售后。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g
- 运行环境
- Node.js 18
如何安装或部署这个 Agent?
需要 Node.js 18 或更高版本。技能自带 CLI 运行时,安装不需要单独运行 npm install。支持 skills 安装命令的环境可执行:
npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g支持导入文件夹或 ZIP 的客户端也可直接导入仓库根目录。README 未列出适用客户端的完整清单。
如何使用这个 Agent?
先检查运行环境,再搜索实时商品:
node scripts/filtalgo.js doctor --json
node scripts/filtalgo.js search "想要保湿一点的面膜,预算 100 元以内,但别太黏" --json需要账户的操作从 OAuth Device Flow 登录开始:
node scripts/filtalgo.js auth login
node scripts/filtalgo.js auth status --json例如,将商品加入购物车并创建结账:
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付款由买家在生成的链接中完成。查询订单和物流可运行:
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完整命令列表:
node scripts/filtalgo.js help这个 Agent 有哪些优点和局限?
- 将商品搜索、购物车、结账、订单、物流和售后连接在一个购物流程中。
- 搜索结果包含实时价格、规格和库存等结构化信息,便于助手比较商品。
- 同规格价格优势有条件展示,并可附带来源平台、记录时间和节省比例作为依据。
- 提供持久购物车和单 SKU
BUY_NOW两种购买路径,并可生成桌面或移动付款链接。
- 当前商品目录侧重美妆和个人护理,其他品类的覆盖情况没有说明。
- 需要 Node.js 18 或更高版本及对筛电商品和交易服务的网络访问。
- 账户授权、订单确认和付款需要买家参与,不能由助手独立完成。
- 价格会因账户、地区、会员身份和促销活动而变化;所述价格优势不保证适用于每位买家。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Filtmall 智能购物 当前 | 75 · 表现良好 | Agent 插件 / 技能 | ★ 409 | 6 天前 | Python | — |
| AIBot:Minecraft 自主玩家 | 62 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 141 | 2 个月前 | Java | OpenAI API |
| Nuclear 音乐播放器 | 45 · 缺口较多 | 桌面应用免费 | ★ 19k | 3 天前 | TypeScript | Codex · Claude Code |
| Best of AI 工具目录 | 43 · 缺口较多 | 网页应用免费 | ★ 774 | 5 天前 | HTML | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
材料说明 Skill 通过公开访客 API 委托服务端 Agent,访客身份与会员授权分开,且写操作须用户明确确认,因此权限边界和外部效果控制有较强依据。宿主生成会话标识、凭据与未结算请求存于私有状态目录且不进消息或日志,但所给源码未展示加密、保留期限或状态目录权限细节,故最小权限和敏感数据保护未满分。状态可 clear,未知结果须 resume,提供有限恢复路径;未说明交易撤销保证。商品证据仅称返回可核验时展示,没有足够来源归属细节;依赖为标准库且无需额外安装,但未见锁定或漏洞管理材料。
README、SKILL 和测试样本对生产环境、确认、恢复及状态语义大体一致;本包是客户端并依赖远端 Control、托管 Agent、业务服务和授权页面,服务可用性不受包内控制。明确列出超时、未知结果、待处理输入、无公开响应等状态及恢复步骤;测试文件提供离线替身测试样例,但未执行,也不据此判定运行正确性。
说明面向自然语言购物、比较、订单与售后,并限定当前以美妆个护为主;明确排除其他平台下单、全网最低价承诺及脱离购物场景的医疗任务。触发条件具体,包含平台不明账户短句先澄清、严重过敏时安全拦截。提供单次和常驻模式、Python 版本、widget/html/md 展示选项;仍依赖宿主 stdin、文件读取和相应 HTML 展示能力,环境适配不完整。
文件目录、协议参考、安装和调用说明层次清晰,示例覆盖请求、格式、恢复与宿主集成;Apache-2.0 元数据与许可证文件相符。包复制安装和 npx 安装均有说明,但目标宿主的状态目录配置及安装来源核验有限。名称与版本元数据可见,然而未提供变更记录;维护责任和更新响应路径没有明确说明,发布者身份按题设未知。
JSON 应答配合 answer_file、商品卡片和购物车产物,支持多种展示格式,并有购物车状态不可用时先查询、未知结果不重发等实用流程,日常宿主消费较明确。核心价值是将选品、价格证据和交易委托整合到自然语言会话;实际价格证据与交易工具依赖远端服务,材料未证明覆盖范围或经济收益。Python 标准库减少安装成本,但外部服务依赖、轮询等待及宿主文件处理增加接入成本。
材料将价格、库存和订单结果限定为服务实际响应,并声明不补造缺失数据;提供公开协议链接、请求状态、产物字段和带模拟传输的测试样本,能追踪部分行为。README 与 SKILL 在访客 API、确认、恢复和格式方面互相印证,但详细实现与协议正文未包含在样本中,跨源佐证有限。事实响应与不可承诺事项有所区分,不过“可核验价格证据”如何核验、来源和时间如何呈现并未在所给材料中具体说明。
- 这是静态审阅,置信度为低;未执行源码或测试,测试样例不构成运行验证。
- 商品比价依赖远端服务返回的证据;材料不承诺全网覆盖或最低价,使用前应查看证据范围与商品规格是否一致。
- 宿主应保护私有状态目录,并在超时或结果未知时按说明 resume 核对,避免重复提交交易操作。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2.2.0 Filtmall Shopping Skill v2.2.0
发布说明摘录
更新内容 - 增加正式版本自动检查和更新提醒;安装更新仍由用户通过原渠道操作。 - 完善会员授权后的原任务恢复、授权撤销及异常恢复,避免重复提交业务请求。 - 增强地址信息的号码脱敏,随包提供固定版本的离线号码库和许可证。 - 增加生产环境地区数据,完善地址解析、地址列表、物流和客服展示。 - 保留生产环境默认配置及中英文公开说明。 安装时请完整复制发布包,包括 third_party/。更新前请确认待处理请求已结束,并保留已有私有状态与本地定制。 验证:公开包 Python 离线测试 202 项通过。实际商品、会员授权和交易能力以部署环境及用户授权为准。在 GitHub 查看 ↗ -
v2.1.2 Filtmall Shopping v2.1.2
发布说明摘录
修复内容 - 将生产、pre、dev buyer 收银台链接转换为同环境 H5 收银台 /pages/mine/payment/payOrder。 - 按真实前端参数契约,将 paymentScene 与 orderSn 映射为交易 trade_sn、订单 order_sn 或充值 recharge_sn,保留追踪参数。 - 结算卡片、答复正文和 payment_links 共用转换;参数缺失或冲突的链接保持原样,避免改变支付对象。 - 保留已结束结算的付款入口屏蔽规则,更新版本为 2.1.2。 验证 - 已核对 uni 前端路由注册、history 模式及收银台参数读取代码。 - 客户端与渲染测试 67 项通过,独立包与客户端检查通过。 - 验证范围为源码契约与离线处理,未执行真实支付或部署前端。 完整变更:[v2.1.1...v2.1.2](https://github.com/filtalgo/Filtmall-Shopping-Skill/compare/v2.1.1...v2.1.2)。在 GitHub 查看 ↗ -
v2.1.1 Filtmall Shopping v2.1.1
发布说明摘录
修复内容 - 将已知生产、pre、dev buyer 域名下的购物车、订单列表和订单详情链接转换为同环境 m 端的对应路由,保留订单号及查询参数;正文和卡片使用一致规则。 - widget、HTML、Markdown 三种格式均移除结算卡片的“查看结算”入口,避免跳转错误页面。 - 保持支付、授权和其他未知链接原样;保留有效付款入口及已结束结算的付款屏蔽规则。 - 更新 Skill 使用说明,统一 SKILL.md、中英文 README 与 Release/tag 版本为 2.1.1 / v2.1.1。 验证 - 客户端与渲染测试 65 项通过,正式 Skill 包测试 7 项通过。 - 独立代码审查、验收及包校验通过;验证范围为客户端离线处理,不代表生产业务或宿主外链权限已验证。 完整变更:[v2.1.0...v2.1.1](https://github.com/filtalgo/Filtmall-Shopping-Skill/compare/v2.1.0...v2.1.1)。在 GitHub 查看 ↗
常见问题
安装后需要什么运行环境?
npm install。是否需要 Filtmall 账户?
助手可以替买家授权或付款吗?
价格优势是否适用于所有商品和用户?
如果买家出现过敏反应怎么办?
Filtmall 智能购物 官网是什么?
Filtmall 智能购物 开源吗?
Filtmall 智能购物 安全吗?
Filtmall 智能购物 还在维护吗?
Filtmall 智能购物 是谁开发的?
谢谢反馈,我们会据此改进页面。