前言¶
在騰訊營銷（原騰訊廣告）裏做投放運維或數據分析時，常見路徑是登錄投放平臺、在多個廣告賬戶之間切換，再逐層點開營銷單元、創意和素材去看配置與報表。賬戶多、層級深時，重複點擊和導出既慢，也不方便把「定向、出價、版位、轉化」等字段一次性交給 coding Agent 做彙總或覈對。
下面介紹 SkillHub 上的企業級 Skill「騰訊營銷投放-廣告管理」（座標 @tencent-adm/tencentads-management）。它把官方營銷 API 能力封裝成 Agent 可調用的工具，用對話完成跨賬戶查詢、配置查看和部分關鍵詞管理，減少手工在後臺翻頁。
這是什麼¶
「騰訊營銷投放-廣告管理」是面向騰訊營銷投放體系的管理類 Skill，由 騰訊營銷品牌 在 SkillHub 發佈，來源標註爲 enterprise，當前頁面版本爲 v0.5.8，分類爲 business-ops。標籤標明 requires_api_key=true，使用前需要配置騰訊營銷側 API 憑證（具體字段以 Skill 包內 SKILL.md 及官方開放平臺文檔爲準）。
SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/tencentads-management
API 索引地址：https://api.skillhub.cn/tencent-adm/tencentads-management
一句話定位：在 Agent 對話中完成騰訊營銷多層級對象（營銷單元 / 創意 / 素材等）的數據與報表查詢、完整配置查看，以及關鍵詞與否定詞的增刪改查。
核心功能¶
以下能力與 SkillHub 簡介一致，未在資料中出現的接口細節不展開。
-
跨賬戶查詢與報表
支持跨廣告賬戶查詢營銷單元（平臺用語中對應原「廣告」）、創意、素材等多層級數據，並獲取報表指標。 -
營銷單元與智能投放配置
可查看營銷單元完整配置，包括定向、出價、轉化、版位等；可查看智能投放項目詳情。 -
創意與素材預覽
可獲取創意列表及組件詳情；當上下文爲單條創意時，Skill 會解析組件並拉取圖片或視頻的預覽 URL，便於在對話裏覈對素材。 -
搜索關鍵詞管理
支持關鍵詞與否定詞的增、刪、改、查。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式，通過 SkillHub 安裝到當前 Agent 的 skills 目錄後纔會被識別。
方式一：讓 Agent 按官方安裝文檔執行¶
SkillHub 頁面給出的安裝提示詞如下，可直接發給 Cursor、Claude Code 等支持 Skills 的客戶端：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/tencentads-management`。
Agent 會按 SkillHub 安裝與優先源配置 檢查或安裝 skillhub CLI，並把 Skill 裝到對應目錄。
方式二：本機使用 skillhub CLI¶
若已安裝 SkillHub CLI，安裝時必須用 --dir 指向當前 Agent 的 skills 目錄（裝到默認 ./skills/ 可能不會被客戶端加載）。常見路徑示例：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令形式：
skillhub install @tencent-adm/tencentads-management --dir <你的 skills 目錄>
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
API Key¶
該 Skill 標記爲需要 API Key。安裝並啓用後，應在 Skill 說明或環境變量中配置騰訊營銷開放平臺頒發的訪問憑證；未配置時，與賬戶、報表相關的工具調用通常會失敗。憑證權限需覆蓋你打算查詢或修改的賬戶與接口範圍。
典型用法¶
官方頁面主要提供安裝指引，未附帶獨立腳本示例。安裝完成並配置 API Key 後，用法是在對話中用自然語言描述賬戶範圍與目標對象，由 Agent 選擇 Skill 內工具。可與簡介對齊的提問方向包括：
- 「列出某賬戶下營銷單元及昨日核心報表指標。」
- 「查看指定營銷單元的定向、出價、轉化與版位配置。」
- 「拉取某創意的組件詳情，並給出圖片/視頻預覽鏈接。」
- 「爲某計劃新增否定詞 / 查詢現有關鍵詞列表。」
具體參數名、賬戶 ID 格式以 Skill 內文檔與騰訊營銷 API 爲準；不要在對話中粘貼未脫敏的生產密鑰。
適用場景與注意¶
適合誰
- 需要在多個廣告賬戶間做配置覈對、報表拉取或創意素材檢查的投放、增長或運營同學。
- 希望把「查配置 + 簡單關鍵詞維護」交給 Agent，而不是每次登錄後臺手工導出的人。
限制與注意
- 依賴 requires_api_key 與接口權限，沙箱或無網環境需自行處理 CLI 安裝與 API 連通性。
- 跨賬戶、報表與寫操作（關鍵詞增刪改）均受平臺配額與賬戶授權約束；批量變更前建議在測試賬戶驗證。
- SkillHub 統計（頁面抓取時）：評分 100000，下載 8947，安裝 12；數據隨 SkillHub 更新變化，以頁面爲準。
結尾¶
「騰訊營銷投放-廣告管理」把騰訊營銷多層級投放對象和報表能力收斂到一個 Agent Skill 裏，適合用對話完成跨賬戶查詢、配置查看、創意預覽鏈接獲取和關鍵詞管理。安裝與座標以 SkillHub 爲準：
- https://www.skillhub.cn/skills/tencent-adm/tencentads-management
- https://api.skillhub.cn/tencent-adm/tencentads-management
