beehiiv-newsletter-report

用途：将 Beehiiv 出版物的原始数据转化为非技术相关方（赞助商、客户、通讯所有者）可在一分钟内读懂且信任数字的报告。适用于构建、扩展或自动化 Beehiiv 报告，或通过 MCP 工具、API、聊天机器人暴露 Beehiiv 指标。前提：Beehiiv 出版物 ID 与具备读取权限的 API 密钥（Bearer token），基础 URL 为 https://api.beehiiv.com/v2/publications/{pub_id}/...。报告含九个部分：核心数据、网站/引流链接、受众增长图、打开率分析、点击率分析、受众洞察、逐月标签页、互动读者导出、每期 KPI 卡片。构建流程：先确认凭据与 GET /posts?limit=1 成功，再拉取带统计的已确认文章，按参考公式计算，构建受众增长序列，分页拉取完整订阅者列表计算参与度分段，撰写叙事内容；无数据的部分不渲染。自动化刷新时需将确定性数字重算与叙事重新生成分开，仅更新受新数据影响的部分，避免整体重写导致语气漂移。已知陷阱：点击率字段是点击/打开而非点击/送达，需自行计算 unique_clicks/delivered；投票 poll_responses 上限 10 条不可分页，应分页 /polls/{id}/responses 自行计数；无订阅者位置数据，不可虚构地理视图；参与度分段应仅针对收到足够期数（如至少 3 期）的订阅者；赞助链接点击导出通常需定期从 Beehiiv 仪表板导出 CSV 并自行丰富；早期历史可能缺结构化跟踪，宜用手工维护的订阅者时间线。MCP 构建者可将各节映射为独立工具，如 get_publication_summary、get_audience_growth、get_rate_analysis、get_audience_segments、get_monthly_report、export_engaged_subscribers、get_issue_kpis，并尽量缓存订阅者列表分页结果。价格、平台与效果等未提供。