filtalgo GitHub avatar

Filtmall-Shopping-Skill

Python
比价购物 Agent Skillfiltalgo最近推送 2026年11月16日
未分类Apache-2.01,1901504 issues7 天 +112

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

让 AI Agent 用自然语言完成选品、比价、下单和售后的购物技能包。

这是筛电(Filtalgo)提供的托管购物 Agent Skill,以 Python 脚本形式接入宿主 Agent。用户用自然语言提出需求后,Skill 通过 Control 公开会话接口把请求交给服务端托管购物 Agent,返回商品、价格、购物车、订单和物流等结果。商品信息、价格和库存以实际服务响应为准,会员操作需用户授权,写操作需用户确认。

推荐指数

3.0

适合想在 Agent 里接入完整购物链路的开发者,但依赖官方托管服务,需接受授权与数据边界约束。

近 7 天

+112

新增 Star

总 Star 排名

#3176

雷达追踪的 3,958 个 AI 仓库中

创建于

2026

2026年5月28日

核心亮点

  • 1全链路购物

    覆盖发现、比价、详情、购物车、下单、物流和售后。

  • 2三种展示格式

    支持 widget 内联片段、完整 HTML 页面和 Markdown 输出。

  • 3授权与确认

    会员操作需单独授权,写操作前须用户明确同意。

  • 4会话可恢复

    网络中断或结果未知时用 resume 核对原请求,避免重复提交。

  • 5地址隐私保护

    随包提供离线地区号码库,凭据存于宿主私有状态目录。

适用场景

  • 聊天机器人内嵌购物

    例如:用户在对话里说“推荐100元以内的面膜”,Agent 返回商品卡片。

  • 比价与规格对比

    例如:让 Agent 比较两款商品的规格和价格后再决定购买。

  • 订单与物流查询

    例如:用户询问某订单物流状态,Agent 调用 Skill 返回物流时间轴。

  • 售后处理

    例如:用户申请取消订单或发起售后,经确认后由 Skill 提交请求。

它是怎么工作的

  1. 第 1 步

    宿主接收需求

    宿主 Agent 把用户自然语言整理成一行 JSON 请求。

  2. 第 2 步

    调用 Skill 脚本

    通过 service.py 以单次调用或常驻服务方式提交请求。

  3. 第 3 步

    服务端编排

    Control 会话 API 将请求转给托管购物 Agent 执行。

  4. 第 4 步

    返回产物

    结果以 JSON 返回,正文和商品卡片写入指定文件路径。

  5. 第 5 步

    宿主展示

    宿主按 widget、html 或 md 格式读取文件并呈现给用户。

快速上手

  1. 1

    复制安装

    将目录完整复制到宿主 Skill 目录,命名为 filtmall-shopping,需 Python 3.10+。

  2. 2

    单次调用

    从标准输入传入一行 JSON,指定对话标识和需求文本。

    python3 "<skill-dir>/scripts/service.py" --once --format widget
  3. 3

    发送请求

    format 可选 widget、html 或 md,结果通过 JSON 返回文件路径。

    {"conversation":"<宿主生成的对话标识>","text":"推荐100元以内的面膜,只查询。"}
  4. 4

    读取产物

    正文读 answer_file,商品读 fragment_file、page_file 或 html_file。

适合谁

  • 在 Agent 产品中集成购物能力的开发者
  • 需要自然语言选品和比价场景的团队
  • 使用 Qoder 等支持 HTML 内联展示的宿主

不太适合

  • 希望完全离线自建购物服务的开发者
  • 不愿接入第三方托管服务的项目

成熟度

  • 活跃度2026 年 5 月创建,11 月仍有推送,版本已到 2.2.0。
  • 文档README 详细,另有 SKILL.md 和协议文档,但内容偏长。
  • 社区约 1192 star、151 fork,开放 issue 仅 4 个。
  • 上手难度复制即装无需额外依赖,但请求格式和产物路径规则较复杂。

使用前注意

  • · 依赖筛电官方托管服务,商品和价格以服务响应为准。
  • · 默认使用生产环境,会员操作需用户单独授权。
  • · 复制安装时须保留 third_party/ 离线号码库,否则地址隐私校验失效。
  • · 支付和退款状态只以业务服务实际结果为准,完成状态不代表付款成功。

主题标签

agent-skillsai-agentecommerceopenclawproduct-searchshoppingfiltalgofiltmallskillsmpclaude-skills