← Back to Skills Marketplace
🔌

Filtmall Shopping

by FiltMall · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
45
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install filtmall-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 a...
README (SKILL.md)

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
Usage Guidance
Install only if you are comfortable letting an agent use your Filtalgo account for shopping workflows. Review cart, checkout, address, cancellation, refund, and after-sale actions before execution, avoid ambiguous shopping prompts, and treat the bundled dev OAuth secrets as exposed public configuration rather than private credentials.
Capability Tags
cryptorequires-walletrequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The artifacts coherently implement a Filtalgo shopping CLI for search, cart, checkout, order lookup, logistics, address management, cancellation/refund, and after-sale actions. These are expected for the stated purpose but are high-impact commerce capabilities.
Instruction Scope
The skill description is broad and agents/openai.yaml enables implicit invocation. Several mutating flows are exposed, and address create/update plus checkout cancel do not require an explicit --confirm flag in the bundled CLI.
Install Mechanism
No package installation or remote installer is present. The skill requires Node and runs the bundled scripts/filtalgo.js wrapper, which restricts commands and blocks raw credential/config override flags.
Credentials
Network access to Filtalgo OAuth and Agent Tool Gateway endpoints is consistent with the shopping purpose. The default profile targets remote-dev endpoints and includes OAuth bootstrap client secrets, which is disclosed but weak for a distributed client.
Persistence & Privilege
The CLI stores OAuth access and refresh tokens under ~/.filtalgo with mode 0600 and can refresh them. This is normal for an OAuth CLI, but combined with commerce mutation authority and broad invocation it warrants user review.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install filtmall-shopping
  3. After installation, invoke the skill by name or use /filtmall-shopping
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the filtalgo-shopping skill (version 0.2.0). - Enables browsing, comparing, purchasing, payment, order query, logistics tracking, address management, order cancellation/refund, and after-sale service via the Filtalgo platform CLI. - All interactions are performed through the protocol-adapter Agent Tool Gateway CLI using bundled scripts. - Includes step-by-step CLI commands for the entire shopping flow, address operations, order changes, and after-sale requests. - Sensitive OAuth details are handled securely; tokens and secrets are not exposed in output.
Metadata
Slug filtmall-shopping
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Filtmall 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 45 downloads so far.

How do I install Filtmall Shopping?

Run "/install filtmall-shopping" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Filtmall Shopping free?

Yes, Filtmall Shopping is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Filtmall Shopping support?

Filtmall Shopping is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Filtmall Shopping?

It is built and maintained by FiltMall (@filtmall); the current version is v1.0.0.

💬 Comments