SuperAPI AI 工具集

monitor

部署与运维

查看项目

更新于 10-16 09:30

技能介绍

用途:通过 Spotify Ads API v3 诊断活跃广告系列的投放问题,超出仪表盘范围,运行诊断检查并给出具体行动建议。

主要能力:账户级健康检查(默认,无参数或 --all)覆盖所有活跃广告系列,检查三项——1)投放节奏:按 DAILY 或 LIFETIME 预算比较花费进度与时间进度,差距 20 点内为 OK,20–40 点为 WARNING,超过 40 点或开始超 24 小时零花费为 CRITICAL;2)停滞投放:活跃系列当天零曝光且开始超 4 小时则标记 STALLED;3)预算耗尽:按当前日消耗率预测 LIFETIME 预算何时用完,提前耗尽或结束时空余超 20% 会被标记。深度检查(传入 campaign_id)额外诊断广告层级:被拒广告、待审核超 24 小时、活跃广告组下关闭投放的广告,以及受众疲劳(终身频次超 3.0 或曝光超 1 万且 CTR 低于 0.1%)。

使用方式:设置插件根目录并定义请求包装 PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}" 与 api() { "$PLUGIN_ROOT/scripts/api-request.sh" monitor "$@"; };首次调用 Ads API v3 前需阅读 $PLUGIN_ROOT/skills/api-reference/references/live-openapi.md;用 api --env 获取 TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL 等设置值(输出可安全 eval)。参数为无/--all 或具体 campaign_id(UUID)。auto_execute 为 true 时直接执行并显示结果,否则先展示 curl 命令并请求确认;需检查 HTTP_STATUS 判断成败,出错时显示错误信息并继续处理已有数据。

限制:仅针对 Spotify Ads API;调度自动检查需宿主环境支持定时任务,否则仅支持手动运行;预算 micro_amount 需除以 1,000,000 换算;其余限制暂未提供。