CardPointers CLI

从终端查询您的CardPointers钱包——卡片、优惠、推荐。

设置

• - 配置： ~/.cardpointers/config（JWT令牌，登录时自动创建）
• 依赖： curl、jq、bash
• 认证： 运行 cardpointers login 进行身份验证（邮箱/密码或基于浏览器的Apple/Google/通行密钥）

命令

recommend — 为消费推荐最佳卡片

bash
cardpointers recommend groceries
cardpointers recommend gas stations
cardpointers recommend --merchant amazon
cardpointers recommend -m whole foods --amount 150
cardpointers recommend gas -p all # 跨所有配置的最佳加油卡

cards — 列出钱包中的卡片

bash
cardpointers cards # 已获批卡片（默认）
cardpointers cards --status all # 所有状态
cardpointers cards --bank chase # 按银行筛选
cardpointers cards -b amex -s all -l 5 # 组合筛选条件 + 限制数量

offers — 列出和筛选优惠

bash
cardpointers offers # 活跃优惠
cardpointers offers -s redeemed # 已兑换优惠
cardpointers offers --expiring # 7天内到期
cardpointers offers -e 14 # 14天内到期
cardpointers offers --bank amex # 按银行筛选
cardpointers offers --card gold # 按卡片名称筛选
cardpointers offers --category dining # 按类别筛选
cardpointers offers --type personal # 仅个人优惠
cardpointers offers --favorite # 仅收藏优惠
cardpointers offers --sort value --limit 10 # 按价值排序的前10个

search — 按关键词搜索优惠

bash
cardpointers search whole foods
cardpointers search streaming --favorite
cardpointers search gas --limit 5

profiles — 列出关联的配置

bash
cardpointers profiles

实用工具

bash
cardpointers status # 账户信息 + 连接测试
cardpointers ping # 测试MCP连接
cardpointers tools # 列出可用的MCP工具
cardpointers login # 身份验证
cardpointers logout # 清除已保存的令牌
cardpointers --version # 打印版本

全局选项

所有数据命令均支持以下标志：

环境变量

参考

• - 卡片状态： approved、applied、denied、closed、all
• 优惠状态： active、snoozed、redeemed、expired、expiringsoon、all
• 优惠银行筛选（枚举）： amex、chase、citi、boa、usbank、wellsfargo
• 卡片银行筛选： 自由文本（部分匹配）
• 优惠排序选项： expiring、value、card
• 卡片包含 approvaldate（YYYY-MM-DD）

常见用例

• - 在Costco应该用哪张卡？ → recommend -m costco
• 显示我的Amex卡片 → cards -b amex
• 本周到期的优惠？ → offers -e 7
• 有Whole Foods的优惠吗？ → search whole foods
• 跨所有配置的最佳餐饮卡？ → recommend dining -p all
• 按价值排序的前5个优惠 → offers --sort value -l 5
• 以JSON格式显示已兑换优惠 → offers -s redeemed -j