/install shopping-v2
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 --body '{"currency":"CNY","line_items":[{"id":"\x3Csku_id>","quantity":1}],"totals":{"currency":"CNY","amount":\x3Cminor_units_amount>},"fulfillment_options":[{"id":"shipping","selected":true}],"capabilities":{"payment":{"handlers":[{"id":"wallet","requires_delegate_payment":false}]}}}' --json
node scripts/filtalgo.js checkout prepare-payment \x3Ccheckout_session_id> --handler wallet --json
checkout create must include the selected SKU as line_items[].id. Use the variant id returned by search, not the product title. totals.amount uses minor units, so CNY 120.00 is 12000.
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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install shopping-v2 - After installation, invoke the skill by name or use
/shopping-v2 - Provide required inputs per the skill's parameter spec and get structured output
What is Filtalgo Shopping?
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 a... It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.
How do I install Filtalgo Shopping?
Run "/install shopping-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Filtalgo Shopping free?
Yes, Filtalgo Shopping is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Filtalgo Shopping support?
Filtalgo Shopping is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Filtalgo Shopping?
It is built and maintained by Microtobe (@microtobe); the current version is v1.0.0.