filtalgo/Filtmall-Shopping-Skill

Agent-native shopping for extreme value: verifiable same-product price evidence, checkout, orders, delivery, and after-sales.

Filtmall Shopping Skill – エージェントネイティブなEコマース

概要

AIエージェント（OpenAI互換エージェントなど）がFiltmallマーケットプレイスから実際の製品を閲覧、比較、購入できるようにするNode.jsベースの skill です。
「エージェントネイティブ」な利用を想定して設計されており、LLMが推論を行い、発見からチェックアウト、アフターサービスに至るまで会話のコンテキストを維持できるよう、構造化データ（価格、スペック、在庫、タイムスタンプ）を返します。

主な機能

ステージ	スキルの役割
発見	自然言語のリクエスト（例：「100元以下の保湿フェイスマスク」）を、Filtmallカタログからのリアルタイムな製品候補に変換します。
決定	価格、スペック、在庫の並列比較を提供し、公開マーケットプレイスでの同一スペック価格との比較により、節約率を表示します。
購入	アイテムを永続的なカートに追加するか、CLIコマンドを介して単一SKUの `BUY_NOW` フローを実行します。
支払い	ユーザーがブラウザで開いて支払いを完了するための、購入者向けのチェックアウトリンク（デスクトップWebまたはモバイルH5）を生成します。
フォローアップ	エージェントが注文の照会、配送状況の追跡、住所管理、対象注文のキャンセル、アフターサービスワークフローの開始を行えるようにします。

仕組み

エージェントは単一のCLIエントリーポイント (node scripts/filtalgo.js <command> --json) を呼び出します。
CLIはFiltmallのバックエンドサービス（カタログ、カート、チェックアウト、注文、物流）と通信し、JSON結果を返します。
スキルパッケージには、CLIランタイム、エージェント側の指示ファイル (SKILL.md, agents/openai.yaml)、および skills.sh マーケットプレイス用のメタデータが含まれています。

インストール

# skills.sh エコシステムを介したワンラインインストール
npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g

Node.js 18+ が必要です。
リポジトリにCLIランタイムがバンドルされているため、個別の npm install は不要です。

典型的なエージェントプロンプト

発見：「100元以下で、ベタつかない保湿フェイスマスクが必要です。」
決定：「1番目と3番目の製品を比較して、どちらが敏感肌に適しているか説明してください。」
取引：「支払いは完了しましたか？」/「最新の注文はどこにありますか？」

安全性とユーザー制御

このスキルは、ユーザーの明示的なリクエストなしに支払いを行ったり、アカウントを変更したりすることはありません。
すべての認証情報、デバイスコード、トークンは非公開に保たれます。
エージェントは、ユーザーがブラウザで開くためのURL（チェックアウト、注文詳細、アフターサービス）を提示する必要があります。
健康関連の苦情（アレルギー反応など）については、スキルはフローを停止し、専門的なケアを推奨します。

開発者向けクイックスタート

# ランタイムの確認とライブカタログの検索
node scripts/filtalgo.js doctor --json
node scripts/filtalgo.js search "想要保湿一点的面膜，预算 100 元以内，但别太黏" --json

# 認証済みアクションのための OAuth デバイスフロー
node scripts/filtalgo.js auth login
node scripts/filtalgo.js auth status --json

# カートとチェックアウトの例
node scripts/filtalgo.js cart add-item --way CART --sku-id <sku_id> --quantity 1 --json
node scripts/filtalgo.js checkout create --way CART --json
node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --link-channel mobile_h5 --json

# 注文と物流の照会
node scripts/filtalgo.js order list --page-size 5 --json
node scripts/filtalgo.js logistics get <order_sn> --json

技術スタック

ランタイム: Node.js 18+ (バンドルされたCLIランタイム assets/filtalgo-cli.cjs)。
インターフェース: JSONエンコードされたコマンドを公開するコマンドラインラッパー (scripts/filtalgo.js)。
エージェント統合: skills.sh 形式をサポートするプラットフォームでスキルを発見可能にするメタデータファイル (SKILL.md, agents/openai.yaml)。

リポジトリ構成

SKILL.md                # エージェントの指示とトリガーのメタデータ
references/            # オプションのワークフロールールファイル
scripts/filtalgo.js    # 軽量CLIラッパー (エントリーポイント)
assets/filtalgo-cli.cjs# バンドルされたCLIランタイム
agents/openai.yaml     # OpenAI互換スキル記述
skills.sh.json         # skills.sh マーケットプレイスのメタデータ
CHANGELOG.md           # リリースノート
README.*               # ドキュメント (EN & CN)

想定される用途

会話を中断することなく、ユーザーが美容・パーソナルケア用品を購入できるようにする必要があるAIアシスタント製品を構築する開発者。
中国市場のEコマースカタログをLLM駆動のチャットボットに統合する企業。
ライブコマースを含むエンドツーエンドのエージェントワークフローを研究する研究者。

制限事項

カタログは現在、美容およびパーソナルケア製品に焦点を当てており、より広範なカテゴリはまだカバーされていません。
支払いおよびアカウント操作には、ユーザーがブラウザリンクを開く必要があります。スキルは認証情報を直接処理しません。
価格優位性の主張はFiltmallからのライブデータに依存しており、地域、会員レベル、プロモーションによって異なる場合があります。

結論: Filtmall Shopping Skill は、AIエージェントがFiltmallプラットフォームからのライブデータを使用して、製品の発見、比較、チェックアウト、購入後のサポートという完全なEコマースフローを実行できるようにする、具体的で本番環境対応のコンポーネントです。すべてがエージェントがJSONコマンドで呼び出せるシンプルなNode.js CLIにラップされています。

filtalgo/Filtmall-Shopping-Skill

Filtmall Shopping Skill – エージェントネイティブなEコマース

関連