核心用法
shop-culture 是一套面向 AI 代理的电商技能，让 Claude、ChatGPT 等代理能够像人类用户一样在 For the Cult 商店完成购物全流程。核心功能覆盖：自然语言商品搜索、多维度筛选、产品详情获取、标准/x402 双模式结账、订单状态追踪。
标准购物流程：调用 POST /agent/shop 或 GET /products/search 进行自然语言搜索 → 用 GET /products/{slug} 获取详情与变体 → 选择 POST /checkout（人工确认支付）或 POST /checkout/x402（完全自主 USDC 支付）创建订单 → 轮询 GET /orders/{orderId}/status 追踪物流。
支付多样性是该技能的显著特色。支持 Solana、Ethereum、Base、Polygon、Arbitrum、Bitcoin、Dogecoin、Monero 等 8+ 区块链，以及 x402 HTTP 402 协议实现的无弹窗自主支付——代理可直接签名提交 USDC 转账，无需用户手动操作钱包。CULT 代币持有者可自动获得 5-20% 折扣及免运费。
显著优点
1. 真正的 Agentic Commerce：x402 协议让代理完成"端到端"自主采购，从搜索到支付无需人工介入，是电商领域少有的代理原生基础设施。
2. 零门槛接入：无需 API 密钥、环境变量或账户注册，公共 API 开箱即用，降低代理开发者集成成本。
3. 多链兼容性强：覆盖主流公链及稳定币，USDC/USDT 推荐避免价格波动风险。
4. AI 购物助手：POST /agent/shop 端点内置自然语言理解，降低代理的意图解析负担。
5. 隐私优先：仅支持游客结账，PII 可 90 天后自动删除，无强制 KYC。
潜在缺点与局限性
- 支付窗口紧迫：加密货币订单仅 15 分钟有效期，超时需重建订单，对网络延迟或用户确认慢的场景不友好。
- 链上确认依赖：尽管代理可自主支付，实际到账仍需区块链确认，状态轮询需代理端实现（建议 5-60 秒间隔）。
- 地域与库存波动：文档未明确全球配送范围，部分商品/变体可能缺货需动态处理。
- x402 生态早期：HTTP 402 支付协议属较新实验性标准，钱包与代理运行时支持度仍在发展中。
- 代币折扣的隐私权衡：提供钱包地址可获折扣，但会链上关联订单与持仓，需用户知情同意。
适合人群
- AI 代理开发者：需要为代理添加"购买实体商品"能力的团队（礼品采购、设备补给、生活方式服务）。
- 加密货币原住民：偏好用多链资产直接消费、反感传统网银流程的用户。
- 自动化场景：订阅制补货、企业行政采购、无人值守的 agent-to-agent 商业交互。
常规风险
| 风险类型 | 说明与建议 |
|---------|-----------|
| **支付地址钓鱼** | 代理必须严格校验 API 返回的 `payment.address`，绝不可从其他来源获取；用户侧需二次确认地址 |
| **15分钟窗口误操作** | 过期订单资金可能丢失或需退款流程，建议代理在创建订单前确保用户已准备好支付 |
| **价格波动** | 非稳定币支付存在 15 分钟内价格变化风险，代理应优先推荐 USDC/USDT |
| **代理身份泄露** | `X-Moltbook-Identity` 头仅应在运行时显式提供时使用，禁止代理自行推断或发送 |
| **库存与变体同步** | 变体可能瞬间售罄，结账前务必重新校验 `inStock` 状态，处理 `availableVariants` 回退 |