Filtmall Shopping

Find products, check same-specification price evidence, and carry a shopping conversation through order follow-up.

Stars
★ 409
Last updated
6d ago
License
Apache-2.0
Primary language
Python

At a glance

How it runs
Agent plugin / skillCLI
Works with
Portable with changes
Setup effort
Low · running in minutes
You'll need
Node.js 18 or laterFiltmall account for authenticated flowsShell / CLINetwork accessLocal filesystem
Typical use
A shopper looking for a face mask within a budget can describe price and feel preferences in natural language, then compare candidate specifications and prices.
Not a fit if
  • Shoppers looking for categories beyond beauty and personal care
  • Users who need the agent to authorize or pay without buyer involvement
Website
filtalgo.com ↗ set on GitHub
Maintenance
Commits in the last 30 dayslast commit 2026-11-16latest release v2.2.0 (2026-11-16)
Source review
75/100 · Good

What does this agent do, and when should you use it?

Filtmall Shopping is a shopping skill from 筛电 (Filtmall/Filtalgo) that connects an AI agent to live products, same-product and same-specification price evidence, transactions, delivery, and after-sales. The repository includes SKILL.md, workflow references in references/, the scripts/filtalgo.js CLI wrapper, and its bundled runtime at assets/filtalgo-cli.cjs. The agent calls product and transaction services with node scripts/filtalgo.js <command> --json and receives structured results; product, authorization, payment, and order pages can be handed to the buyer to open. The current catalog focuses on beauty and personal care, and the buyer remains responsible for account authorization, order confirmation, and payment. It suits shoppers who want one conversation to cover product selection and order follow-up; it is a poor fit for broader catalog needs or fully unattended payment.

The skill passes natural-language shopping requests to the search command, which finds candidates in Filtmall's live catalog and returns information such as price, specification, stock, product details, and fit for the stated need. When same-specification external price evidence is available, results can show the source platform, recorded time, and saving percentage. After product selection, the flow can continue through a persistent cart or an isolated single-SKU BUY_NOW path, create checkout with checkout create, and generate a desktop web or mobile H5 payment link with checkout prepare-payment. Authenticated flows use OAuth Device Flow. Further commands can query orders and logistics, manage addresses, cancel eligible orders, or enter after-sales workflows. The buyer opens authorization and payment pages and confirms consequential actions; the skill asks before changing account or transaction data.

  1. A shopper looking for a face mask within a budget can describe price and feel preferences in natural language, then compare candidate specifications and prices.
  2. A buyer who wants to verify a deal can check whether the evidence matches the same product and specification, and review its source platform and recorded time.
  3. A shopper who has chosen a product can continue through the cart or single-SKU BUY_NOW checkout flow, then open the payment link themselves.
  4. A buyer unsure whether payment succeeded can query order status and order details.
  5. Someone waiting for a parcel or handling an eligible order can check logistics, manage delivery addresses, cancel an order, or start after-sales service.

Key setup facts

Pulled from the install and usage notes below. The project README has the current values.

Install / run
  • npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g
Runtime
Node.js 18

How do you install or deploy this agent?

Node.js 18 or later is required. The skill bundles its CLI runtime, so installation does not require a separate npm install. In an environment that supports the skills installer, run:

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

Clients that support folder or ZIP imports can also import the repository root. The README does not list all compatible clients.

How do you use this agent?

Check the runtime and search the live catalog:

node scripts/filtalgo.js doctor --json
node scripts/filtalgo.js search "I want a moisturizing face mask under ¥100 that does not feel sticky" --json

Authenticated flows start with OAuth Device Flow:

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

For example, add a product to the cart and create checkout:

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

The buyer completes payment through the generated link. To query orders and delivery:

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

For the full command list, run:

node scripts/filtalgo.js help

What are this agent's strengths and limitations?

