Filtalgo Shopping

该 Skill 指导使用内置 Node CLI（scripts/filtalgo.js）与 Filtalgo 的 Agent Tool Gateway 交互：先登录授权并自检，再完成商品搜索、购物车加购、结算与钱包支付链接生成、订单与物流查询、收货地址增删改、订单取消/退款及退货退款售后申请，结果以 JSON 返回，支付由用户在购买页完成。

bvcg204

热度 43.75

最近更新 2026-05-18 11:52:43

分类：生活依赖：代码执行 / 第三方 API应用场景：购物 / 推荐 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add filtalgo-shopping

Metadata

name: filtalgo-shopping
description: Use this skill when a user wants to browse, compare, buy, pay for, query orders, track logistics, manage addresses, cancel/refund eligible orders, or apply after-sale service on Filtalgo through the bundled Agent Tool Gateway CLI.
version: 0.2.0
metadata: {"openclaw":{"requires":{"bins":["node"]}}}

Filtalgo Shopping

Use the bundled CLI with node scripts/filtalgo.js. It talks only to the protocol-adapter Agent Tool Gateway and does not call service, UCP, or ACP endpoints directly.

First Run

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

The current MVP endpoint and OAuth client are built into this bundled CLI. Do not print access tokens, refresh tokens, or client secrets in user-facing output.

This is an internal beta release. The live catalog is intentionally small and currently focuses on sunscreen products, so prefer queries such as 防晒 or 防晒霜 during demos.

Shopping Flow

node scripts/filtalgo.js search "防晒霜" --json
node scripts/filtalgo.js cart clear --confirm --json
node scripts/filtalgo.js cart add-item --sku-id <sku_id> --quantity 1 --json
node scripts/filtalgo.js checkout create --json
node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --handler wallet --json

checkout create automatically reads the selected cart items and creates a payment-ready checkout session. Use the variant id returned by search when adding items to the cart.

Give the user the returned payment_url so they can complete wallet payment in the buyer page. After payment, use:

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

Addresses And Order Changes

node scripts/filtalgo.js address list --json
node scripts/filtalgo.js address create --name <name> --mobile <mobile> --region-path <path> --region-id-path <ids> --detail <detail> --json
node scripts/filtalgo.js address update <address_id> --name <name> --mobile <mobile> --region-path <path> --region-id-path <ids> --detail <detail> --json
node scripts/filtalgo.js address delete <address_id> --confirm --json
node scripts/filtalgo.js order cancel <order_sn> --confirm --json

order cancel supports unpaid order cancellation and paid-undelivered full refund application, matching the current service behavior.

After-Sale

Supported service types are RETURN_MONEY and RETURN_GOODS. Do not request EXCHANGE_GOODS in the current version.

node scripts/filtalgo.js aftersale apply-info --order-sn <order_sn> --order-item-sn <order_item_sn> --json
node scripts/filtalgo.js aftersale reasons --service-type RETURN_GOODS --json
node scripts/filtalgo.js aftersale create --order-sn <order_sn> --order-item-sn <order_item_sn> --service-type RETURN_GOODS --reason <reason> --problem-desc <desc> --apply-refund-price <amount> --json