核心用法
Moltpho 是一个无头购物商城，使 AI 代理能够在亚马逊上自主发现和购买商品。其核心流程包括：
初始化与注册：首次使用时自动检查本地凭证文件（~/.config/moltpho/credentials.json），若不存在则调用 POST /v1/agents/register 注册新代理，生成 agent_id、api_key 和钱包地址，并自动打开浏览器完成认领流程。
商品搜索：通过 catalog_search(query, constraints) 搜索亚马逊商品，支持价格上限、类别和评分过滤，返回带 10% 加价后的 Moltpho 最终价格。
支付与购买：采用 x402 支付协议，流程为：检查信用余额 → 创建报价（10 分钟有效期）→ 发起订单（返回 402）→ 签名支付授权 → 完成订单。支持自动重试机制（价格变动 ≤5% 时最多重试 3 次）。
主动监控：被动监听对话中的购买信号（如"我们需要...""快用完了"），在置信度 ≥0.8 且符合低风险类别（日用品、办公用品等）时自动执行购买，单次上限 $75。
信用管理：基于 Base 主网的 mUSD ERC-20 代币，支持每周自动充值、实时余额查询和退款处理。
---
显著优点
1. 真正的自主代理：AI 可在无需人工逐单确认的情况下完成端到端购物流程，包括搜索、比价、支付和订单跟踪
2. 链上结算创新：采用 x402/EIP-3009 支付标准，实现加密货币与法币商品的无缝桥接
3. 安全沙箱设计：敏感操作（银行卡管理、KYC）全部在隔离的浏览器门户完成，代理永不接触 PCI 敏感数据
4. 智能预算控制：多层限额系统（单笔上限、日限额、目标信用额度）防止过度消费
5. 系统级风控：内置武器、处方药、酒精等品类黑名单，以及价格变动阈值保护
---
潜在缺点与局限性
| 限制 | 说明 |
|------|------|
| **地理限制** | 仅支持美国地址，国际配送未开放 |
| **品类局限** | 高风险商品（武器、药品、酒精）被系统强制封禁 |
| **价格 markup** | 所有商品加价 10% 覆盖 gas 费和平台成本 |
| **依赖外部服务** | 亚马逊价格变动、Base 网络拥堵、Stripe 支付状态均可能影响体验 |
| **代理状态风险** | 若进入 DEGRADED（支付方式失败）或 SUSPENDED（管理员冻结）状态，可能无法下单 |
| **主动购买误判** | 语言模型的意图识别存在误触发风险，虽有限额保护但仍需谨慎 |
---
适合人群
- 高频复购型家庭/办公室：卫生纸、墨盒、零食等标准化消耗品的自动补货
- 开发者与自动化爱好者：希望将电商采购集成到 AI 工作流的早期采用者
- 加密原生用户：已持有 Base 链资产、偏好链上结算的用户群体
- 行动不便或时间稀缺者：需要语音/对话界面完成购物的特殊场景
---
常规风险
1. 智能合约风险：mUSD 代币合约及 x402 结算合约可能存在未审计漏洞
2. 价格滑点：报价 10 分钟 TTL 内亚马逊价格变动可能导致交易失败或重新报价
3. 代理密钥泄露：本地 credentials.json 若权限设置不当（应 chmod 600）可能被恶意程序读取
4. 过度授权风险：EIP-3009 签名授权需确保代理服务器可信，防止签名被恶意重放
5. 退款延迟：非自动退款场景（退货、丢件）需人工工单处理，周期不确定
6. 监管不确定性：加密货币支付购物在不同司法管辖区的合规性尚不明确
---
使用建议
首次使用务必完成完整的认领流程，设置保守的信用限额（建议从 $100-200 开始），并定期检查 GET /v1/agents/me 状态。对于高价值商品，建议关闭主动购买模式，改用显式确认流程。