前言¶

在 Agent 裏接騰訊營銷（原騰訊廣告）開放能力時，往往會裝多個 tencent-ads 系列 Skill：報表、投放、賬戶查詢等。每個 Skill 調用接口都要帶 APIKEY；一旦密鑰未配置、過期或填錯，業務 Skill 會直接返回認證錯誤，Agent 也很難判斷該讓用戶改哪一項配置。

單獨在每個 Skill 裏各存一份密鑰，既重複又容易不一致。下面介紹 SkillHub 上的 騰訊營銷投放-鑑權（@tencent-adm/tencentads-auth），它專門負責憑證校驗與保存，供同賬號下所有騰訊營銷相關 Skill 共享。

這是什麼¶

騰訊營銷投放-鑑權 是騰訊營銷品牌發佈的 enterprise 來源 Skill，座標 @tencent-adm/tencentads-auth，當前版本 0.5.6，分類爲 ai-agent，標籤含 requires_api_key=true。

定位可以概括爲：騰訊營銷技能的 鑑權憑證管理 入口。它負責檢查 APIKEY 是否有效；當其他騰訊營銷（tencent-ads）系列 Skill 因認證失敗報錯時，引導用戶提供 APIKEY 並完成保存。官方說明強調：騰訊營銷 APIKEY 必須通過該技能保存，保存後由所有 tencent-ads 技能共用，無需在每個業務 Skill 裏重複配置。

核心功能¶

依據 SkillHub 與 API 摘要，已覈實的能力包括：

1. 校驗 APIKEY：在調用鏈路上確認當前密鑰是否可用，減少「密鑰無效卻繼續調接口」的無效重試。
2. 認證失敗時的引導：當 tencent-ads 系列 Skill 返回認證相關錯誤時，由本 Skill 接手，提示用戶補充或更新 APIKEY。
3. 統一存儲與共享：憑證經本 Skill 寫入後，同環境下的其他騰訊營銷 Skill 共享同一套密鑰，避免多 Skill 各配各的。

本 Skill 不替代具體投放、報表等業務接口；它是接入騰訊營銷 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

安裝本 Skill¶

安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。

skillhub install @tencent-adm/tencentads-auth --dir <skills 目錄>

在 Cursor 中，常用 skills 路徑爲：

skillhub install @tencent-adm/tencentads-auth --dir ~/.cursor/skills/

也可將下列提示詞發給支持 Skill 安裝的 AI，讓其按官方說明完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/tencentads-auth`。

安裝後若 Agent 未自動識別新 Skill，需按所用客戶端說明重啓或刷新技能目錄。

典型用法¶

公開頁面未給出獨立 REST 示例；實際用法與 騰訊營銷 Skill 套件 綁定，可按下面順序理解：

1. 先裝鑑權 Skill：在接入任意 tencent-ads 業務 Skill 之前或同時，安裝 @tencent-adm/tencentads-auth。
2. 通過本 Skill 保存 APIKEY：在 Agent 對話中按引導提交騰訊營銷開放平臺的 APIKEY；不要只在某個報表或投放 Skill 裏口頭說明密鑰而跳過鑑權 Skill。
3. 再調用業務 Skill：賬戶、報表、投放等 tencent-ads Skill 複用已保存憑證；若仍報認證錯誤，回到鑑權 Skill 檢查密鑰是否有效或需更新。

具體保存字段名、本地存儲路徑以 Skill 包內 SKILL.md 及運行時行爲爲準；本文僅複述官方摘要中的職責邊界。

適用場景與注意¶

適合誰

• 已在 Cursor、Claude Code、Codex 等支持 SkillHub 的 Agent 環境中使用騰訊營銷 API 的開發者或運營同學。
• 需要同時使用多個 tencent-ads 系列 Skill，並希望 一處配置、全局生效 的團隊。

需要注意

• 密鑰入口唯一：官方明確要求 APIKEY 必須通過本 Skill 保存；繞過它可能在部分 Skill 上反覆遇到認證失敗。
• 依賴 APIKEY：標籤 requires_api_key=true 表示使用前必須準備騰訊營銷開放平臺頒發的有效密鑰。
• 版本與來源：當前 SkillHub 展示版本爲 0.5.6，來源爲 enterprise，由騰訊營銷品牌發佈；升級可用 skillhub 對同一座標更新，並繼續指定正確的 --dir。
• 數據口徑：SkillHub 頁面展示的評分爲 100000，下載約 7089 次（統計隨平臺更新變化，寫作時以頁面爲準）。

結尾¶

騰訊營銷投放-鑑權解決的是多 Skill 場景下 APIKEY 分散、認證錯誤難排查的問題：先校驗、再引導保存、再供全系 Skill 共享。接入騰訊營銷 Agent 能力時，建議把它當作固定依賴一併安裝。

• SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/tencentads-auth
• API 摘要：https://api.skillhub.cn/tencent-adm/tencentads-auth