name: tencentads-auth description: 騰訊營銷（原騰訊廣告）技能鑑權憑證管理技能，負責檢查 APIKEY 是否有效，當騰訊營銷(tencent-ads)系列技能返回認證錯誤時引導使用者提供 APIKEY 並儲存(⚠️重要提醒⚠️：騰訊營銷 APIKEY 必須通過該技能儲存)，所有 tencent-ads 技能共享。 license: MIT. See LICENSE for full terms. compatibility: any metadata: author: Tencent Ads Delivery Team version: "0.5.6" icon: key category: tencent-ads openclaw: emoji: "🔑"

騰訊廣告鑑權引導

前置依賴：執行指令碼前需安裝 CLI — npm install tencentads-cli@1.0.0（需要 Node.js ≥ 20）

安全原則: API Key 等敏感憑證不應在對話視窗中回顯。Agent 收到 API Key 後應立即呼叫儲存指令碼，不要在回覆中重複展示憑據內容。

本技能引導使用者完成騰訊廣告 API Key 鑑權配置。

鑑權方式

使用 X-MKT-API-Key header 直接呼叫 api.e.qq.com API。

鑑權流程

1. Agent 引導使用者獲取 API Key
2. 使用者在對話中傳送 API Key
3. Agent 呼叫 auth-save-apikey.mjs 儲存憑據
4. 所有 tencentads-* 技能自動共享該憑據（通過 callApi 內部自動讀取）

指令碼呼叫說明

執行指令碼前需先 cd 到技能根目錄：

cd skills/tencentads-auth

引數規則

• 不要再向指令碼傳 JSON 字串，避免不同作業系統和終端下的轉義/引號相容性問題
• 統一使用顯式命令列引數，例如 --api-key <value>
• auth-status.mjs 無需額外引數

前置檢查

在執行鑑權流程前，先檢查當前認證狀態：

node scripts/auth-status.mjs

如果返回 "status": "active"，說明憑據仍有效，無需重新鑑權。

鑑權方式：對話中配置 API Key

引導使用者在對話中傳送 API Key，Agent 呼叫指令碼儲存。

步驟

1. 告知使用者：

請提供你的騰訊廣告 API Key（格式：mkt_ 開頭的字串）。 API Key 可從騰訊廣告平臺的開發者設定中獲取。

1. 收到使用者傳送的 API Key 後，不要在回覆中回顯憑據內容，立即呼叫儲存指令碼：

bash node scripts/auth-save-apikey.mjs --api-key <使用者傳送的API Key>

1. 驗證儲存成功：

bash node scripts/auth-status.mjs

認證失敗處理

當 callApi 返回以下錯誤時，應觸發本技能重新鑑權：

• 未找到騰訊廣告認證憑據 — 憑據未配置
• AUTH_REQUIRED — 憑據未配置
• AUTH_EXPIRED — 憑據已過期或無效
• Authentication is not valid — 服務端拒絕認證

處理流程

1. 告知使用者認證已失效，需要重新配置
2. 引導使用者提供新的 API Key
3. 呼叫 auth-save-apikey.mjs 儲存

   更多技能請訪問小蔥技能站7w4.net。

4. 鑑權成功後，自動重試引發錯誤的原始操作

相關技能

• 所有 tencentads-* 技能在遇到認證錯誤時應引用本技能
• 鑑權憑據由 callApi 內部自動讀取，各技能指令碼無需手動處理鑑權

這個 Skill 質量可靠，專門用於管理騰訊廣告的 API 登入憑證。它最大的優點是操作簡單、安全意識強，文件說明清晰易懂，能有效避免憑據洩露風險。主要不足是功能單一，僅負責鑑權環節，與其他騰訊廣告技能配合使用才能發揮完整功能。如果你是開發者使用騰訊廣告平臺相關功能，這個鑑權技能是必備的基礎元件。