用途：pp-beehiiv 驱动 beehiiv-pp-cli 二进制，把 Beehiiv 的出版物、订阅者、分段、帖子、播客等镜像到本地 SQLite，用于离线受众分析、批量订阅操作、脚本与 CI 流程，并输出适合智能体消费的 JSON。
安装与验证：先确认 CLI 已安装，缺失时用 npx -y @mvanhorn/printing-press-library install beehiiv --cli-only 安装，再执行 beehiiv-pp-cli --version 验证；若 npx 失败，可用 go install github.com/mvanhorn/printing-press-library/library/marketing/beehiiv/cmd/beehiiv-pp-cli@latest（需 Go 1.26.6 或更新）。安装目录需在 $PATH 中。
主要能力：insights 系列命令基于本地库计算订阅来源、流失来源、发送时段表现、推荐计划健康度、单订阅者查询与跨出版物对比，无需 API 调用；sync 可游标分页同步关键实体；search 与列表命令支持 CSV 导出；覆盖 posts、subscriptions、segments、tiers、webhooks、automations、podcasts、exports 等 v2 接口命令。
使用方式：在 app.beehiiv.com 创建 API Key 并导出 BEEHIIV_API_KEY，运行 beehiiv-pp-cli doctor 检查配置。任意命令加 --agent 展开为 --json --compact --no-input --no-color，可配合 --select 裁剪字段、--dry-run 预览请求。输出包裹在 meta/results 信封中，解析 .results 取数据、.meta.source 判断数据来自实时还是本地。可用 --home 或 BEEHIIV_HOME 等环境变量调整路径。
限制：该 CLI 不用于 Beehiiv 文档搜索，也不处理 OAuth 应用授权流程，它是 API Key 客户端；创建已确认且无 scheduled_at 的帖子会立即发送，建议先用 --dry-run；--agent 不隐含 --yes，需单独确认；部分功能（如数据删除、导出）为需开通的门控特性；API Key 按组织共享每分钟 180 次请求。资料未提供收费与价格信息。