用途：numista-pp-cli 是一个用于驱动 Numista 目录与个人收藏数据的 CLI，适合需要配额感知的批量自动化，例如从其他工具批量导入收藏、定期刷新关注硬币的价格、计算整份收藏的当前估值，或把某个类型的全部年份与品相数据拉入本地库分析。若只是临时查询一枚硬币，官方网页界面更合适。
前置条件：该技能依赖 numista-pp-cli 二进制，调用前必须确认已安装。安装命令：npx -y @mvanhorn/printing-press-library install numista --cli-only。验证：numista-pp-cli --version。若 npx 安装失败，可回退到 Go 安装（需 Go 1.26.6 或更新）：go install github.com/mvanhorn/printing-press-library/library/other/numista/cmd/numista-pp-cli@latest。若 --version 报 command not found，说明运行时看不到二进制目录，需先修好 $PATH。
主要能力：--quota 零调用打印当月已用/剩余/重置配额；audit 查询本地 lookup_log，按天、端点或类型 ID 聚合，用于诊断配额消耗；types batch 解析 CSV/JSONL/文本类型 ID 列表并查询，支持缓存复用、--dry-run 成本预测与跨 UTC 月可恢复分段；types series 拉取某类型的全部年份、各品相价格与发行量并持久化到本地；collection value 汇总收藏当前估值并按价值排序，剩余配额不足时拒绝启动；refresh 仅刷新会变化的字段（价格、发行量），保留编目身份字段；crawl issuer 爬取某发行方的类型；watchlist 跟踪一组类型的价格变化并输出与上次快照的差异；users collected-items add --from-file 幂等导入收藏项；users collections hydrate 批量拉取并持久化整份收藏。
使用方式：在环境中设置 NUMISTA_API_KEY（免费计划 2000 次/月）。目录与参考类端点只需 API key；用户收藏类命令需要 OAuth token，可通过 numista-pp-cli oauth-token --grant-type client_credentials --scope view_collection 获取，并用 numista-pp-cli auth set-token <token> 保存，令牌存放于 ~/.numista-pp-cli/auth.json（权限 0600）。运行 numista-pp-cli doctor 验证配置。任意命令加 --agent 等于 --json --compact --no-input --no-color --yes。可用 --select 做点路径投影压缩返回字段，--dry-run 预览请求，--deliver 支持 stdout、file:<path>、webhook:<url> 三种输出目标；--profile 可保存并复用一组标志值。返回包裹在 meta（source 为 live 或 local）与 results 结构中。可用 numista-pp-cli which "<自然语言能力描述>" 反查命令。
限制：需要自备 Numista API key，免费额度 2000 次/月；用户收藏命令需要 OAuth 令牌；collection value 与 hydrate 在剩余配额不足时会拒绝启动；批量超过约 2000 项需用可恢复分段；--dry-run 不消耗调用；该 CLI 不依赖 pcgs-pp-cli，但可与后者配合，通过目录交叉引用（catalogue 1856）把 PCGS 编号解析为 Numista N#。其余细节（如具体收费与平台支持范围）资料暂未提供。