我做了一个给 Agent 用的电商开源项目:开店、上架、改版,跟 Agent 说一声就行

开过网店的朋友都有体会:商品后台、规格表单、装修编辑器,一页页点下去,半天就没了。这些工具是为"人点鼠标"设计的。可到了 Agent 时代,一个卖珍珠的小店主,其实只想对 Agent 说一句:"把这 6 款吊坠上架,按珠径定价。"

这就是我做 MercLink 的出发点。

MercLink 是一个给 AI Agent 用的单店电商服务:一家店,一套 HTTP API,Apache-2.0 开源。它完全 AI Native,Agent 是一等用户:开店、上架、改版、下单都由 Agent 读公开文档、调 HTTP API 完成,人只需要在浏览器里登录并点一次"批准"。

它没有给人点的商品后台,但仍然是一个给人看的漂亮店面。

核心特性

  • 三份 Skill,三类 Agent :商家 Agent 读 /merchant/skill.md 建目录、定义字段、创建商品和规格、上下架;买家 Agent 读 /skill.md 查商品,开启买入后可下单、查支付结果;店面 Agent 读 /storefront/skill.md 改版店面。/llms.txt 是总入口。
  • 为 Agent 设计的登录:OAuth 2.1 设备码。Agent 把短码交给人,人在自己的浏览器批准;Agent 拿到短期令牌,从不接触密码。
  • Agent 读得懂的响应:统一的 JSON 外壳和数字错误码,页面还有 Markdown 版本。
  • Agent 可改版的店面:下载起始源码、改 HTML/CSS、本地验收、上传、确认激活,可一键回滚。店名、价格、库存等事实由服务端槽位渲染,Agent 改版不会改错数据。
  • 可选买入 :默认只开放查询,设 MERCLINK_PURCHASE=1 后接入支付宝或易支付。

它是怎么工作的

整个服务是单个 Next.js 进程,不拆微服务;数据放在 PostgreSQL、Redis 和 RustFS。Agent 不直连数据库、对象存储或支付宝,只通过 API 操作,权限也按角色划分:商家 Agent 不能把订单标成已支付,买家 Agent 不能自己传价格。

和 WordPress、Shopify 有什么不同

维度 WordPress + WooCommerce Shopify 有赞 MercLink
主要操作方式 人在 WP 后台操作,另有 REST API 人在后台操作,Admin API 给应用调用 人在商家后台操作,有赞云开放 API Agent 调 HTTP API,没有商品后台
Agent 接入 MCP 集成,目前是开发者预览 面向买家的 UCP / MCP,开发者 AI Toolkit 开放 API 正在升级为 AI 可调用的 CLI 和 Skill 每家店自带 /llms.txt 和三份 skill.md
授权方式 REST API Key 或应用密码 先创建应用,再走 OAuth 拿令牌 创建应用并授权店铺 OAuth 设备码,人点一次批准
店面定制 主题和插件极多 主题商店 + Liquid 后台可视化装修 Agent 改 HTML/CSS,事实走槽位
部署 / 数据 自托管 SaaS 托管 SaaS 托管 自托管,Docker 一键部署
成本 / 协议 GPL 开源,主题插件另计 订阅收费 订阅收费 Apache-2.0,自付服务器
生态成熟度 非常成熟 非常成熟,支付、应用完整 成熟,国内营销工具丰富 早期,单店,两家试用

说实话,论成熟度、插件生态、主题和支付,MercLink 都没法和它们比,而且这些平台也都在补 AI 能力,WooCommerce 做了 MCP,Shopify 推了 UCP,有赞在把开放 API 做成 Skill。区别在于出发点:它们是先为人设计、再给 Agent 开口子;MercLink 从第一天起就只为 Agent 设计。要大而全,选它们更稳;想让 Agent 从头到尾打理一家小店,可以试试 MercLink。

两个真实案例

两家已上线的店跑的是同一套服务,都由 Agent 只读公开 Skill 完成配置和店面定制,没有改服务端代码。

童心珠宝(txpearl.cn) :北海珍珠首饰。Agent 加了一组珍珠专用字段,上架 6 款商品并按"珠径"规格定价,配齐店铺介绍、客服和营业执照,改出深海蓝加金色的品牌页,还完成了百度、Bing、Google 站点验证。 Chengdu Tour(eileenpeng.com) :面向海外游客的成都小团游,英文店面配 3D 卡片轮播。它卖的是导览体验而不是实物,说明服务类商品也适用。

快速开始

准备一台装好 Docker 与 Docker Compose v2 的服务器,域名解析过来,放行 80/443:

bash 复制代码
curl -fsSL -o /tmp/merclink-install.sh https://github.com/ptonlix/MercLink/releases/latest/download/install.sh && bash /tmp/merclink-install.sh

部署完成后,把 https://<你的域名>/merchant/skill.md 交给你的 Agent,让它开始上架。

最后

"在 AI 时代,让天下没有难做的生意",是我给 MercLink 定的目标。目前已有两家店在跑。觉得方向有意思,欢迎点个 Star、提 Issue 或 PR

在做小生意的朋友,欢迎部署试用。你的店跑起来后,提个 PR 把它加进 README 的致谢表,成为下一位试用商家。

项目地址:github.com/ptonlix/Mer...

相关推荐
用户74638129504811 小时前
Netty实现MQTT Broker——从零构建到底值不值?
github
不好听6131 小时前
Neo4j:图数据库入门:节点、关系、标
agent
穆梓兰煊1 小时前
WebAssembly AI推理学习与落地路线
github
云和数据.ChenGuang1 小时前
Spring AI 对接 LangGraph:构建企业级智能体工作流实战
java·人工智能·spring boot·后端·spring
李溪白1 小时前
RAG 进阶:Agentic RAG 与多智能体协作(系列二·第1篇):高级工具设计
agent
miofly1 小时前
Step 5 Preview 用 27B 激活参数运行 600B 规模模型
开源·github
杨超越luckly1 小时前
国庆V型、春节迁徙、五一升温:节假日数据里的中国旅游
agent·旅游·数据可视化·节假日·cpi·国定假日
熊猫钓鱼>_>1 小时前
当工具成为类:Softmax困境与连接器过载的算法根源
算法·ai·agent·工具·曲线·华为云码道·生态图鉴
云半S一1 小时前
Agent 学习总结一
经验分享·笔记·学习·agent