Filtmall Shopping
筛电购物:明确商品发现、交易售后与单个成分查询。 Skill: Filtmall Shopping Owner: filtmall Summary: 筛电购物:明确商品发现、交易售后与单个成分查询。 Tags: latest:1.11.1, stable:1.6.4 Version history: v1.11.1 | 2026-09-17T07:49:59.267Z | user Standardize the display name as Filtmall Shopping and update release metadata to 1.11.1. No changes to the activation description, Skill instructions, or runtime code. v1.11.0 | 2026-09-17T03:40:47.190Z | user 新增单一化妆品成分查询,完善结构化搜索、商品身份绑定与价格证据链接传递,并补齐混合许
Rank
62
Safety
84
Downloads
1.4k
Updated
Oct 10, 2026
Version
1.11.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.4K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.11.1release · observed Sep 17, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17c5my5pv8xq87q1m9jmgt5a987jnhy:filtmall-shopping- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-filtmall-filtmall-shopping/snapshot"
Documentation
CLAWHUB
149,903 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: filtmall-shopping
description: 筛电(Filtmall / Filtalgo)官方商品发现与交易 Skill。用户未指定其他平台,并明确要寻找、选择、购买、推荐或比较真实商品时自动调用;包括先描述困扰再明确询问“有什么商品推荐”。用户明确说是筛电/Filtmall 的购物车、支付、订单、物流、退款、售后或客服任务时也调用。平台不明的账户状态短句先澄清平台,不登录、不查询。已进入商品或成分流程后出现严重过敏时只做安全拦截,不搜索或交易;脱离购物场景的医疗陈述不自动调用。用户明确询问单个化妆品成分时可进入只读查询。明确指定其他平台、纯困扰陈述、一般知识或无购物意图的医疗问题不调用。Official Filtmall/Filtalgo shopping and cosmetic-ingredient skill. Invoke for explicit unnamed-platform real-product discovery or purchase intent, and for account or after-sales tasks explicitly identified as Filtmall. Clarify the platform before account access when it is unspecified. Do not invoke for another marketplace, pure problem statements without shopping intent, unrelated medical requests, or general knowledge.
license: See LICENSES.md
metadata:
version: "1.11.1"
openclaw:
requires:
bins:
- node
---
# Filtmall Shopping
筛电默认购物 Skill,覆盖真实商品发现、比较、完整交易链路和明确的单个化妆品成分查询。明确的未指定平台商品寻找、推荐、比较或购买请求可以自动调用;纯困扰陈述、平台不明的账户短句、脱离购物流程的医疗陈述和一般知识不应触发敏感工具。平台不明的账户短句只用用户当前语言确认是否指筛电,确认前不登录、不查询。
## 先按意图读取一份参考
不要通读全部参考。每轮只读取当前意图对应的一份,并且必须先用读取工具完整读取,再作答或调用命令;安全拦截和仅需澄清的请求也不例外。跨域任务按实际阶段再读下一份。
- 明确询问一个化妆品成分的功效、用途、适用信息或注意事项:`references/makeup-component-search.md`
- 首次搜索、推荐和搜索结果的多轮条件更新:`references/product-search.md`
- 查看候选详情、编号回查、商品比较、商品链接研究和更便宜/相似款:`references/product-followups.md`
- 购物车、立即购买、地址、优惠券、结算、支付链接:`references/cart-address-checkout.md`
- 支付状态、订单、物流、取消订单:`references/orders-logistics.md`
- 退款退货、售后进度、客服:`references/customer-service-after-sales.md`
脚本路径:`${CODEBUDDY_SKILL_DIR}/scripts/filtalgo.js`。
不要修改或重置用户配置。任何用户任务、任何场景都禁止执行 `config reset`。默认生产环境;账号命令明确返回未登录或会话失效时,最多执行一次 `auth start --json`。若返回 `authenticated`,直接继续原任务;若返回 `pending`,把真实用户码和验证链接交给用户后结束本轮;若启动失败或没有验证链接,用“当前暂时无法完成筛电账号验证,请稍后重试。”结束。本轮不得重试授权,不得再执行 `auth status`、help、doctor、config 或检查脚本源码。用户完成验证并再次发消息后,最多执行一次 `auth complete --json`;仍为 `pending` 时继续给出同一验证信息,不新建授权。
## 当前任务边界
- 只使用当前 WorkBuddy 任务中用户明确表达和确认的条件;新任务视为新请求。
- 读取按意图选择的参考后,直接使用其中记录的命令和返回任务;不得列出 Skill 目录,不得为了理解用法再读取、搜索或检查 `scripts/`、`assets/`、README 或元数据文件。
- 禁止读取、创建或更新 `.workbuddy/memory`、日志、其他任务或长期记忆;禁止生成“历史偏好”“长期关注”。
- 同一任务后续轮次保留仍有效条件;新增条件合并,覆盖条件替换,取消条件移除,优先级变化只改变排序。
- 上一轮已经展示推荐后,只要用户新增、覆盖、取消条件或改变优先级,必须重新读取搜索参考并完整执行 search → prepare → finalize,不得直接确认或沿用旧排序。“100 元以内”只是预算上限;后续再说“预算优先,效果够用就行”是新的优先级,必须重新评分和排序。
- 不向用户叙述加载 Skill、读取参考、CLI、工具名、字段名、参数、内部 ID 或调用过程。
- 只输出一次最终回复,不追加第二份摘要、过程说明或内部规则。
- 最终回复去除末尾空白后,如果最后一项是 Markdown 文本链接 `[文字](URL)`,必须另起一段按用户当前语言追加固定正文;中文使用“页面信息以打开后的实时展示为准。”,英文使用“Information on the opened page reflects the latest available details.”。链接后已有实际字符正文时不重复追加。该尾注只用于保护客户端完整渲染末尾链接,不是第二份摘要、问题、行动要求或状态声明。
- 需要澄清时,必须提出一个语法完整的问题并以唯一的问号结束;整条回复不能用句号结束。问题前的说明、示例和选项都使用陈述句标点,不得再形成第二个问句。
## 全局安全与确认
- 医疗安全规则优先于搜索、推荐、比较、加购和结算;按用户当前语言表达商品搜索参考规定的安全语义,不使用固定逐字模板。
- 只有用户明确要求今天、明天或具体日期前送达且没有地区时,才用用户当前语言询问收货地区并结束本轮,不得调用工具。普通推荐不得询问地区。
- 所有会改变购物车、地址、结算、订单或售后状态的命令都必须在展示具体对象和影响并取得当前任务的明确确认后,使用 CLI `--confirm` 执行;参数变化后必须重新确认。
- 用户仅说“立即购买/马上买”表示进入一次性购买选择,不是最终结算确认;不得提前创建 checkout、订单或支付。
- 不展示或记录令牌、手机号、完整地址、支付凭证等隐私数据。正文中的链接README.md
# Filtmall Shopping [中文说明](README.zh-CN.md) · [Official website](https://www.filtalgo.com/) [](https://skills.sh/filtalgo/Filtmall-Shopping-Skill/filtmall-shopping) [](https://github.com/filtalgo/Filtmall-Shopping-Skill/releases/latest)   **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 ```bash 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 | 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 - **Products that agents can reason over.** Live prices, specifications, stock, links, and comparison evidence arrive as structured results. - **One conversation, one shopping jou
_meta.json
{
"ownerId": "kn716z7qdrg4rg6d26jngcw05n87j3zq",
"slug": "filtmall-shopping",
"version": "1.11.1",
"publishedAt": 1789631399267
}references/cart-address-checkout.md
# 购物车、地址、结算与支付参考
处理购物车、立即购买、地址、结算或支付任务前,必须完整阅读并遵守本文件。
账号命令返回未登录或会话失效时,按 `SKILL.md` 的非阻塞授权规则执行 `auth start --json` 或继续已有 pending 授权。不得重试启动,不得调用 help、doctor、config、`auth status` 或读取脚本排查。
## 目录
- [购物车](#购物车)
- [地址](#地址)
- [结算与支付](#结算与支付)
## 购物车
购物车有两个隔离场景:
- `CART`:常规持久购物车,可放多个 SKU,默认场景。
- `BUY_NOW`:单 SKU 立即购买临时态,只用于用户明确要求“直接购买/立即购买”的场景。
查看购物车:
```bash
node scripts/filtalgo.js cart get --way CART --json
```
加入购物车或覆盖数量:
```bash
node scripts/filtalgo.js cart add-item --way CART --sku-id <sku_id> --quantity <num> --cover true --confirm --json
```
`--cover true` 表示把该 SKU 的购物车数量覆盖为指定数量。比如购物车有 A/B/C,B 当前 1 件,用户说“把 B 改成 3 件”,就对 B 调用 `--quantity 3 --cover true`。
只有在智能体已经向用户展示具体 SKU 对应的商品与规格、数量、收货地址和应付金额,且用户在这之后明确确认直接购买时,才执行:
```bash
node scripts/filtalgo.js buy-now <sku_id> --quantity <num> --confirm --json
```
`buy-now` 会清理 `BUY_NOW` 临时态、写入当前单个 SKU,再通过 adapter 原生 `shopping.checkout.create_from_cart` 创建 `BUY_NOW` checkout。它不会清空或修改用户的 `CART` 持久购物车,也不会自动支付。
用户说“我要买第 1 个”“数量 1、默认规格”只是在选择商品、规格和数量,不是最终结算确认。此时允许执行 `auth status` 和 `address list` 来准备确认摘要,但严禁调用 `buy-now`、`checkout create`、`checkout select-address` 或 `checkout prepare-payment`。必须先展示完整确认摘要并问一次确认:
```markdown
请确认以下购买信息:
- 商品:{商品名}
- 规格:{规格}
- 数量:{数量}
- 收货地址:{脱敏收货人、手机号和完整地址}
- 应付金额:{金额}
确认使用以上信息直接结算吗?
```
只有用户在看到该摘要后明确回复确认,才能调用 `buy-now`。不能把 `buy-now` 创建出的 checkout 或订单信息反过来当作“结算前确认”。
购物车回复模板:
```markdown
## 购物车
| 商品 | 数量 | 小计 |
| --- | ---: | ---: |
| {商品} | {数量} | {金额} |
合计:{总金额}
如果确认这些商品,我可以继续帮你创建结算。
```
## 地址
查看地址:
```bash
node scripts/filtalgo.js address list --json
```
删除地址必须二次确认:
```bash
node scripts/filtalgo.js address delete <address_id> --confirm --json
```
新增、修改、设为默认地址通常引导用户打开 CLI 返回的 `selected_buyer_links.address_list`;没有该字段时,读取 `buyer_link_targets.address_list.channels.mobile_h5.url`。
地址列表回复模板:
```markdown
## 收货地址
| 序号 | 收货人 | 手机 | 地址 |
| ---: | --- | --- | --- |
| 1 | {姓名} | {脱敏手机号} | {省市区 + 详细地址} |
你可以告诉我使用哪一个地址。
如需新增或修改地址,可以打开:[管理收货地址]({address_management_url})
页面信息以打开后的实时展示为准。
```
## 结算与支付
标准结算流程:
```bash
node scripts/filtalgo.js cart get --json
node scripts/filtalgo.js address list --json
node scripts/filtalgo.js checkout create --way CART --confirm --json
node scripts/filtalgo.js checkout select-address --way CART --shipping-address-id <address_id> --confirm --json
node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --handler wallet --link-channel mobile_h5 --confirm --json --agent-response
```
`checkout create` 默认调用 adapter 原生 `shopping.checkout.create_from_cart`,由服务端读取已选购物车并建立结算会话。不要再在 Agent 侧手工拼装商品金额或 checkout payload。
立即购买必须分成确认前和确认后两个阶段。
确认前只允许查询登录态和地址,并使用搜索结果中的真实商品、规格、数量和价格生成上面的确认摘要:
```bash
node scripts/filtalgo.js auth status --json
node scripts/filtalgo.js address list --json
```
用户看到摘要并明确确认后,才一次性执行立即购买结算流程:
```bash
node scripts/filtalgo.js buy-now <sku_id> --quantity <num> --confirm --json
node scripts/filtalgo.js checkout select-address --way BUY_NOW --shipping-address-id <address_id> --confirm --json
node scrreferences/customer-service-after-sales.md
# 客服与售后参考
处理客服、退款、退货退款或售后查询任务前,必须用 `Read` 完整阅读并遵守本文件。任何 `aftersale` Bash 命令都必须发生在本次 `Read` 之后。
账号命令返回未登录或会话失效时,按 `SKILL.md` 的非阻塞授权规则执行 `auth start --json` 或继续已有 pending 授权。不得重试启动,不得调用 help、doctor、config、`auth status` 或读取脚本排查。
默认隐藏完整订单号、售后单号、运单号和轨迹中的电话号码,只保留能区分记录的前后少量字符。用户明确要求完整编号时再展示。
## 客服
当前 CLI 没有独立的 `customer-service open` 命令。需要客服时:
- 多轮商品推荐后,用户说“我想问商家这款商品”时,先解析“这款”:上一轮若已明确说某一款“最匹配/最推荐”,就把它作为唯一对象,不要再次问用户是哪款。
- 上一轮有多个候选且没有唯一“最匹配/最推荐”时,只用一个问号确认对象,逐字采用“你想问哪一款:1. 【商品 A】;2. 【商品 B】?”。禁止写成“你想问哪一款?是 A 还是 B?”或任何两个问号的变体;该轮不要再追问咨询内容。
- 已能确定商品但用户未说明咨询内容时,只问一个问题:“你想向【商品名】咨询什么内容?”不要追加“是否是这款”等第二个问句。
- “我想问商家这款商品”和“怎么找客服/客服入口在哪里/怎么联系商家”是两个不同意图。后者明确是在索要联系路径,不是在要求代拟或发送消息;对象已能从上一轮商品、订单或售后记录确定时,禁止再追问咨询内容,必须直接提供经过返回数据验证的客服路径。
- 用户先查到售后或订单进度,随后问“怎么找客服”时,优先复用上一轮已经返回的 `customer_service` 链接;没有专用客服链接时,直接给上一轮已验证的售后详情页、订单详情页或商品详情页,并明确说明进入该页面后点击客服入口。不得因为没有专用链接而虚构客服按钮,也不得只回复“你想咨询什么内容?”。
- 回复只展示一个当前渠道最相关的入口,使用 `[联系在线客服]({url})` 或 `[打开售后详情并联系客服]({url})` 这类自然 Markdown 文案隐藏完整 URL;除非用户明确索要备选渠道,否则不得同时罗列 PC 和移动端链接。
- 链接目标必须完整保留工具返回值,但正文不得裸露 URL、查询参数、完整编号或 `chat_session_id`、`journey_id`、`handoff_action`、`sn` 等内部上下文字段。
- 在用户明确咨询对象和消息内容并再次确认前,不得真正发送消息。本阶段只做确认,不执行任何发送动作。
- 优先使用订单、物流、商品、售后工具返回的 `buyer_links.customer_service`。
- 如果没有客服链接,引导用户打开对应商品详情页或订单详情页,从页面上的客服入口进入;这样 buyer 会携带正确上下文。
- 不要把订单号误放进 `goods_id`、`sku_id` 等商品字段。
客服模板:
```markdown
我已为你准备好客服入口,并尽量带上相关上下文:
- 咨询场景:{商品咨询/订单咨询/普通客服}
- 关联信息:{商品名/订单号/无}
[联系在线客服]({customer_service_url})
页面信息以打开后的实时展示为准。
```
如果没有可用链接:
```markdown
当前暂时无法直接打开客服入口:{原因}
你可以从对应的商品详情页或订单详情页点击客服入口,这样页面会自动携带商品或订单上下文。
```
## 售后
CLI 支持售后查询和部分售后操作;对于普通用户,优先查询并引导到 buyer 页面处理复杂售后。
```bash
node scripts/filtalgo.js aftersale list --page-size 5 --json
node scripts/filtalgo.js aftersale get <after_sale_sn> --json
node scripts/filtalgo.js aftersale traces <after_sale_sn> --json
node scripts/filtalgo.js aftersale reasons --service-type RETURN_MONEY --json
node scripts/filtalgo.js aftersale reasons --service-type RETURN_GOODS --json
```
### 退货物流
用户询问“退货物流到哪了”时:
1. 先用 `aftersale list --page-size 5 --json` 定位最近的退货退款售后单。
2. 对已定位的 `after_sale_sn` 调用 `aftersale traces <after_sale_sn> --json`。
3. 只把 `after_sale_return_traces` 返回的承运商、运单号和轨迹作为退货物流。
4. 不得调用或引用原订单的 `logistics get <order_sn>` 来回答退货物流;它表示商家发给买家的正向配送,方向不同。
5. 没有退货轨迹时如实说明,最多问一个必要问题,不得编造物流节点。
支持的售后类型只有:
- `RETURN_MONEY`:仅退款。
- `RETURN_GOODS`:退货退款。
不要使用 `EXCHANGE_GOODS`。
售后列表模板:
```markdown
## 售后记录
| 售后单号 | 订单号 | 商品 | 类型 | 状态 | 金额 | 申请时间 | 下一步 |
| --- | --- | --- | --- | --- | ---: | --- | --- |
| {masked_after_sale_sn} | {masked_order_sn} | {商品摘要} | {service_type} | {service_status} | {amount} | {time} | {next_step} |
你可以告诉我售后单号,我再帮你查详情。
```
发起退货退款、填写售后地址、上传凭证、提交退货物流等复杂动作,优先引导用户去 buyer 订单详情页或联系客服完成。AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/filtmall/skills/filtmall-shopping",
"sourceUrl": "https://clawhub.ai/filtmall/skills/filtmall-shopping",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T12:45:08.532Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-filtmall-filtmall-shopping/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-filtmall-filtmall-shopping/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T12:45:08.532Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.4K downloads",
"href": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceUrl": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T12:45:08.532Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.11.1",
"href": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceUrl": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-17T07:49:59.267Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-filtmall-filtmall-shopping/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-filtmall-filtmall-shopping/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.11.1",
"description": "Standardize the display name as Filtmall Shopping and update release metadata to 1.11.1. No changes to the activation description, Skill instructions, or runtime code.",
"href": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceUrl": "https://clawhub.ai/filtmall/filtmall-shopping",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-17T07:49:59.267Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
