前言¶

在 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