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 — шопинг-навык, созданный специально для агентов: он позволяет ИИ-агентам искать по актуальному каталогу Filtmall, показывать проверяемые доказательства цен и вести пользователя через оформление, заказы, доставку и послепродажное обслуживание косметики и товаров для личного ухода.
Это отдельное приложение или то, что использует агент?Это пакет-навык из агентных инструкций, справочников процессов и входящей в комплект CLI-обёртки, предназначенный для импорта в агентный клиент вроде Claude Skills или OpenClaw, а не отдельное приложение, которое вы открываете сами; торговый бэкенд Filtmall остаётся на сервере.
Нужно ли что-то, кроме агентного клиента?Требуется Node.js 18 или новее, а авторизованные действия вроде оформления заказа или поиска заказа начинаются со входа через OAuth Device Flow.
Может ли агент сам покупать или менять мой аккаунт?Нет, перед любым действием, меняющим аккаунт или транзакции, — очисткой корзины, удалением адреса, созданием оформления заказа или отменой заказа — он должен спрашивать, а ссылки авторизации и оплаты покупатель всегда открывает сам.
Что реально можно купить через него?Текущий каталог сосредоточен на косметике и товарах для личного ухода, продаваемых на Filtmall, а навык показывает ценовое преимущество, только когда актуальный результат содержит совпадающую спецификацию, платформу-источник и время фиксации.
Что происходит с моими учётными данными?Учётные данные, коды устройств, токены и идентификаторы сессий должны оставаться приватными, а шаги авторизации и оплаты навык оставляет за покупателем, не выполняя их сам.
Почему цены на Filtmall настолько ниже?Для некоторых проверенных товаров цены Filtmall могут опускаться примерно до одной трети публичной цены того же товара с той же спецификацией на крупном маркетплейсе, хотя реальная экономия зависит от аккаунта, региона, членства и акций.
Что можно попросить его сделать после настройки?Примеры промптов: найти нелипкую увлажняющую маску дешевле 100 юаней, сравнить два средства для чувствительной кожи, проверить, прошёл ли платёж, или найти последний заказ — поиск, поддержка решения и отслеживание после покупки в одном диалоге.
Кто стоит за Filtmall и этим навыком?Filtering Algorithm (Beijing) Technology Co., Ltd. управляет агент-ориентированной платформой электронной коммерции Filtmall (筛电) и публикует этот официальный навык под именем Filtalgo.
Creator
filtalgo
Size
0.4 MB
Stars
998
Age
4mo
Commits · 90 Days