用途：让 AI 智能体通过 Snaplii 的代币化礼品卡支付层，安全完成真实商户购买，并覆盖加拿大与美国 500+ 商户礼品卡。流程为用户→智能体→Snaplii→商户。
主要能力：浏览礼品卡品牌与面额、查看返现；下单购买礼品卡（需 --item-id、--price、--prov）；获取含优惠券/返现的报价；列出已持礼品卡并查看兑换码与 PIN；计算返现节省、查看卡库存概览。提供 CLI 与 Claude Desktop MCP 服务器，也可通过 Claude Code 技能调用。
安装与用法：要求 Python 3.10+（CLI 支持 3.9+，MCP 需 3.10+）及 Snaplii 移动应用。克隆仓库：git clone https://github.com/Snaplii-Inc/agent-to-merchant-payments.git，进入目录后推荐用 pipx install -e ./snaplii-cli 安装，验证 snaplii --help。API 密钥在应用内 More → Payment Methods → AI Payment Management 创建，格式 snp_sk_live_...，导出 SNAPLII_API_KEY 后运行 snaplii init 认证，配置存于 ~/.snaplii/config.json，密钥不落盘。常用命令：snaplii browse tags --prov CA、snaplii quote --item-id ... --price 100、snaplii purchase --item-id ... --price 25 --prov ON、snaplii giftcard list、snaplii smart cashback。MCP 需 pip install "mcp[cli]" 并配置 claude_desktop_config.json。
限制：仅覆盖加美地区礼品卡；购买需有效省份/州两字母代码；购买失败常见原因包括 Snaplii Cash 余额不足、API 密钥缺少 PAY_WRITE 权限或额度耗尽；其他平台与具体价格收费资料暂未提供。