SuperAPI AI 工具集

performance-memo

营销与增长

查看项目

更新于 10-19 04:58

技能介绍

用途

Performance Memo 是一个 Claude Code 营销分析技能,用于在每周一生成一份“一位敏锐分析师会写出的”简短业绩备忘录。它把每个广告平台的支出与合格通话、成交、收入、退款和流失按 campaign ID 关联起来,追踪资金从花费一直到留存、退款和利润的完整链路,因为一个带来便宜客户、但这些客户在 60 天内流失的广告活动,在仪表盘上看起来很好,却在悄悄亏钱。

备忘录的每一行都以一个决策结尾:保留(keep)、砍掉(kill)、调整(change)或测试(test)。

主要能力

  • 按 campaign ID 汇总各平台支出与投放数据,覆盖 Google、Meta、LinkedIn、Bing、TikTok、X、Reddit、Snapchat、Apple Search Ads、ChatGPT ads(OpenAI Ads)、Bidtheatre 等。
  • 统计线索与线索质量:通过 GA4、Plausible、HubSpot、Pipedrive、Upsales 等获取线索数、合格通话数,并结合 customer-fit 判断线索是否可服务。
  • 管道与收入:通过 fibbler 获取管道、收入、ROAS、每机会成本,以及跨渠道表现;通过 HubSpot 获取未关闭管道。
  • 留存、退款与利润:通过 Stripe、Fortnox、Shopify、WooCommerce、Abicart / Litium 等计算 60 天流失、退款、复购率,并计算“每留存客户成本”。
  • 可选地读取 GrowthBook 中已结束的实验结果,把赢家和输家写入备忘录和实验日志,避免重复测试已定论的问题。
  • 按每个 campaign 文件夹中的证据门槛判断结论是否成立;默认门槛为至少 10 次转化且至少 14 天。
  • 输出结构化备忘录,包含来源状态、归因置信度、简短结论、campaign 表格、渠道视图、与上周对比、尚未定论项、数据问题等部分。
  • 为每个 kill 或 change 创建一个工单(keep 不需要),附带证据和 estimated_impact_usd。

使用方式

命令:

  • /performance-memo — 最近 7 天对比前 7 天,并对任何正在收尾的事项给出 90 天结果。
  • /performance-memo month --compare

建议排程:周一 07:30,在 /customer-language 和 /campaign-ledger 同步之后运行。

前置检查(Step 0:Cogny check):如果不存在 mcp__cogny__* 工具(没有 list_integrations、没有 cogny_status),则打印提示并停止:

Performance Memo needs your marketing data through Cogny's MCP gateway.

  1. Sign up at https://cogny.com and connect your ad platforms plus a CRM or Stripe (fibbler and GA4 help with attribution).
  2. Add Cogny to .mcp.json in your project: {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
  3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Nothing to run without Cogny.

主要步骤包括:加载上下文(ledger、各 live campaign 文件夹、customer-fit、实验日志、上周备忘录);按 campaign ID 获取支出与投放;获取线索与线索质量;获取管道与收入;计算留存、退款与利润;可选读取已结束实验;对照证据门槛判断;撰写备忘录;把决策加入队列。

归因回退顺序(缺少 ID 时):

  1. ledger 中的 campaign ID(高置信度)
  2. fibbler 渠道级归因(中置信度)。需要 fibbler 且有两个付费渠道;否则拒绝或返回零。如果 fibbler 拒绝、返回零或认证失败(401 / Forbidden),降到第 3 层并在“Data problems”中说明。
  3. 平台自报转化 + GA4 按 sessionSourceMedium(低置信度)。始终交叉核对:如果平台声称有 GA4 看不到的转化(例如 X 注册,而 GA4 显示未标记的 t.co / referral 且 0 个关键事件),这种不一致本身就是一条备忘录内容。

适用场景

  • 需要每周固定产出营销业绩复盘、并希望每条结论都对应一个明确决策的营销团队。
  • 需要把广告花费与 CRM 中的合格通话、成交、收入打通分析的情况。
  • 需要关注留存、退款和利润,而不只是 CPA 的场景。
  • 使用 Cogny 接入广告平台、CRM 或 Stripe 的工作流。

限制

  • 需要 Cogny($9/月);没有 Cogny 则无法运行。
  • 最好配合 /campaign-ledger 运行;缺少 campaign ID 时归因置信度下降。
  • 该技能是只读的:决策进入队列,技能本身不改变任何东西。
  • 不得对重叠归因求和,应使用 fibbler 的合计值。
  • 金额在 estimated_impact_usd 中必须换算为美元,正文中给出原始币种金额。
  • 工单标题以 [ME:performance-memo] 开头。
  • 必须说明样本量和置信度;“小样本”本身就是一条发现。
  • 必须列出每个失败的来源;缺失的平台可能让某一周看起来是盈利的。
  • 其他具体平台、价格、效果或步骤细节,资料中暂未提供。