← Back to Skills Marketplace
🔌

Filtalgo Shopping

by filtalgo · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ⚠ suspicious
48
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install shopping-v3
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 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.
Capability Tags
cryptorequires-walletrequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
⚠ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install shopping-v3
  3. After installation, invoke the skill by name or use /shopping-v3
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug shopping-v3
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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 48 downloads so far.

How do I install Filtalgo Shopping?

Run "/install shopping-v3" 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 filtalgo (@filtalgo11); the current version is v1.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments