用途：该 CLI 面向需要一次性跨某艺人大量演出歌单进行推理的场景，例如预测演出、查找久未演唱的歌曲、统计翻唱次数、比较两次巡演、或生成用户观演历史看板。一次性查询用原始 search/get 命令；需要聚合结果时用预测、逾期、巡演结构、比较、观演统计等命令。因 API 限速 2 RPS，反复提问时比实时 API 封装更快。
安装：先验证 CLI 是否已装，缺失时通过 Printing Press 安装器执行 npx -y @mvanhorn/printing-press-library install setlist-fm --cli-only，再运行 setlist-fm-pp-cli --version 验证，并确保安装目录在 PATH 中。npx 失败时可回退 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/setlist-fm/cmd/setlist-fm-pp-cli@latest（需 Go 1.26.6 以上）。
主要能力：predict 基于近期巡演做加权概率预测；song-stats 给出单曲总次数、首末日期、最长间隔、平均位置；overdue 按距上次演唱场次排序；tour-shape 输出中位曲目数、返场频率、开场与收场曲；compare 比较两次巡演的重合、删除、新增与位置变化；encore、venue-loyalty、covers、debut、tour-route、bingo、playlist、since、attended-stats 等覆盖发现、收藏与导出。
用法：所有命令加 --agent 展开为 --json --compact --no-input --no-color --yes；--select 可裁剪字段；--dry-run 预览请求；sync 系列将数据同步到本地 SQLite 供离线分析。API 密钥在 https://www.setlist.fm/settings/api 免费获取，环境变量 SETLISTFM_API_KEY 或兼容的 SETLIST_FM_API_KEY，也可用 auth set-token 持久化；doctor 检查配置。
限制：只读，不支持创建、更新、删除、发布、评论、点赞、邀请、下单、发送等改动远端状态的操作；输出走 .results，来源见 .meta.source；429 会提示退避。MCP 服务可用 go install ...setlist-fm-pp-mcp@latest 后以 claude mcp add setlist-fm-pp-mcp -- setlist-fm-pp-mcp 注册。