用途
send-report 用于从已连接的营销分析数据源生成格式化的绩效报告,并投递到 Slack、邮件或 Google Sheets。它支持四种报告类型:weekly-pulse(周报,1 页,顶部指标与亮点)、monthly-review(月度回顾,3-5 页,完整渠道细分与趋势)、qbr(季度业务回顾,8-12 页,战略分析与建议)、custom(自定义指标选择与结构)。
主要能力
- 从已连接的分析 MCP 服务器拉取实时指标,包括 Google Analytics(流量、转化)、Google Ads(花费、CPC、ROAS)、Meta Ads(花费、触达、频次)、LinkedIn Ads(花费、线索)、邮件平台(打开、点击、送达率)等。
- 对照品牌 profile.json 中的目标与上一周期计算 KPI,计算环比变化、百分比变化、趋势方向与统计显著性,对偏离目标超过 10% 的指标标记 warning 或 critical。
- 识别趋势与异常:持续 3 个周期以上的上升或下降趋势、单周期超过 2 个标准差的突增或骤降、季节性模式、渠道间相关性。
- 叠加事件注释(活动上线、促销、预算变更等),将指标变动与已知事件关联。
- 生成 3-5 条按预期影响排序的可执行建议:扩大、暂停、测试、调查。
- 按渠道格式化:Slack(结构化消息块、加粗指标、emoji 指示、图表附件)、邮件(响应式 HTML 模板、内联图表、摘要表、深链按钮)、Google Sheets(摘要、渠道明细、原始数据分页,条件格式、迷你图公式、图表对象)。
- 归档报告快照到品牌洞察历史,记录投递日志用于审计与节奏跟踪。
使用方式
脚本位于插件 scripts/ 文件夹,需 Python 3.10 或更新版本,使用 python 或 python3 运行。若宿主未设置 ${CLAUDE_PLUGIN_ROOT},脚本在插件 scripts/ 目录下。
用户需提供或会被提示提供:报告类型、投递渠道、日期范围(最近 7 天、30 天、上季度、自定义起止日期,或 "since last report" 自动检测上次投递时间戳)、收件人(可选)、自定义指标(可选)、对比周期(可选)、报告品牌(可选)、叙述深度(可选)、活动筛选(可选)、基准(可选)、注释(可选)、分发计划(可选)、高管受众(可选)。
执行门禁(强制,不可跳过):在接触任何实时系统前,必须展示完整预览——收件人 / 花费 / 变更 / 合规——作为 Execution Summary。用户必须输入 yes(或等效的明确批准)。任何其他输入——模糊、暗示、部分或缺失批准——都会取消运行。绝不在模糊输入下继续。绝不自动重试失败执行;失败需人工审查后才能重跑。
仅在用户输入 yes 后记录审批:
python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"send-report","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'
然后:
python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}
若任一命令出错,停止并报告错误,绝不用其他工具绕过。该记录证明审批步骤已运行,但不能证明是谁输入了 yes。
执行:通过 connector_executor.py 的写入需要 --approval-id,且仅针对匹配、未使用、未过期的记录触发(见 /digital-marketing-pro:execute-action)。通过已连接 MCP 服务器工具的写入不在该代码检查范围内:它依赖此处的输入 yes 和宿主的权限提示。之后运行:
python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'
(或 failure)。
适用场景
- 定期向团队或客户发送营销绩效周报、月报、季度业务回顾。
- 需要将多平台分析数据汇总为统一报告并投递到 Slack、邮件或 Google Sheets。
- 需要对照目标跟踪 KPI、检测异常并获取可执行建议。
- 需要为报告设置自动重复分发计划。
限制
- 执行前必须获得用户明确输入 yes 的批准,任何模糊或缺失批准都会取消运行。
- 失败执行不会自动重试,需人工审查。
- 通过 MCP 服务器工具的写入依赖宿主权限提示,不在 approval-manager 代码检查范围内。
- 需要已连接的分析 MCP 服务器和品牌配置;若无品牌,会询问是否先设置品牌或使用默认值。
- 具体收费、价格、平台支持范围等资料未提供。