前言¶
在腾讯营销（原腾讯广告）里做投放运维或数据分析时，常见路径是登录投放平台、在多个广告账户之间切换，再逐层点开营销单元、创意和素材去看配置与报表。账户多、层级深时，重复点击和导出既慢，也不方便把「定向、出价、版位、转化」等字段一次性交给 coding Agent 做汇总或核对。
下面介绍 SkillHub 上的企业级 Skill「腾讯营销投放-广告管理」（坐标 @tencent-adm/tencentads-management）。它把官方营销 API 能力封装成 Agent 可调用的工具，用对话完成跨账户查询、配置查看和部分关键词管理，减少手工在后台翻页。
这是什么¶
「腾讯营销投放-广告管理」是面向腾讯营销投放体系的管理类 Skill，由 腾讯营销品牌 在 SkillHub 发布，来源标注为 enterprise，当前页面版本为 v0.5.8，分类为 business-ops。标签标明 requires_api_key=true，使用前需要配置腾讯营销侧 API 凭证（具体字段以 Skill 包内 SKILL.md 及官方开放平台文档为准）。
SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencentads-management
API 索引地址：https://api.skillhub.cn/tencent-adm/tencentads-management
一句话定位：在 Agent 对话中完成腾讯营销多层级对象（营销单元 / 创意 / 素材等）的数据与报表查询、完整配置查看，以及关键词与否定词的增删改查。
核心功能¶
以下能力与 SkillHub 简介一致，未在资料中出现的接口细节不展开。
-
跨账户查询与报表
支持跨广告账户查询营销单元（平台用语中对应原「广告」）、创意、素材等多层级数据，并获取报表指标。 -
营销单元与智能投放配置
可查看营销单元完整配置，包括定向、出价、转化、版位等；可查看智能投放项目详情。 -
创意与素材预览
可获取创意列表及组件详情；当上下文为单条创意时，Skill 会解析组件并拉取图片或视频的预览 URL，便于在对话里核对素材。 -
搜索关键词管理
支持关键词与否定词的增、删、改、查。
安装与启用¶
Skill 遵循通用 SKILL.md 格式，通过 SkillHub 安装到当前 Agent 的 skills 目录后才会被识别。
方式一：让 Agent 按官方安装文档执行¶
SkillHub 页面给出的安装提示词如下，可直接发给 Cursor、Claude Code 等支持 Skills 的客户端：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentads-management`。
Agent 会按 SkillHub 安装与优先源配置 检查或安装 skillhub CLI，并把 Skill 装到对应目录。
方式二：本机使用 skillhub CLI¶
若已安装 SkillHub CLI，安装时必须用 --dir 指向当前 Agent 的 skills 目录（装到默认 ./skills/ 可能不会被客户端加载）。常见路径示例：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式：
skillhub install @tencent-adm/tencentads-management --dir <你的 skills 目录>
CLI 未安装时，可按官方文档执行完整安装（含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
API Key¶
该 Skill 标记为需要 API Key。安装并启用后，应在 Skill 说明或环境变量中配置腾讯营销开放平台颁发的访问凭证；未配置时，与账户、报表相关的工具调用通常会失败。凭证权限需覆盖你打算查询或修改的账户与接口范围。
典型用法¶
官方页面主要提供安装指引，未附带独立脚本示例。安装完成并配置 API Key 后，用法是在对话中用自然语言描述账户范围与目标对象，由 Agent 选择 Skill 内工具。可与简介对齐的提问方向包括：
- 「列出某账户下营销单元及昨日核心报表指标。」
- 「查看指定营销单元的定向、出价、转化与版位配置。」
- 「拉取某创意的组件详情，并给出图片/视频预览链接。」
- 「为某计划新增否定词 / 查询现有关键词列表。」
具体参数名、账户 ID 格式以 Skill 内文档与腾讯营销 API 为准；不要在对话中粘贴未脱敏的生产密钥。
适用场景与注意¶
适合谁
- 需要在多个广告账户间做配置核对、报表拉取或创意素材检查的投放、增长或运营同学。
- 希望把「查配置 + 简单关键词维护」交给 Agent，而不是每次登录后台手工导出的人。
限制与注意
- 依赖 requires_api_key 与接口权限，沙箱或无网环境需自行处理 CLI 安装与 API 连通性。
- 跨账户、报表与写操作（关键词增删改）均受平台配额与账户授权约束；批量变更前建议在测试账户验证。
- SkillHub 统计（页面抓取时）：评分 100000，下载 8947，安装 12；数据随 SkillHub 更新变化，以页面为准。
结尾¶
「腾讯营销投放-广告管理」把腾讯营销多层级投放对象和报表能力收敛到一个 Agent Skill 里，适合用对话完成跨账户查询、配置查看、创意预览链接获取和关键词管理。安装与坐标以 SkillHub 为准：
- https://www.skillhub.cn/skills/tencent-adm/tencentads-management
- https://api.skillhub.cn/tencent-adm/tencentads-management
