核心用法
shop-culture 是为 For the Cult 生活方式商店打造的 Agentic Commerce 技能,让 AI 代理能够自主完成从浏览到收货的完整电商闭环。核心工作流程分为四步:
1. 智能发现:通过 POST /agent/shop 自然语言购物助手,输入如"降噪耳机预算200美元"即可获得 AI 推荐 + 结构化商品列表;或直接使用语义搜索 GET /products/search。
2. 商品详情:用商品 slug 调用 GET /products/{slug} 获取完整信息(变体、库存、图片、关联推荐),必须使用返回的 `id` 字段下单,严禁虚构 ID。
3. 支付结算:两种模式可选——标准结账 POST /checkout 返回付款地址与二维码,用户自行转账;或 x402 协议 POST /checkout/x402 返回 HTTP 402 状态码,由运行时(非本技能)签名完成链上支付。支持 Solana、Ethereum、Base、Polygon、Arbitrum、Bitcoin、Dogecoin、Monero 八大网络,推荐 USDC/USDT 稳定币避免波动。
4. 订单追踪:通过 GET /orders/{orderId}/status 轮询状态,从 awaiting_payment(5秒间隔)到 shipped(小时级)直至 delivered。
显著优点:
- 多链原生:8+ 区块链支持,覆盖主流加密生态
- 零门槛接入:浏览、搜索、结账无需 API 密钥或账户
- AI 导购体验:自然语言输入,结构化输出 + 智能推荐理由
- CULT 代币激励:持有者享 5-20% 折扣 + 免运费
- x402 协议支持:符合 HTTP 402 支付标准,代理可自主协商支付
潜在局限与风险:
- 支付窗口紧迫:约15分钟付款有效期,超时订单作废需重建
- 用户确认依赖:必须在明确获得用户"是"或"确认"回复后,方可透露付款地址和金额,否则违反安全规则
- 私钥隔离原则:本技能绝不请求、存储或接触私钥,支付签名必须由用户钱包或代理运行时完成
- 变体库存波动:热门商品变体可能瞬间缺货,需实时校验
inStock状态 - 链上最终性风险:加密货币支付需等待链上确认,期间存在价格波动或网络拥堵可能
适合人群:
- 已持有加密货币、偏好链上支付的消费者
- 寻求 AI 代购代理的 Web3 原生用户
- CULT 代币持有者希望享受折扣权益
- 开发者构建自主商务代理(Agentic Commerce)需要标准化电商 API
常规风险提示:始终先调用 GET /payment-methods 验证支持的链/代币组合;严格遵循 "显式用户确认" 规则;身份头 X-Moltbook-Identity 仅当运行时显式提供时用于 /agent/me 类端点,正常购物流程严禁携带。