Filtmall Shopping

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

Stars
★ 3k
Last updated
20d ago
License
Apache-2.0
Primary language
JavaScript

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

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.

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 Insufficient evidence Agent plugin / skill ★ 3k 20d ago JavaScript —
AIBot for Minecraft 83 · Good Self-hosted serviceFree + model costs ★ 154 1mo ago Java OpenAI API
Nuclear Music Player 53 · Major gaps Desktop appFree ★ 19k 1d ago TypeScript Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Insufficient evidence
Risks and how to mitigate them
  • Not found in source: least-privilege scopingGrant only what the task needs: a dedicated account or read-only token, scoped to specific directories and repos.
  • Not found in source: confirmation before actingTurn on (or add) a confirmation step before it acts, and try it in a sandbox or test environment before real data.
  • Not found in source: data-flow disclosureWatch which external services it contacts (proxy or firewall logs) and keep sensitive data out until you know where it goes.
  • Not found in source: sensitive-data handlingUse dedicated, low-privilege, revocable API keys — never production credentials — and keep secrets out of logs.
  • Not found in source: dependency securityPin versions and run a dependency audit (npm audit, pip-audit) before installing; prefer running it in a container.
  • Not found in source: disclosed external effectsEstablish which external systems it writes to, sends to or changes, and verify with test accounts or repos before production.
  • Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
  • Not found in source: verifiable attributionInstall from the official repo or registry and check the publisher and URL to avoid look-alike packages.
  • This assessment uses only the supplied README and LICENSE; referenced code and documentation that were not supplied were not reviewed.
  • Price advantages, transaction flows, and safeguards described in the README are project claims and do not establish actual behavior.
Evidence confidence: Low Reviewed Oct 08, 2026 Reviewed revision 9904c8df53c9
Review evidence README.mdLICENSE
See the full review method →

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.
View on GitHub ↗ Install ↓

Related agents