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 config reset remote-dev
node scripts/filtalgo.js auth login
node scripts/filtalgo.js doctor --json

The remote-dev OAuth client id and bootstrap secret are built into the CLI profile for the current MVP. Do not print access tokens, refresh tokens, or client secrets in user-facing output.

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 \x3Csku_id> --quantity 1 --json
node scripts/filtalgo.js checkout create --json
node scripts/filtalgo.js checkout prepare-payment \x3Ccheckout_session_id> --handler wallet --json

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 \x3Corder_sn> --include-items true --json
node scripts/filtalgo.js logistics get \x3Corder_sn> --json

Addresses And Order Changes

node scripts/filtalgo.js address list --json
node scripts/filtalgo.js address create --name \x3Cname> --mobile \x3Cmobile> --region-path \x3Cpath> --region-id-path \x3Cids> --detail \x3Cdetail> --json
node scripts/filtalgo.js address update \x3Caddress_id> --name \x3Cname> --mobile \x3Cmobile> --region-path \x3Cpath> --region-id-path \x3Cids> --detail \x3Cdetail> --json
node scripts/filtalgo.js address delete \x3Caddress_id> --confirm --json
node scripts/filtalgo.js order cancel \x3Corder_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 \x3Corder_sn> --order-item-sn \x3Corder_item_sn> --json
node scripts/filtalgo.js aftersale reasons --service-type RETURN_GOODS --json
node scripts/filtalgo.js aftersale create --order-sn \x3Corder_sn> --order-item-sn \x3Corder_item_sn> --service-type RETURN_GOODS --reason \x3Creason> --problem-desc \x3Cdesc> --apply-refund-price \x3Camount> --json