Pros
  • Connects product discovery, cart, checkout, orders, logistics, and after-sales in one shopping flow.
  • Search results include structured live price, specification, and stock information for product comparisons.
  • Shows a price advantage only with matching-specification evidence, which can include source platform, recorded time, and savings percentage.
  • Supports both a persistent cart and a single-SKU BUY_NOW path, with payment links for desktop web or mobile.
Limitations
  • The current catalog focuses on beauty and personal care; coverage of other categories is not documented.
  • Requires Node.js 18 or later and network access to Filtmall product and transaction services.
  • The buyer must handle account authorization, order confirmation, and payment; the agent cannot complete those steps alone.
  • Prices vary by account, region, membership, and promotions, so a stated price advantage may not apply to every buyer.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
Filtmall Shopping This agent 75 · Good Agent plugin / skill ★ 409 6d ago Python —
AIBot for Minecraft 62 · Some gaps Self-hosted serviceFree + model costs ★ 141 2mo ago Java OpenAI API
Nuclear Music Player 45 · Major gaps Desktop appFree ★ 19k 3d ago TypeScript Codex · Claude Code
Best of AI Directory 43 · Major gaps Web appFree ★ 774 5d ago HTML —

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Good
75/ 100 5-point scale 3.8 / 5
This review covers the source as of Nov 08, 2026. The project has shipped 4 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 21/29
Reliability 9/14
Adaptability 16/18
Convention 14/18
Effectiveness 10/13
Verifiability 5/8
Why each dimension lost points
Trust21 / 29 · 3.6/5

The packet says the skill delegates through a public guest API, separates guest identity from member authorization, and requires explicit user confirmation for writes, supporting its permission boundaries and external-effect controls. It says the host creates conversation IDs and keeps credentials and unsettled requests in private state rather than messages or logs, but the supplied source does not show encryption, retention limits, or state-directory permissions, so least privilege and sensitive-data handling are not fully evidenced. Clearing state and resuming uncertain requests provide limited recovery; transaction reversal is not guaranteed. Price evidence is described as shown when verifiable, but source attribution is underspecified. The package uses the standard library and requires no extra dependencies, though dependency pinning and vulnerability management are not shown.

Reliability9 / 14 · 3.2/5

README, SKILL, and the test samples are broadly consistent about production use, confirmation, recovery, and state semantics. This client depends on remote Control, the hosted Agent, business services, and authorization pages, whose availability the package cannot establish. It names timeout, unknown result, pending input, and missing public response states with recovery guidance. Test files include offline transport substitutes, but they were not executed and are not treated as proof of runtime correctness.

Adaptability16 / 18 · 4.4/5

The instructions cover natural-language shopping, comparisons, orders, and after-sales, while limiting the current focus to beauty and personal care. They explicitly disclaim other-platform checkout and universal lowest-price coverage, and exclude medical tasks outside shopping. Trigger rules are specific, including clarification for ambiguous account requests and a safety stop for severe allergy in an active shopping flow. One-shot and persistent modes, a Python requirement, and widget/html/md output are documented; host stdin, file access, and compatible HTML rendering remain prerequisites.

Convention14 / 18 · 3.9/5

The directory map, protocol reference, install and usage instructions are clearly organized, with examples for requests, formats, recovery, and host integration. Apache-2.0 metadata matches the license file. Copy-based and npx installation are described, but host state-directory setup and installation-source verification are limited. Names and version metadata are present, but no changelog is supplied. Maintenance responsibility and update response path are unclear; publisher identity is unknown under the supplied rule.

Effectiveness10 / 13 · 3.8/5

JSON responses with answer, product-card, and cart artifacts support several display formats, and the guidance for unavailable cart state and uncertain results makes host consumption practical. The main value is combining discovery, price evidence, and delegated commerce in a natural-language flow; actual evidence coverage and transaction capability depend on remote services, and economic benefit is not demonstrated. The standard-library implementation lowers setup cost, while remote dependencies, polling, and host file handling add integration costs.

Verifiability5 / 8 · 3.1/5

