腾讯营销投放-广告主
📖 技能介绍
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_list - 将匹配到的账号列表展示给用户
场景 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 质量不错，操作简单，功能实用。文档写得很清楚，特别是针对不同电脑系统给出了具体的命令写法示例，新手也能快速上手。脚本运行稳定，错误提示友好，能准确告诉你哪里出了问题。不过它只能查账户和改预算，想做广告投放或看详细报表就不行了，而且必须先配置另一个认证技能才能用，稍微麻烦了点。
