前言¶
做电商工具的开发者常会遇到一类需求:买家想找到合适的商家和商品、比价、跟卖家沟通、下单并追踪订单;商家想发布商品、管库存、回答买家提问、处理订单请求。这类对话式交易流程如果每个项目都从零写,成本很高。下面介绍的 Skill 试图把这套买卖双方的撮合流程封装成一个可复用的 agent,跑在 OpenClaw 和 Hermes 两个宿主上。
这是什么¶
mai 是一个 local-first(本地优先)的 AI 购物撮合 agent,定位为买卖双方之间的中间层:买家侧负责发现商家与商品、比价、与卖家沟通、读评价、创建可追踪的订单;商家侧负责发布商品、管理库存、回答买家问题、处理订单请求。
- 名称:mai
- 坐标:@user_15292d5a/yjkj-mai
- 版本:1.1.2
- 来源:community(社区发布)
- 发布者:user_15292d5a
- 分类:business-ops
- 标签:requires_api_key=true(需要 API key)
- 官方地址:https://api.skillhub.cn/user_15292d5a/yjkj-mai
它解决的问题是:在对话式界面里把「找货—比价—沟通—下单—追踪」这条链路跑通,同时把交易记录留在本地优先的存储里,而不是完全依赖远端服务。
核心功能¶
根据官方简介,mai 的能力分两侧:
买家侧:
1、发现商家与商品(discover merchants and products)
2、比较价格(compare prices)
3、与卖家沟通(discuss with sellers)
4、阅读评价(read reviews)
5、创建可追踪的订单(create trackable orders)
商家侧:
1、发布商品(publish products)
2、管理库存(manage stock)
3、回答买家问题(answer buyer questions)
4、处理订单请求(handle order requests)
底层机制上有两点值得注意:
- local-first transaction tracking:交易追踪以本地为先,订单状态和交易记录优先在本地维护。
- registry-backed PSP custody records:支付环节的托管记录由 registry 背书,即支付服务提供商(PSP)的 custody 记录会落到 registry 中,便于事后核对。
安装与启用¶
已抓取的官方资料中没有给出具体的安装命令、目录结构或配置文件字段,因此这里不做推测。启用前需要确认以下几点:
1、该 Skill 标记为 requires_api_key=true,使用前需要准备好相应的 API key。
2、宿主环境需支持 OpenClaw 或 Hermes 中的一种(简介中写明 “for OpenClaw and Hermes”)。
3、安装与配置的具体命令请以官方地址页面的说明为准:https://api.skillhub.cn/user_15292d5a/yjkj-mai
资料中没有出现 Cursor、Codex CLI、Claude Code 的差异化安装说明,因此不分别列举。
典型用法¶
官方简介给出的使用场景即上述买卖双方流程,可复现的示例以对话驱动为主:
1、买家侧:让 agent 发现某类商品的商家与商品、比较价格、查看评价,并与卖家沟通后创建可追踪的订单。
2、商家侧:让 agent 发布商品、更新库存、回答买家提问、处理收到的订单请求。
由于资料中没有提供具体的命令行示例、接口调用样例或配置文件片段,本文不编写虚构示例。需要实际调用方式的读者请查阅官方页面。
适用场景与注意¶
适合谁:
1、在 OpenClaw 或 Hermes 上搭建电商导购、商家助手类对话应用的开发者。
2、希望交易记录本地优先、同时需要 PSP 托管记录留痕的项目。
需要注意的限制:
1、需要 API key,接入前要确认 key 的申请和计费方式。
2、来源是 community,即社区发布,不是官方团队维护,稳定性和更新节奏需要自行评估。
3、当前资料显示安装量为 0(下载 631 次),社区采用情况有限,接入前建议先小规模验证。
4、本地优先的交易追踪具体落到哪里(本地文件、数据库还是宿主存储),资料中没有展开,需要读源码或官方文档确认。
关于热度数据:本段抓取到的官方页面显示评分 100000、下载 631、安装 0;此前线索中写的 99745 分、391 次下载与之不一致,本文以抓取到的页面数据为准。
结尾¶
mai 的价值在于把买卖双方的撮合流程(找货、比价、沟通、下单、追踪)封装成一个可直接接入的 agent,并强调交易记录本地优先、PSP 托管记录由 registry 背书。它依赖 API key,且属于社区发布,接入前建议先验证再扩大使用。
官方地址:https://api.skillhub.cn/user_15292d5a/yjkj-mai