核心用法
Standard Agentic Commerce Engine 是连接自主智能代理与现代电商后端的生产级桥梁。通过统一的 SERVER_SPEC.md 规范，开发者可在数分钟内将现有网站改造为「Agent-Native」接口。核心工具为 commerce.py 脚本，提供结构化高精度数据交互，支持通过 --store <url> 直接指定目标店铺。
主要能力覆盖：商品发现（search/list/get）、购物车管理（add-cart/update-cart/remove-cart/clear-cart）、订单创建（create-order）、用户资料管理（get-profile/update-profile）及品牌信息查询（brand-story/company-info）。支持分页导航（--page/--limit）以安全处理大型目录。
显著优点
- 即插即用标准化：提供 FastAPI 参考模板，最小化接入成本
- 无状态架构：通过
x-user-account/x-visitor-id头部管理会话，无需 Cookie - 安全凭证管理：Token 本地存储（权限 0600），v1.4.0 起禁止持久化原始密码
- HTTPS 强制：v1.4.7 起严格执行加密传输，防止凭证拦截
- 匿名追踪：UUID v4 访客 ID 支持未登录用户购物车，零个人信息泄露
潜在缺点与局限性
- 支付无法闭环：Agent 缺乏金融授权，只能生成订单并返回支付 URL 交由用户人工完成
- 后端依赖：需目标电商实现
SERVER_SPEC.md协议，非通用爬虫方案 - 注册流程外置：新用户需跳转至品牌注册页面，无法内嵌完成
- Token 生命周期：过期后需重新
login，可能打断连续操作流程
适合人群
- 希望为品牌快速构建 AI 购物助手的开发者/电商平台
- 拥有无头电商后端、需拓展智能代理渠道的技术团队
- 追求「Agent-Native」用户体验的现代 DTC 品牌
常规风险
- 凭证泄露风险：虽本地权限严格，但若系统被入侵，Token 文件仍可能被读取
- 中间人攻击：若后端未正确配置 HTTPS，v1.4.7 前的版本存在凭证拦截风险（已修复）
- 订单状态同步：支付 URL 外跳后，Agent 无法自动感知支付成功状态，需用户主动确认或轮询
orders接口