The packet ties price, inventory, and order claims to actual service responses and says missing data is not fabricated. It provides a protocol reference, response states, artifact fields, and test samples with simulated transport, making some behavior traceable. README and SKILL corroborate guest API use, confirmation, recovery, and formatting, but detailed implementation and protocol contents are outside this sample, limiting cross-source support. It distinguishes service facts from claims it will not make, but the supplied material does not specify how price evidence is validated or how its source and timestamp are presented.

Risks and how to mitigate them
  • This is a static review with low confidence; source and tests were not executed, and test samples are not runtime verification.
  • Price comparisons depend on evidence returned by remote services. The packet does not promise full-web coverage or the lowest price; check evidence scope and product-variant match.
  • The host should protect the private state directory and follow the resume procedure after a timeout or unknown result to avoid duplicate commerce submissions.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 05c8e907d461 New commits since this review; the score may not cover them
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/filtmall-shopping-skill.svg)](https://followagents.com/en/agents/filtmall-shopping-skill)
<a href="https://followagents.com/en/agents/filtmall-shopping-skill"><img src="https://followagents.com/badge/filtmall-shopping-skill.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. v2.2.0 Filtmall Shopping Skill v2.2.0
    Release notes excerpt
    更新内容 - 增加正式版本自动检查和更新提醒;安装更新仍由用户通过原渠道操作。 - 完善会员授权后的原任务恢复、授权撤销及异常恢复,避免重复提交业务请求。 - 增强地址信息的号码脱敏,随包提供固定版本的离线号码库和许可证。 - 增加生产环境地区数据,完善地址解析、地址列表、物流和客服展示。 - 保留生产环境默认配置及中英文公开说明。 安装时请完整复制发布包,包括 third_party/。更新前请确认待处理请求已结束,并保留已有私有状态与本地定制。 验证:公开包 Python 离线测试 202 项通过。实际商品、会员授权和交易能力以部署环境及用户授权为准。
    View on GitHub ↗
  2. v2.1.2 Filtmall Shopping v2.1.2
    Release notes excerpt
    修复内容 - 将生产、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)。
    View on GitHub ↗
  3. v2.1.1 Filtmall Shopping v2.1.1
    Release notes excerpt
    修复内容 - 将已知生产、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)。
    View on GitHub ↗

FAQ

What runtime does installation require?
Node.js 18 or later. The CLI runtime is bundled, so no separate npm install is needed.
Do I need a Filtmall account?
The documented catalog search example can be run directly. Authenticated shopping flows start with OAuth Device Flow; the README does not state account fees or service pricing.
Can the agent authorize or pay on my behalf?
No. The buyer opens authorization and payment pages and confirms those steps. The skill also asks before changing account or transaction data.
Does the price advantage apply to every product and shopper?
Not necessarily. The skill shows an advantage only when live results include matching specification, source platform, and recorded time. Actual prices also vary by account, region, membership, and promotions.
What if I have an active allergic reaction?
Stop the product flow and seek professional medical care for an active allergic reaction, redness, or swelling.
Is Filtmall Shopping open source?
Yes. The source code is on GitHub (filtalgo/Filtmall-Shopping-Skill) under the Apache-2.0 licence.
Is Filtmall Shopping safe to use?
FollowAgents' FARS review (Nov 08, 2026) scored Filtmall Shopping 21/29 on trust and safety. None of the eight safety controls the review checks for was missing outright. The repository has changed since that review.
Is Filtmall Shopping still maintained?
Yes. The latest commit on GitHub is from 2026-11-16, within the last 30 days. The latest release is v2.2.0 (2026-11-16).
Who makes Filtmall Shopping?
Filtmall Shopping is published on GitHub by the account filtalgo. FollowAgents has not verified which person or company is behind that account.
What is Filtmall Shopping's official website?
The project's GitHub repository lists https://www.filtalgo.com/ as its website. That link is set by the repository owner; the source code itself is on GitHub (filtalgo/Filtmall-Shopping-Skill).
Was this page helpful?
View on GitHub ↗ Install ↓

Related concepts