Filtmall-Shopping-Skill README

The project's README from github.com/filtalgo/Filtmall-Shopping-Skill. As one markdown file: README.md.

Filtmall Shopping

中文说明 · Official website

skills.sh Version Node.js Agent Skill

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

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

Stage User outcome
Discover Turn a natural-language request into live product candidates from Filtmall
Decide Compare price, specification, stock, product details, and fit for the stated need
Buy Continue through a persistent cart or an isolated single-SKU BUY_NOW flow
Pay Generate a buyer-facing checkout link for desktop web or mobile H5
Follow up Query orders and logistics, manage addresses, cancel eligible orders, and enter after-sales workflows

Why Filtmall is agent-native

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

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

Filtmall-Shopping-Skill (filtalgo/Filtmall-Shopping-Skill)

Searching Database…

这是什么?Filtmall Shopping 是一个智能体原生的购物技能,让 AI 智能体搜索 Filtmall 的实时商品目录、展示可验证的价格证据,并引导用户完成美妆个护产品的结账、订单、配送和售后。
这是独立应用,还是智能体使用的东西?它是一个技能包,包含智能体指令、工作流参考和自带的 CLI 封装,用于导入 Claude Skills 或 OpenClaw 风格的智能体客户端,而不是你自己打开的独立应用;Filtmall 的电商后端保留在服务器端。
除了智能体客户端,我还需要什么吗?需要 Node.js 18 或更高版本;结账、订单查询这类需要身份验证的操作,会先通过 OAuth Device Flow 登录。
智能体能自作主张买东西或改动我的账号吗?不能。任何会改动账号或交易的操作——比如清空购物车、删除地址、创建结账、取消订单——都必须先征得同意,而且授权和支付链接始终由买家自己打开。
通过它我实际能买什么?目前的商品目录聚焦于 Filtmall 在售的美妆个护产品,而且只有当实时结果包含对应的规格、来源平台和记录时间时,技能才会展示价格优势。
我的登录信息会被怎么处理?凭据、设备码、令牌和会话标识都应保持私密,技能会把授权和支付环节留给买家自己完成,而不是代为处理。
Filtmall 的价格为什么低这么多?对于部分经过核验的商品,Filtmall 的价格可以低至某大型电商平台上同商品同规格公开价格的三分之一左右,不过实际能省多少因账号、地区、会员和促销活动而异。
配置好之后我能让它做什么?示例指令包括:找一款 100 元以下不粘腻的保湿面膜、比较两款适合敏感肌的产品、确认支付是否成功、查找最新订单等,在一次对话里覆盖商品发现、决策支持和购后跟踪。
Filtmall 和这个技能是谁做的?筛选算法(北京)科技有限公司运营 Filtmall(筛电)这个智能体原生电商平台,并以 Filtalgo 的名义发布这个官方技能。
Creator
filtalgo
Size
0.4 MB
Stars
953
Age
4mo
Commits · 90 Days