前言¶
投放團隊在對接騰訊營銷（原騰訊廣告）時，常見操作是登錄投放端或走開放平臺接口：拉關聯廣告主列表、看日預算與資金餘額、覈對共享錢包。若希望在 Cursor、Claude Code 等支持 Skills 的客戶端裏用自然語言完成同類查詢，並在授權範圍內改日預算，需要把官方能力封裝成 Agent 可調用的 Skill，而不是每次手寫 HTTP 請求。
下面介紹 SkillHub 上的企業級 Skill「騰訊營銷投放-廣告主」（座標 @tencent-adm/tencentads-advertiser），由騰訊營銷品牌發佈，當前版本 0.5.8，分類爲 business-ops，並標註 requires_api_key=true。
這是什麼¶
「騰訊營銷投放-廣告主」是面向騰訊營銷廣告主信息與賬戶管理的 Agent Skill。發佈方爲騰訊營銷品牌，來源類型爲 enterprise，在 SkillHub 上的簡介爲：騰訊營銷（原騰訊廣告）廣告主信息查詢與管理技能，支持查詢關聯廣告主賬號列表、查詢/修改賬戶日預算、查詢資金賬戶餘額、查詢共享錢包信息。
它解決的是「在對話式開發環境裏完成廣告主側只讀與有限寫操作」的問題，能力邊界以 Skill 說明與騰訊營銷開放接口爲準，不替代投放後臺的全部功能。
核心功能¶
以下能力均來自 SkillHub 官方簡介，安裝並配置 API 密鑰後，由 Agent 按 Skill 指引調用後端接口：
- 關聯廣告主賬號列表：查詢當前授權下可操作的廣告主賬號。
- 賬戶日預算：查詢賬戶日預算，並在允許範圍內修改。
- 資金賬戶餘額：查詢資金賬戶可用餘額等信息。
- 共享錢包：查詢共享錢包相關信息。
Skill 基於通用 SKILL.md 格式分發；具體字段、權限與接口行爲以騰訊營銷開放平臺及該 Skill 包內文檔爲準。
安裝與啓用¶
安裝 SkillHub CLI（如尚未安裝）¶
先確認本機是否已有 skillhub：
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
安裝說明全文見：https://skillhub.cn/install/skillhub.md
安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被客戶端加載。
skillhub install @tencent-adm/tencentads-advertiser --dir <skills目錄>
常用客戶端 skills 目錄示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
SkillHub 技能頁也提供面向 AI 的安裝提示：請根據 https://skillhub.cn/install/skillhub.md，安裝 @tencent-adm/tencentads-advertiser。
API 密鑰¶
該 Skill 在 SkillHub 上帶有標籤 requires_api_key=true，使用前需按 Skill 包內說明配置騰訊營銷相關 API 密鑰；未在公開頁面覈對到的具體環境變量名或配置文件路徑，請在安裝後閱讀 Skill 目錄中的 SKILL.md 及附帶說明完成配置。
典型用法¶
公開資料未附帶固定腳本示例時，用法以自然語言驅動 Agent、由 Skill 路由到對應接口爲主。可與簡介中的四類能力對齊，例如：
- 讓 Agent「列出我關聯的廣告主賬號」——對應查詢關聯廣告主賬號列表。
- 指定廣告主 ID 後「查詢該賬戶日預算」或「將日預算調整爲某金額」——對應查詢/修改賬戶日預算（修改需具備寫權限）。
- 「查詢某廣告主資金賬戶餘額」——對應資金賬戶餘額查詢。
- 「查詢共享錢包信息」——對應共享錢包查詢。
實際請求參數、返回結構與錯誤碼以 Skill 實現及騰訊營銷 API 文檔爲準；改預算類操作建議在 Agent 執行前確認賬號與金額，避免誤操作。
適用場景與注意¶
適合誰：在 business-ops 場景下做投放運維、財務對賬、多賬號巡檢的開發者或運營，已具備騰訊營銷 API 訪問權限，並希望在 IDE Agent 內完成高頻查詢與受控的預算調整。
平臺側信息（SkillHub，截至資料抓取）：評分 100000，下載 7563，安裝 9；官方技能頁與 API 入口分別爲 https://www.skillhub.cn/skills/tencent-adm/tencentads-advertiser 與 https://api.skillhub.cn/tencent-adm/tencentads-advertiser。
注意：
- 企業級 Skill，需有效 API Key 與接口授權；只讀與寫操作權限可能不同。
- 修改日預算屬於寫操作，應在測試賬號或明確審批流程下使用。
- 客戶端需重啓或刷新 Skills 緩存後，新安裝的 Skill 纔會生效（以各客戶端文檔爲準）。
結尾¶
「騰訊營銷投放-廣告主」把廣告主列表、日預算、資金餘額與共享錢包四類常見操作收斂到 Agent Skill，減少重複查文檔和拼請求的工作。安裝座標爲 @tencent-adm/tencentads-advertiser，可從 SkillHub 技能頁或官方 API 地址獲取詳情：https://www.skillhub.cn/skills/tencent-adm/tencentads-advertiser
