前言¶

在 B 站三连推广里，很多账户仍在使用旧版三层结构：计划承载推广目的与预算，单元承载定向、排期与出价，创意承载素材与展示形态。若要在 Agent 里完成建计划、改出价、批量启停或查创意审核，通常要对照 MAPI 文档拼请求、处理 OAuth 与字段枚举，还要区分 v3 旧结构与创意驱动 2.0 的 v4 接口。

下面介绍 SkillHub 上的 B站三连广告-广告管理（包内标识 bilibili-sanlian-ads-ad-management）。它把旧版广告对象的保存、查询、列表、审核信息、一键起量、账户智能衍生开关，以及计划/单元/创意的异步批量操作封装成可执行的 Skill 流程，并附带与官方文档同步的 references/ 字段说明。

这是什么¶

B站三连广告-广告管理 面向 Bilibili Sanlian Ads Marketing API（MAPI）的 LEGACY 三层创编：campaign / unit / creative（计划 / 单元 / 创意）。Skill 内说明由作者 Benjamin 维护，当前 SkillHub 检索到的版本为 3.0.4，分类为 business-ops（运营类）。

它解决的是：在已有 access_token 与广告主 account_id 的前提下，让 Agent 按规范调用 v3 端点，而不是手写零散 HTTP 或混用 2.0 接口。与同属三连广告技能族的 B站三连广告-授权与主流程（bilibili-sanlian-ads）、广告元数据、素材上传 等配合使用：授权与账户范围走主流程 Skill，枚举与可投资源先查元数据，素材先走素材 Skill，本 Skill 专注对象本身的读写与批量任务。

官方入口（任务给定）：https://api.skillhub.cn/user_b0010d5c/sanlian-ads-ad-management

SkillHub 社区页（2026-10-20 检索为可安装包 @indiv-benjamin/sanlian-ads-ad-management，与上述简介一致）：可通过 CLI skillhub search sanlian-ads-ad-management 定位。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与接口索引，对应 v3 路径（基域 https://cm.bilibili.com/takumi/api）。

计划、单元、创意¶

• 保存与更新：POST /open_api/cpc/v3/campaign/save、/unit/save、/creative/save
• 单条查询：GET .../campaign/get、/unit/get、/creative/get
• 列表：GET .../campaign/list_campaigns、/unit/list_units、/creative/list_creatives
• 创意批量滚动查询：POST /open_api/cpc/v3/creative/scroll/query

创编顺序固定为自上而下：先有计划 ID，再建单元，再建创意；每一层保存后应 查询回读 验证，而不是重复提交保存。

创意审核与账户开关¶

• 批量查询创意原生审核信息：POST /open_api/cpc/v3/creative/audit/extra/info/query
• 账户智能衍生：查询 GET /open_api/cpc/v3/account/smart_derivative，设置 POST 同路径

一键起量¶

针对符合条件的 oCPC/oCPM 在投单元，通过 get_remaining_budget、accelerate、finish_accelerate 等 v3 单元接口操作；Skill 要求先查剩余预算，单次最多 20 个单元，并逐条检查返回中的 operate_code。

异步批量操作¶

本 Skill 拥有 计划/单元/创意三层的批量接口（旧版对象专用），例如：

• POST /open_api/cpc/v3/batch/update_campaign
• POST /open_api/cpc/v3/batch/update_unit
• POST /open_api/cpc/v3/batch/update_creative
• 任务列表与详情：GET .../batch/list_operations、/batch/list_operation_details

单次请求只做一种 operation_type；提交后需轮询任务状态，并在任务详情中检查 每个对象 的结果，顶层成功不代表全部成功。

明确不支持的范围¶

