（4410期）PCO CLI – Planning Center Services – 教会服事排班与曲目管理专家

教会服事排班与曲目管理专家 教堂活动管理 CLI，支持 Planning Center Services API 的完整操作，适合教会团队高效排班、曲目管理与人员调度。 使用说明 核心用法 PCO CLI 是面向 Planning Center Services 的命令行工具，专为教会场景设计。核心功能覆盖六大模块： 服务计划管理：查询未来/历史服务（--filter future/past）、获取详细排期（含节目项、团队成员） 人员调度：查看特定服务的排班表（scheduled list）、搜索会众信息 资源库管理：歌曲（含编曲版本）、媒体文件、文件夹、系列主题的完整 CRUD 支持 团队架构：服务类型、小组、标签分组的多层级管理 原始 API：直接发起 GET/POST/PATCH/DELETE 请求，满足高级定制需求 全局选项提供灵活的输出格式（JSON/表格/静默模式）和分页控制，适合脚本自动化与人工查阅双重场景。 显著优点 教会场景深度适配：原生支持 "This Sunday's Service" 等典型工作流，而非通用 API 工具的拼凑 交互式认证：auth setup 引导式配置降低技术门槛 别名友好：推荐 alias pco 设置，融入日常 Shell 工作流 数据完整性：--include 参数支持嵌套资源获取，减少多次请求 潜在局限 Scope 受限：明确限定 PCO Services，不涉及 People/Giving 等其他 Planning Center 产品 认证单点：依赖本地 JSON 文件存储凭证，无内置令牌刷新机制说明 社区规模：个人仓库（rubysworld/pco-cli），未观察到 CI/CD 或版本发布流程 适合人群 教会技术同工需批量导出排班/曲目数据 音乐/媒体团队Leader需要快速查询历史服务记录 开发者构建教会内部自动化工具链 常规风险 凭证泄露：~/.config/pco-cli/config.json 需设置 600 权限，避免共享环境暴露 API 限流：Planning Center 对未付费账户有请求频率限制，批量操作建议配合 --limit 使用 数据误删：pco api DELETE 直接操作生产数据，建议先在 --filter past 数据上测试 原始说明 CLI tool for managing Planning Center Services data including plans, teams, songs, and scheduled people via the PCO Services API.