← 返回 Skills 市场

🔌

Filtmall Shopping

Name: Filtmall Shopping
Author: filtmall

作者 FiltMall · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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

安全使用建议

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.

能力标签

cryptorequires-walletrequires-oauth-tokenrequires-sensitive-credentials

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install filtmall-shopping
安装完成后，直接呼叫该 Skill 的名称或使用 /filtmall-shopping 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug filtmall-shopping

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题