騰訊營銷投放-廣告主
📖 技能介紹
name: tencentads-advertiser description: "騰訊營銷（原騰訊廣告）廣告主資訊查詢與管理技能。支援查詢關聯廣告主賬號列表、查詢/修改賬戶日預算、查詢資金賬戶餘額、查詢共享錢包資訊、獲取資金賬戶日結明細" license: MIT. See LICENSE for full terms. compatibility: any metadata: author: Tencent Ads Delivery Team version: "0.5.7" icon: users category: tencent-ads
騰訊廣告 - 客戶賬號查詢技能
前置依賴：執行指令碼前需安裝 CLI —
npm install tencentads-cli@1.0.0（需要 Node.js ≥ 20） - 指令碼呼叫: 所有 API 操作通過本 Skill 目錄下的指令碼執行，格式為node scripts/<指令碼名>.mjs '<JSON引數>'。 - 認證依賴: 本技能依賴tencentads-auth技能配置的 API Key 憑據，如遇認證錯誤請先完成鑑權。 指令碼呼叫格式統一：node scripts/<指令碼名>.mjs '<JSON 引數>'執行指令碼時先進入本 skill 根目錄，再按相對scripts/路徑呼叫。
⚠️ 跨平臺 JSON 引數傳遞規則（經實測驗證）
指令碼呼叫格式為 node scripts/<指令碼名>.mjs '<JSON引數>'，但 JSON 引數的引號包裹方式因作業系統/終端而異，傳遞不當會導致 JSON.parse 報錯（如 Expected property name or '}' in JSON at position 1）。
| 終端環境 | 正確寫法 | 說明 |
|---|---|---|
| Linux / macOS (Bash/Zsh) | node scripts/xxx.mjs '{"key":"value"}' |
✅ 單引號包裹，內部雙引號原樣保留 |
| Windows Git Bash | node scripts/xxx.mjs '{"key":"value"}' |
✅ 同 Bash |
| Windows CMD | node scripts/xxx.mjs "{\"key\":\"value\"}" |
✅ 雙引號包裹 + 反斜槓轉義 |
| Windows CMD (備選) | node scripts/xxx.mjs "{""key"":""value""}" |
✅ 雙引號包裹 + 雙雙引號轉義 |
| Windows PowerShell 5.x | node --% scripts/xxx.mjs "{\"key\":\"value\"}" |
✅ 必須加 --% 停止解析符 |
| Windows PowerShell 5.x (備選) | node scripts/xxx.mjs "{\`"key\`":\`"value\`"}" |
✅ 反斜槓 + 反引號組合轉義 |
⛔ PowerShell 5.x 是重災區：單引號
'...'、反引號`"、反斜槓\"三種常見寫法全部失敗（雙引號會被吞掉）。必須使用--%停止解析符或\`"組合轉義。 ⛔ Windows CMD 不支援單引號包裹字串，單引號會被當作普通字元傳入指令碼，導致 JSON 解析失敗。
指令碼列表
| 指令碼 | 功能 | 必填引數 | 可選引數 |
|---|---|---|---|
scripts/get-account-list.mjs |
查詢當前使用者關聯的競價廣告主賬號列表 | - | corporation_name_fuzzy_list, page, page_size |
scripts/get-daily-budget.mjs |
查詢賬戶日預算 | account_id | - |
scripts/update-daily-budget.mjs |
修改賬戶日預算 | account_id, daily_budget | use_min_daily_budget |
scripts/get-funds.mjs |
查詢資金賬戶資訊（餘額/鎖定金額/今日消耗） | account_id | fund_type_list |
scripts/get-wallet.mjs |
查詢共享錢包資訊（餘額/繫結賬戶等） | account_id | - |
scripts/get-daily-balance-report.mjs |
獲取資金賬戶日結明細（包含日終結餘） | account_id, date_range | page, page_size |
scripts/get-wallet-basic-info.mjs |
通過錢包 ID 查詢共享錢包基礎資訊 | account_id, wallet_id | - |
查詢廣告主賬號列表
呼叫 user_account_list/get 介面，獲取當前 user_id 下關聯的競價廣告主賬戶資訊列表。
⚠️ 僅返回競價廣告主賬戶，不包含代理商等其他型別賬戶。
# 查詢全部關聯賬號（預設分頁）
node scripts/get-account-list.mjs
# 按公司名稱模糊搜尋（最多 2 個關鍵詞，每個 2~50 字元）
node scripts/get-account-list.mjs '{"corporation_name_fuzzy_list":["廣州","西安"]}'
# 指定分頁引數（page_size 範圍 1~500）
node scripts/get-account-list.mjs '{"page":2,"page_size":20}'
分頁上限限制：嚴格要求
page * page_size <= 13000，超出此限制介面將報錯。
介面詳情見: references/user-account-list-get.md
適用場景
場景 A：使用者需要查詢某個公司的競價廣告主賬號
- 從使用者描述中提取公司名稱關鍵詞
- 呼叫
get-account-list.mjs，傳入corporation_name_fuzzy_list7w4.net小蔥技能站，你的AI助手技能庫。
- 將匹配到的賬號列表展示給使用者
場景 B：使用者需要瀏覽所有關聯的競價廣告主賬號
- 呼叫
get-account-list.mjs（不傳引數或僅傳分頁引數） - 展示第一頁結果和分頁資訊
- 如果有多頁，告知使用者總數並詢問是否需要檢視更多
注意事項
- 僅支援競價廣告主：
get-account-list.mjs僅返回競價廣告主賬戶，不包含其他型別 - 無需傳入 account_id：
get-account-list.mjs介面基於當前登入使用者的 user_id 查詢，不需要指定廣告主賬號 - 分頁預設值：不傳
page預設為 1，不傳page_size預設為 10 - 模糊匹配限制：
corporation_name_fuzzy_list最多傳 2 個字串，每個字串長度限制 2~50 個字元 - 認證依賴：本技能依賴
tencentads-auth技能配置的 API Key 憑據，如遇認證錯誤請先完成鑑權 - 分頁上限限制：
get-account-list.mjs嚴格要求page * page_size <= 13000，超出此限制介面將報錯 - 所有列舉值禁止猜測，必須通過
get-enum-options.mjs查詢確認：
錯誤處理
- 如果返回認證錯誤，引導使用者使用
tencentads-auth技能重新配置 API Key - 如果
corporation_name_fuzzy_list引數不合法（超過 2 個、字串長度不在 2~50 範圍），指令碼會返回明確的錯誤提示 - 如果查詢結果為空，告知使用者未找到匹配的賬號，建議調整搜尋關鍵詞或檢查是否有關聯賬號
介面文件索引
| 功能 | 文件 | 說明 |
|---|---|---|
| 廣告主賬號列表查詢 | user-account-list-get.md | 查詢當前使用者關聯的競價廣告主賬號列表 |
| 賬戶日預算查詢與修改 | advertiser-daily-budget.md | 查詢當前日預算、修改日預算，含 Agent 使用流程和 use_min_daily_budget 決策規則 |
| 資金賬戶資訊查詢 | funds-get.md | 查詢各類資金賬戶餘額、鎖定金額、今日消耗，支援按 fund_type 過濾 |
| 錢包資訊查詢 | wallet-get.md | 查詢共享錢包餘額、名稱、代理商、主體及繫結賬戶資訊 |
| 資金賬戶日結明細查詢 | daily-balance-report-get.md | 查詢資金賬戶日結明細，包含日終結餘資料，支援按日期範圍查詢 |
| 錢包基礎資訊查詢（按錢包 ID） | wallet-basic-info-get.md | 通過錢包 ID 查詢共享錢包基礎資訊，含資金資訊和監控預警 |
相關技能
- tencentads-auth - 配置 API Key 鑑權憑據
🤖 AI 評測
這個 Skill 質量不錯，操作簡單，功能實用。文件寫得很清楚，特別是針對不同電腦系統給出了具體的命令寫法示例，新手也能快速上手。指令碼執行穩定，錯誤提示友好，能準確告訴你哪裡出了問題。不過它只能查賬戶和改預算，想做廣告投放或看詳細報表就不行了，而且必須先配置另一個認證技能才能用，稍微麻煩了點。
