用途:根据用户的一段纯文本广告活动描述,解析为结构化的 Spotify Ads API 调用,创建完整的广告活动层级(Campaign → Ad Sets → Ads)。
主要能力:默认走草稿流程(路由到 /spotify-ads-api:drafts build <描述>),先创建草稿实体、对整个层级做批量校验,确认后才发布;草稿可安全迭代、便于撤销,发布前必须获得用户显式确认。仅当用户明确要求跳过草稿或立即创建线上实体时,才使用直接创建流程。
使用方式(直接创建流程):先设置插件根目录并定义请求包装: PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}" api() { "$PLUGIN_ROOT/scripts/api-request.sh" build-campaign "$@"; } 首次调用 Ads API v3 前需阅读 $PLUGIN_ROOT/skills/api-reference/references/live-openapi.md。可用 api --env 获取 TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL 等设置。流程为:解析描述、加载广告产品规则、以可视化树和表格确认计划、对每个 ad set 运行受众规模估算(POST /estimates/audience,注意不在 /ad_accounts/{id}/ 下)、提示选择素材、校验最终层级、按顺序执行创建(campaigns → ad_sets → ads,逐级传递 ID),最后输出实体汇总表。
必要约束:bid_strategy 是字符串枚举;geo_targets 为扁平对象 {"country_code":"US"};platforms 仅 ANDROID、DESKTOP、IOS;ad set 必须提供 ADV_X_Y 类目代码;LIFETIME 预算必须给 end_time;AUDIO 广告需要 companion_asset_id;call_to_action 字段名为 key 与 clickthrough_url;预算以微单位表示(金额 × 1,000,000);存在最小受众阈值。
auto_execute 为 true 时展示计划后直接执行,为 false 时需先确认;出错即停止,父实体失败时不继续创建子实体,且不自动重试 POST。
适用场景:需要按自然语言描述批量搭建 Spotify 广告活动层级并希望在发布前校验与复核的流程。
限制:受众过小导致 400 时不重发同一请求、不自行放宽定向,只能建议调整后重新估算或取消。其余如具体收费、价格与更多平台细节暂未提供。