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