• 仅覆盖 旧版三层 v3 端点，不能 读写创意驱动投放 2.0 的 project / media（v4 /open_api/cpc/v4/*）。
• 白名单账户新建广告应路由到 bilibili-sanlian-ads-delivery；本 Skill 仍用于已有旧版广告的编辑与查询。

中文触发词（Skill 自述）：计划、单元、创意、建计划、建单元、建创意、广告搭建、启停、批量操作、批量修改、一键起量、智能衍生、旧版广告。

安装与启用¶

1、安装 SkillHub CLI¶

若终端尚未有 skillhub，按 SkillHub 安装文档执行：

command -v skillhub && skillhub --version

未安装时可使用：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明来源：https://skillhub.cn/install/skillhub.md

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。

skillhub install sanlian-ads-ad-management --namespace indiv-benjamin --dir ~/.cursor/skills

• Cursor：常用目录为 ~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex CLI：~/.codex/skills/ 或项目下 .agents/skills/

安装完成后重启或重新加载 Agent，使 Skill 生效。

3、前置依赖（与三连广告技能族）¶

本 Skill 不替代授权。调用前需具备有效 access_token 与广告主 account_id；缺失时先使用 B站三连广告-授权与主流程（bilibili-sanlian-ads）。保存前应从 B站三连广告-广告元数据 查询可选枚举与资源 ID；创意所需图片/视频应先通过 B站三连广告-素材上传 准备。

包内要求：所有 MAPI 调用经 scripts/mapi.sh（Windows 为 py -3 scripts/mapi_client.py），不要手写 curl 对 MAPI 并发多账户请求。请求头需包含 Authorization: Bearer {access_token}、X-Call-Source: sanlian-skills、X-Sanlian-Skills-Version: 3.0.4（与当前包版本一致）。

典型用法¶

从零搭建一条旧版广告¶

在对话中可用自然语言描述目标（例如应用下载、日预算、定向），并带上触发词「建计划」「建单元」「建创意」。Agent 在启用本 Skill 后，宜按包内 Creation Order 执行：

1. 用 bilibili-sanlian-ads 确认 token 与 account_id。
2. 用 bilibili-sanlian-ads-metadata 查询推广目的及单元所需推广内容、优化目标、出价区间、定向等。
3. 展示计划预览并经用户确认后，调用计划保存接口，再 查询 得到 campaign_id。
4. 按确认分支查询单元元数据，保存单元并回查 unit_id。
5. 素材就绪后查询创意版位/模板约束，保存创意并回查 creative_id，必要时查审核信息。

字段与枚举以包内 references/ 为准（如 505_计划保存.md、509_单元保存.md、524_创意保存.md），不要猜测枚举值。

通过 mapi 脚本发起单次调用¶

Skill 规定 MAPI 统一入口形如：

call <METHOD> <path> [--query-file q.json] [--body-file body.json]

例如查询单个计划时，路径为 GET /open_api/cpc/v3/campaign/get（完整 query 字段见 references/506_计划查询.md）。由 mapi.sh 负责加载/刷新 token、附加头信息与限速，Agent 根据响应体判断业务成败（不仅看 HTTP 状态码）。

批量修改与任务轮询¶

批量启停或改预算的典型步骤：

1. 先 列表或查询 当前对象状态，向用户展示变更前后值。
2. 选定单一 operation_type，按 references/541_批量操作计划.md（或单元/创意对应文档）组 operations 数组；注意单次最多 100 个 ID、不可混用多种操作类型。
3. 提交后记录 operation_id，按 Skill 建议间隔轮询 list_operations，终态后再查 list_operation_details 逐对象核对。
4. 对可查询的字段做读回验证，再决定是否提交下一批。

一键起量¶

对用户说明将产生真实消耗后，先查单元剩余预算，再调用加速接口；检查每个单元的 operate_code，不要仅看顶层 status: success。

适用场景与注意¶

适合谁

• 投放、代运营、内部工具开发者：账户仍以旧版计划-单元-创意为主，需要在 Cursor / Claude Code 等环境里用自然语言驱动 MAPI。
• 已接入三连 MAPI、希望 Agent 遵守官方字段表与批量异步语义，而不是临时拼接口的团队。

使用注意

• 与 2.0 严格隔离：新建创意驱动项目请走 delivery 相关 Skill；本 Skill 误用会导致读写错误对象类型。
• 写操作纪律：遵循主流程 Skill 的分阶段确认、金丝雀批量、错误即停；批量任务完成不等于每个 ID 成功。
• 元数据先行：未通过 metadata 确认的枚举、资源 ID 容易导致保存失败或静默写入非预期值。
• 社区数据（任务线索，供选型参考）：SkillHub 评分约 99554，下载约 2457 次；以社区页面实时显示为准。

结尾¶

B站三连广告-广告管理 把三连旧版广告最核心的对象操作与批量任务收敛到一个 Skill：v3 创编、审核与起量、智能衍生开关，以及异步批量的任务追踪。与授权、元数据、素材类 Skill 串联后，更适合在 Agent 里做可审计、可回读的投放变更。

官方地址：https://api.skillhub.cn/user_b0010d5c/sanlian-ads-ad-management

安装与 CLI 说明：https://skillhub.cn/install/skillhub.md