filtmall-shopping-skill

Filtmall Shopping

中文说明 · Official website

Agent-native shopping, built for extreme value.

Filtmall Shopping is the official shopping skill from 筛电 (Filtmall/Filtalgo). It gives AI agents live products, same-product and same-specification price evidence, checkout, orders, delivery, and after-sales in one shopping flow. A user can start with one sentence; the agent can find a better-fit product, show where the price advantage comes from, and continue through the transaction when asked.

The current catalog focuses on beauty and personal care. Account authorization, order confirmation, and payment stay with the buyer.

Price advantages with clear boundaries

Filtmall products are often the lowest-priced option online. For some verified products, Filtmall prices can be as low as about one-third of a public price for the same product and specification on a major marketplace. Actual prices vary with account, region, membership, and promotions. The skill shows a price advantage only when the live result includes the matching specification, source platform, and recorded time.

Install

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

Node.js 18 or later is required. The skill ships with its CLI runtime, so installation needs no separate npm install.

Clients that support folder or ZIP imports can import the repository root directly.

Try it

• “I need a moisturizing facial mask under ¥100 that does not feel sticky.”
• “Compare the first and third products and explain which one fits sensitive skin better.”
• “Did my payment go through?”
• “Where is my latest order?”

The first two prompts exercise product discovery and decision support. The last two continue the shopping journey through order and logistics queries.

What it helps with

Why Filtmall is agent-native

• Products that agents can reason over. Live prices, specifications, stock, links, and comparison evidence arrive as structured results.
• One conversation, one shopping journey. Product discovery, purchase, delivery, and after-sales share the same context.
• Extreme value with visible proof. Recommendations can show the external same-specification price, source platform, recorded time, and saving percentage.
• Buyer-controlled account and payment steps. The agent handles repeatable operations; the buyer opens authorization and payment pages and confirms consequential actions.

How it works

flowchart LR
    U["Natural-language request"] --> A["AI agent"]
    A --> S["Filtmall Shopping Skill"]
    S --> F["Filtmall catalog and transaction services"]
    F --> A
    A --> H["Product, authorization, payment, and order pages"]

The agent uses one command interface:

node scripts/filtalgo.js <command> --json

The bundled CLI connects the agent to Filtmall's product and transaction services. The repository contains the agent instructions, workflow references, wrapper, and bundled runtime; Filtmall's commerce infrastructure remains server-side.

Safety and user control

• Ask before changing account or transaction data, including clearing a cart, deleting an address, creating checkout, cancelling an order, or starting after-sales service.
• Keep credentials, device codes, tokens, and session identifiers private.
• Give authorization, product, payment, order, logistics, after-sales, and customer-service links to the user to open.
• Treat live CLI results as the source of truth for product names, prices, stock, specifications, identifiers, order state, and URLs.
• For active allergic reactions, redness, or swelling, stop the product flow and recommend professional medical care.
• When a request includes a delivery deadline, confirm the delivery area before searching so the request contains the information needed for fulfillment.

Developer quick start

Check the runtime and search the live catalog:

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

Authenticated flows start with OAuth Device Flow:

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

Continue through cart and 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

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

Run node scripts/filtalgo.js help for the complete command list.

Repository layout

SKILL.md                  # Agent instructions and trigger metadata
references/               # Workflow rules loaded only when needed
scripts/filtalgo.js       # Thin CLI wrapper
assets/filtalgo-cli.cjs   # Bundled CLI runtime
agents/openai.yaml        # Skill display metadata
skills.sh.json            # skills.sh presentation metadata
CHANGELOG.md              # Version history
README.md                 # English documentation
README.zh-CN.md           # Chinese documentation

About Filtmall

Filtering Algorithm (Beijing) Technology Co., Ltd. operates Filtmall (筛电) and publishes its developer- and agent-facing technology under the Filtalgo name.

Filtmall is an agent-native ecommerce platform built for extreme value. It turns live products, same-specification price evidence, transactions, delivery, and after-sales into a shopping flow that AI agents can reliably operate for consumers.

Filtmall website · About Filtmall · Releases · LLM reference · Machine-readable service directory