核心用法
该技能为 AI 代理提供完整的自主电商能力,覆盖从商品发现到订单追踪的全流程:
1. 智能商品发现:通过 POST /agent/shop 自然语言购物助手,或语义搜索 GET /products/search 查找生活、健康、科技类商品及礼品
2. 商品详情与库存:GET /products/{slug} 获取完整信息,包括变体、价格、库存状态
3. 灵活支付:支持标准结账(15分钟支付窗口)和 x402 自主结账(HTTP 402 协议,代理直接签名支付)
4. 多链支持:Solana、Ethereum、Base、Polygon、Arbitrum、Bitcoin、Dogecoin、Monero,推荐 USDC/USDT 稳定币
5. 订单追踪:GET /orders/{orderId}/status 实时轮询状态,从待支付到已送达
显著优点
- 真正无门槛:无需 API 密钥、无需注册账户,公共 API 即开即用
- 代理原生设计:x402 协议让 AI 代理可直接签名完成链上支付,无需人工弹窗确认
- CULT 代币权益:持币用户自动享受 5-20% 折扣 + 免运费
- 广泛兼容:支持 Claude、ChatGPT、Cursor、Gemini、Windsurf、Goose、Cline、LangChain 等主流代理平台
- 隐私优先:访客结账,PII 可选 90 天后自动删除
潜在缺点与局限性
- 支付责任分离:技能本身不托管私钥,x402 支付需要运行时环境支持签名能力,否则需用户手动转账
- 15分钟支付窗口:订单创建后需快速完成链上转账,超时需重建订单(价格可能波动)
- 加密货币限制:仅支持加密支付,无法币入口,对非币圈用户门槛高
- 地域限制:部分国家/地区可能不支持配送,需实时校验
error.details - 平台政策风险:部分代理平台可能将"自主支付"能力视为高风险,尽管有显式用户确认机制
适合人群
- 加密原生用户:已有钱包、熟悉链上操作,追求无缝 AI 购物体验
- AI 代理开发者:需要为代理集成电商能力的构建者
- 礼品购买者:通过自然语言快速发现适合不同场景的品质好物
- 隐私敏感用户:不愿注册账户、倾向访客结账模式的消费者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 价格波动 | 非稳定币支付时,15分钟内代币价格可能波动 | 强烈建议使用 USDC/USDT |
| 误操作转账 | 用户可能向错误地址或错误金额转账 | 技能强制要求**显式用户确认**后才展示支付信息 |
| 私钥安全 | x402 需要运行时签名,运行时密钥管理不当可能导致资金损失 | 技能**绝不请求用户私钥**,仅由运行时处理 |
| 订单过期 | 未在窗口期内支付导致订单失效 | 清晰的倒计时提示,支持一键重建订单 |
| 库存变化 | 热门商品可能在浏览到支付间售罄 | 支付前实时校验库存状态 |
---
来源与可信度:由 forthecult 维护,开源 MIT 协议,文档完整详实,API 设计遵循行业最佳实践。x402 协议为 Coinbase 提出的开放标准。