前言¶
投放同學在後臺改預算、調時段、開關狀態,往往要在騰訊廣告營銷投放平臺裏逐條點選。多賬號、多營銷單元一起改時,重複操作多,也容易漏改或改錯字段。把「更新營銷單元(原廣告)或智投項目」封裝成 Agent Skill,可以在 Cursor、Claude Code 等支持 Skills 的客戶端裏,用自然語言說明要改什麼,由 Agent 按 Skill 約定調用官方能力,而不是每次自己翻文檔拼請求。
下面介紹 SkillHub 上的 騰訊營銷投放-更新廣告(座標 @tencent-adm/tencentads-delivery-standard-update,當前版本 0.5.8),以及安裝方式與使用邊界。
這是什麼¶
騰訊營銷投放-更新廣告 是騰訊營銷品牌發佈的企業來源(enterprise)Skill,分類爲 business-ops。它面向營銷單元(原廣告)與智投項目的通用更新:一次 Skill 覆蓋名稱、投放日期、定向、時段、出價、預算、狀態、深度轉化、一鍵起量、創意增強等字段的修改,並支持單個對象更新,以及多賬號、多營銷單元/多項目的批量更新。
Skill 標註 requires_api_key=true,使用前需要具備可用的 API 密鑰並完成配置(具體字段以安裝後的 SKILL.md 與騰訊營銷投放開放能力文檔爲準)。
在 SkillHub 上,該 Skill 評分爲 100000,下載 6573 次,安裝 7 次(數據取自 SkillHub 頁面,會隨時間變化)。
核心功能¶
以下能力均來自官方簡介,未在資料中出現的接口名或參數不寫進正文。
- 營銷單元(原廣告)更新:修改名稱、投放日期、定向、投放時段、出價、預算、啓停狀態,以及深度轉化、一鍵起量、創意增強等相關配置。
- 智投項目更新:與營銷單元側類似的字段級更新,適用於智投項目維度的投放調整。
- 單對象更新:指定一個營銷單元或一個智投項目進行修改。
- 批量更新:跨多個廣告賬號,對多個營銷單元或多個智投項目執行同一類或組合字段的更新。
Skill 本身不替代投放策略判斷;它解決的是「已知要改什麼、改到哪」時的執行與批量效率問題。
安裝與啓用¶
安裝流程以 SkillHub 官方說明爲準:先確保本機有 skillhub CLI,再把 Skill 裝進當前 Agent 的 skills 目錄。
1. 檢查 CLI
command -v skillhub && skillhub --version
若未安裝,可按 SkillHub 文檔執行完整安裝(含 CLI 與默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本 Skill
安裝時必須用 --dir 指向當前客戶端的 skills 目錄,否則默認落在 ./skills/ 且 Agent 可能無法加載。常見路徑示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
以 Cursor 爲例:
skillhub install @tencent-adm/tencentads-delivery-standard-update --dir ~/.cursor/skills/
SkillHub 頁面也支持把下面這句發給 AI,由 Agent 按 SkillHub 安裝文檔 完成安裝:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@tencent-adm/tencentads-delivery-standard-update`。
3. API 密鑰
標籤 requires_api_key=true 表示調用投放更新能力前需配置密鑰。密鑰獲取方式、環境變量名或配置文件路徑以 Skill 包內 SKILL.md 及騰訊營銷投放開放平臺要求爲準;本文不列舉未在公開頁面出現的配置項名。
安裝或更新 Skill 後,按所用客戶端說明重啓或刷新 Agent,使新 Skill 生效。
典型用法¶
公開頁面未提供逐字段的 HTTP 示例;可復現的用法是:在已安裝 Skill 且 API 密鑰就緒的前提下,用自然語言向 Agent 描述更新意圖,由 Agent 讀取 Skill 說明並調用對應能力。
示例表述(僅說明交互方式,非官方固定話術):
-
單條改預算與狀態
「在賬號 XXX 下,把營銷單元 ID 爲 YYY 的日預算改爲 5000 元,並設爲投放中。」 -
改時段與出價
「智投項目 ZZZ 從今天起只在 9:00–22:00 投放,目標出價調整爲 1.2。」 -
批量
「賬號 A、B 下這幾個營銷單元 ID 列表,統一關閉一鍵起量,並把結束日期延到 2026-12-31。」
執行前建議在對話裏讓 Agent 彙總將要修改的賬號、對象 ID、字段與目標值,確認後再提交;批量場景尤其要先覈對 ID 列表,避免誤改非目標單元或項目。
適用場景與注意¶
適合誰
- 日常在騰訊營銷投放側做運維式調整(預算、時段、狀態、定向微調等)的投放或運營同學。
- 需要在多個賬號、多個營銷單元/項目上做相同規則變更、希望減少後臺重複點擊的團隊。
- 已在用 Cursor、Claude Code 等 Skills 生態,希望把「更新投放對象」納入對話工作流的技術同學。
限制與注意
- 依賴 API 密鑰 與騰訊營銷投放開放接口權限;賬號無權限的字段無法通過 Skill 繞過。
- 版本以 SkillHub 爲準(當前 0.5.8);升級可用
skillhub對同一座標執行更新,並再次確認SKILL.md變更。 - 深度轉化、創意增強等字段往往與廣告形態、優化目標綁定,改之前應在平臺側確認對象是否支持該字段,避免接口報錯。
- 批量更新前務必二次確認對象範圍;Skill 提高的是執行效率,不能替代投放審覈與合規檢查。
結尾¶
騰訊營銷投放-更新廣告 把營銷單元與智投項目的字段級更新、單條與批量場景收斂到一個 Skill 裏,適合把「改投放配置」從純後臺操作遷到 Agent 對話中執行。安裝與優先源策略見 SkillHub 安裝文檔;Skill 詳情與下載見 SkillHub 頁面,API 資源地址爲 https://api.skillhub.cn/tencent-adm/tencentads-delivery-standard-update。