shield_lock
JinDaGe
Contact
← Back to skills
extension
Category: OtherAPI key required

腾讯广告投放-广告主

腾讯营销（原腾讯广告）广告主信息查询与管理技能。支持查询关联广告主账号列表（按公司名模糊匹配/分页）、查询账户日预算、修改账户日预算。当用户需要查找广告主账号、查询/修改日预算时使用本技能。

personAuthor: user_d3ee81f4hubcommunity
downloadDownload package

腾讯广告 - 客户账号查询技能

前置依赖：运行脚本前需安装 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 |

查询广告主账号列表

调用 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

接口文档索引

| 接口 | 文档 | 说明 | |------|------|------| | user_account_list/get | user-account-list-get.md | 查询竞价广告主账号列表 |

适用场景

场景 A：用户需要查找某个公司的竞价广告主账号

  1. 从用户描述中提取公司名称关键词
  2. 调用 get-account-list.mjs，传入 corporation_name_fuzzy_list
  3. 将匹配到的账号列表展示给用户

场景 B：用户需要浏览所有关联的竞价广告主账号

  1. 调用 get-account-list.mjs（不传参数或仅传分页参数）
  2. 展示第一页结果和分页信息
  3. 如果有多页，告知用户总数并询问是否需要查看更多

注意事项

  1. 仅支持竞价广告主：get-account-list.mjs 仅返回竞价广告主账户，不包含其他类型
  2. 无需传入 account_id：本接口基于当前登录用户的 user_id 查询，不需要指定广告主账号
  3. 分页默认值：不传 page 默认为 1，不传 page_size 默认为 10
  4. 模糊匹配限制：corporation_name_fuzzy_list 最多传 2 个字符串，每个字符串长度限制 2~50 个字符
  5. 认证依赖：本技能依赖 tencentads-auth 技能配置的 API Key 凭据，如遇认证错误请先完成鉴权
  6. 分页上限限制：get-account-list.mjs 严格要求 page * page_size <= 13000，超出此限制接口将报错

错误处理

  • 如果返回认证错误，引导用户使用 tencentads-auth 技能重新配置 API Key
  • 如果 corporation_name_fuzzy_list 参数不合法（超过 2 个、字符串长度不在 2~50 范围），脚本会返回明确的错误提示
  • 如果查询结果为空，告知用户未找到匹配的账号，建议调整搜索关键词或检查是否有关联账号

接口文档索引

| 功能 | 文档 | 说明 | |------|------|------| | 账户日预算查询与修改 | advertiser-daily-budget.md | 查询当前日预算、修改日预算，含 Agent 使用流程和 use_min_daily_budget 决策规则 |

相关技能

  • tencentads-auth - 配置 API Key 鉴权凭据