用途：本 CLI 用于发现播客、把节目解析为单集，或分析播客元数据、发布节奏、嘉宾、value4value 分账与转录内容。适合需要离线复用、全文搜索或跨 feed 分析的场景。
主要能力：查找与解析（find search、lookup、podcasts、episodes 各子命令）、最近新增（recent）、统计（stats）、Value for Value（value）、分类（categories）。独有能力包括：tgrep 在真实单集转录内做全文搜索；cadence 与 dead-watch 分析发布历史；guest-graph 跨 feed 关联人物。本地 SQLite 镜像支持离线同步与全文搜索，--agent 展开为 --json --compact --no-input --no-color --yes。
用法：先验证安装，podcastindex-pp-cli --version。缺失时用 npx -y @mvanhorn/printing-press-library install podcastindex --cli-only 安装，或用 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/podcastindex/cmd/podcastindex-pp-cli@latest。鉴权需设置 PODCASTINDEX_KEY 与 PODCASTINDEX_SECRET，CLI 自动计算签名，可用 podcastindex-pp-cli doctor 验证。示例：podcastindex-pp-cli episodes byfeedid --id 920666 --newest --max 10 --json --select items.title,items.datePublished,items.enclosureUrl；podcastindex-pp-cli tgrep "interest rates" --feed 920666 --agent。
输出与集成：读取本地或 API 的命令返回 meta 与 results 信封，解析 .results；支持 --select 过滤、--dry-run 预览、--deliver file:/webhook: 等输出方式及命名 profile。MCP 服务可 go install .../podcastindex-pp-mcp@latest 后用 claude mcp add 注册。
限制：不下载或播放音频，仅返回 enclosure URL；不新增或管理 PodcastIndex feed（add/* 需发布者鉴权，超出范围）；除 iTunes lookup 透传外不处理 Apple Podcasts 专属元数据。部分安装与鉴权细节暂未提供。