SuperAPI AI 工具集

ingest-substack-csv

营销与增长

查看项目

更新于 10-16 00:02

技能介绍

用途:该技能面向 substacker 增长分析师,负责加载并校验每周 Substack CSV 统计导出文件,将数据整理为可供后续分析使用的结构化对象。

主要能力:读取 CSV 表头并与 .schema-expected.json 比对;解析文章行(关键列包括 views、opens、open_rate、clicks、sent、post_date);解析订阅者汇总(总数、免费/付费分布、活跃度分层),但绝不逐行读取订阅者邮箱;成功后将 CSV 移入 corpus/stats/YYYY-WW.csv;输出类型化的 WeekExport 对象,包含 subscribers_end、delta_subscribers、posts、sends_this_week、free_subs、paid_subs、activity_tier_distribution 等字段。

使用方式:按每周 CSV 执行六步流程——读表头并比对 schema、检查关键列、解析文章行、解析订阅者汇总、生成 WeekExport、归档 CSV。若关键列缺失,则写入 ops/growth-analyst/YYYY-WW-schema-warning.md 并中止流程,同时提示作者检查 Substack 是否更改了导出格式。

限制与注意事项:订阅者 CSV 单独处理,绝不逐行读取,仅做聚合归约;关键列丢失时硬性中止;新增列静默接受,非关键列移除仅产生软提示;订阅者 CSV 在 inbox/ 中保留 7 天后删除;容忍下划线、连字符或日期缺失等命名变体,仅警告而不硬失败。具体安装命令与运行环境暂未提供。