← 返回 Skills 市场

🔌

Filtalgo Shopping

Name: Filtalgo Shopping
Author: filtalgo11

作者 filtalgo · GitHub ↗ · v1.1.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install shopping-v3

功能描述

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 let this skill access your Filtalgo account and perform shopping actions. Review order, checkout, refund, and address changes before allowing the agent to run them, and avoid sharing or displaying full address and phone details unless necessary.

能力标签

cryptorequires-walletrequires-oauth-tokenrequires-sensitive-credentials

能力评估

⚠ Purpose & Capability

The shopping, OAuth, wallet, order, address, cancellation, refund, and after-sale capabilities fit the stated Filtalgo purpose, but they are high-impact commerce actions involving payments, orders, and personal address data.

⚠ Instruction Scope

The skill allows implicit invocation and provides broad shopping instructions; several mutating flows are documented or implemented without a clear final user confirmation requirement, including address create/update and checkout cancellation.

ℹ Install Mechanism

Installation requires Node and runs a bundled CLI through a small launcher. The launcher and bundled CLI restrict commands and block raw API/config override flags, which reduces but does not eliminate risk.

⚠ Credentials

The CLI stores OAuth access and refresh tokens under the user's home directory and sends authenticated requests to Filtalgo gateway endpoints. That is coherent for shopping, but sensitive enough to require careful user awareness.

⚠ Persistence & Privilege

Persistent credentials are written to ~/.filtalgo/credentials.json with restrictive file mode, and a built-in remote-dev OAuth client secret is included. The artifact discloses these, but they expand trust placed in the package.

如何使用

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

版本历史

v1.1.0

- Updated SKILL.md documentation with detailed CLI usage instructions for key shopping flows, including product search, cart, checkout, payment, and order queries. - Clarified flows for address management, order cancellation, refunds, and after-sale service, with command examples. - Specified that the CLI interacts only with the Agent Tool Gateway via node scripts. - Added important notes on input formats (e.g., minor units for currency) and restricted service types for after-sale applications. - No user-secret or token data is exposed in user-facing outputs.

元数据

Slug shopping-v3

版本 1.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题