← 返回 Skills 市场

Filtalgo Shopping

Name: Filtalgo Shopping
Author: microtobe

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

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install shopping-v2

功能描述

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 intend to use this skill for Filtalgo shopping and are comfortable granting it OAuth-backed access to cart, address, order, payment-preparation, and after-sale workflows. Before using it, treat any cart, checkout, address, cancellation, refund, or after-sale action as sensitive and confirm the exact action, item, address, order, and amount yourself.

能力标签

cryptorequires-walletrequires-oauth-tokenrequires-sensitive-credentials

能力评估

⚠ Purpose & Capability

The shopping, checkout, address, order, logistics, and after-sale capabilities are purpose-aligned for Filtalgo, but they include high-impact mutations such as cart changes, address create/update/delete, checkout/payment preparation, order cancellation/refund requests, and after-sale creation.

⚠ Instruction Scope

The activation text and default prompt are Filtalgo-scoped, but implicit invocation is enabled and the skill instructions do not consistently require explicit user confirmation before all state-changing commerce actions.

✓ Install Mechanism

The skill requires Node and runs a bundled CLI through a wrapper that blocks raw developer/API commands and secret-display/config override flags; no package installation behavior was found.

⚠ Credentials

Network access to the Filtalgo gateway and OAuth endpoints is expected for the purpose, but the first-run flow targets remote-dev and the bundle contains embedded OAuth client secrets for local/remote-dev profiles.

⚠ Persistence & Privilege

The CLI stores config and OAuth access/refresh tokens under the user's home directory with 0600 file modes, which is expected for OAuth login but still sensitive; embedded client secrets are also written into config on reset/load for those profiles.

如何使用

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

版本历史

v1.0.0

- Initial release of filtalgo-shopping skill, enabling shopping operations via the Agent Tool Gateway CLI. - Users can search, add to cart, checkout, pay via wallet, and track orders on Filtalgo. - Manage delivery addresses, cancel or refund orders, and access after-sale services for eligible purchases. - All operations are performed using the bundled Node.js CLI and output is returned in JSON format. - Access tokens and sensitive credentials are never shown in user-facing output.

元数据

Slug shopping-v2

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题