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

> 前置依赖：运行脚本前需安装 CLI — npm install tencentads-cli@1.0.0（需要 Node.js ≥ 20）

> - 脚本调用: 所有 API 操作通过本 Skill 目录下的脚本执行，格式为 node scripts/<脚本名>.mjs ''。

> - 认证依赖: 本技能依赖 tencentads-auth 技能配置的 API Key 凭据，如遇认证错误请先完成鉴权。

> 脚本调用格式统一：node scripts/<脚本名>.mjs ''

> 执行脚本时先进入本 skill 根目录，再按相对 scripts/ 路径调用。

⚠️ 跨平台 JSON 参数传递规则（经实测验证）

脚本调用格式为 node scripts/<脚本名>.mjs ''，但 JSON 参数的引号包裹方式因操作系统/终端而异，传递不当会导致 JSON.parse 报错（如 Expected property name or '}' in JSON at position 1）。

> ⛔ PowerShell 5.x 是重灾区：单引号 '...'、反引号 ` " ` 、反斜杠 \" 三种常见写法全部失败（双引号会被吞掉）。必须使用 --% 停止解析符或 \" `` 组合转义。

> ⛔ Windows CMD 不支持单引号包裹字符串，单引号会被当作普通字符传入脚本，导致 JSON 解析失败。

脚本列表

查询广告主账号列表

调用 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：用户需要查找某个公司的竞价广告主账号

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 范围），脚本会返回明确的错误提示
• 如果查询结果为空，告知用户未找到匹配的账号，建议调整搜索关键词或检查是否有关联账号

接口文档索引

相关技能

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