用途：luma-pp-cli 读取 Luma 公开发现接口（api.luma.com），用于只读地发现、聚合和导出公开活动，适合查询某城市或某主题的活动、获取活动与社区详情、生成日历文件，以及跟踪活动随时间的变化。
主要能力：events list/get 按城市或分类浏览与获取活动详情；places 浏览城市并获取地点、地图坐标与当地社区；discover 查看精选活动、地点与分类；calendars 获取社区详情。此外提供 API 本身没有的能力：agenda 跨多城市多分类生成按日期排序的扁平列表；near 按经纬度半径查找并按距离排序；ics 导出可导入日历应用的 .ics 文件；watch 显示自上次同步以来的新增、移除、报满、售罄、改期等变化；calendars compare 对比多个社区的活动数与参与人数。
使用方式：先安装并验证 CLI。安装命令为 npx -y @mvanhorn/printing-press-library install luma --cli-only，验证命令为 luma-pp-cli --version；若 npx 安装失败，可用 go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/luma/cmd/luma-pp-cli@latest（需 Go 1.26.6 或更新版本）。确保安装目录在 $PATH 中。运行 luma-pp-cli doctor 检查配置。任意命令加 --agent 即展开为 --json --compact --no-input --no-color --yes；--select 可只保留所需字段，--dry-run 预览请求，--deliver 支持 stdout、file:<path>、webhook:<url> 输出。可用 profile save/list/show/delete 保存常用参数组合。
适用场景：智能体或脚本进行只读活动发现、跨城市聚合、地理半径检索、日历导出与长期变更监控。
限制：无需账号或 API 密钥，仅能访问公开发现数据；不能创建、编辑或取消活动，不能管理嘉宾名单、签到、报名或票务，也不能读取私有或仅订阅者可见的日历，这些属于付费 Luma Plus API。该工具为只读，不应用于任何写操作。资料未提供收费、价格或平台支持等更多信息。