前言¶
投放同学在后台改预算、调时段、开关状态,往往要在腾讯广告营销投放平台里逐条点选。多账号、多营销单元一起改时,重复操作多,也容易漏改或改错字段。把「更新营销单元(原广告)或智投项目」封装成 Agent Skill,可以在 Cursor、Claude Code 等支持 Skills 的客户端里,用自然语言说明要改什么,由 Agent 按 Skill 约定调用官方能力,而不是每次自己翻文档拼请求。
下面介绍 SkillHub 上的 腾讯营销投放-更新广告(坐标 @tencent-adm/tencentads-delivery-standard-update,当前版本 0.5.8),以及安装方式与使用边界。
这是什么¶
腾讯营销投放-更新广告 是腾讯营销品牌发布的企业来源(enterprise)Skill,分类为 business-ops。它面向营销单元(原广告)与智投项目的通用更新:一次 Skill 覆盖名称、投放日期、定向、时段、出价、预算、状态、深度转化、一键起量、创意增强等字段的修改,并支持单个对象更新,以及多账号、多营销单元/多项目的批量更新。
Skill 标注 requires_api_key=true,使用前需要具备可用的 API 密钥并完成配置(具体字段以安装后的 SKILL.md 与腾讯营销投放开放能力文档为准)。
在 SkillHub 上,该 Skill 评分为 100000,下载 6573 次,安装 7 次(数据取自 SkillHub 页面,会随时间变化)。
核心功能¶
以下能力均来自官方简介,未在资料中出现的接口名或参数不写进正文。
- 营销单元(原广告)更新:修改名称、投放日期、定向、投放时段、出价、预算、启停状态,以及深度转化、一键起量、创意增强等相关配置。
- 智投项目更新:与营销单元侧类似的字段级更新,适用于智投项目维度的投放调整。
- 单对象更新:指定一个营销单元或一个智投项目进行修改。
- 批量更新:跨多个广告账号,对多个营销单元或多个智投项目执行同一类或组合字段的更新。
Skill 本身不替代投放策略判断;它解决的是「已知要改什么、改到哪」时的执行与批量效率问题。
安装与启用¶
安装流程以 SkillHub 官方说明为准:先确保本机有 skillhub CLI,再把 Skill 装进当前 Agent 的 skills 目录。
1. 检查 CLI
command -v skillhub && skillhub --version
若未安装,可按 SkillHub 文档执行完整安装(含 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
2. 安装本 Skill
安装时必须用 --dir 指向当前客户端的 skills 目录,否则默认落在 ./skills/ 且 Agent 可能无法加载。常见路径示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
以 Cursor 为例:
skillhub install @tencent-adm/tencentads-delivery-standard-update --dir ~/.cursor/skills/
SkillHub 页面也支持把下面这句发给 AI,由 Agent 按 SkillHub 安装文档 完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@tencent-adm/tencentads-delivery-standard-update`。
3. API 密钥
标签 requires_api_key=true 表示调用投放更新能力前需配置密钥。密钥获取方式、环境变量名或配置文件路径以 Skill 包内 SKILL.md 及腾讯营销投放开放平台要求为准;本文不列举未在公开页面出现的配置项名。
安装或更新 Skill 后,按所用客户端说明重启或刷新 Agent,使新 Skill 生效。
典型用法¶
公开页面未提供逐字段的 HTTP 示例;可复现的用法是:在已安装 Skill 且 API 密钥就绪的前提下,用自然语言向 Agent 描述更新意图,由 Agent 读取 Skill 说明并调用对应能力。
示例表述(仅说明交互方式,非官方固定话术):
-
单条改预算与状态
「在账号 XXX 下,把营销单元 ID 为 YYY 的日预算改为 5000 元,并设为投放中。」 -
改时段与出价
「智投项目 ZZZ 从今天起只在 9:00–22:00 投放,目标出价调整为 1.2。」 -
批量
「账号 A、B 下这几个营销单元 ID 列表,统一关闭一键起量,并把结束日期延到 2026-12-31。」
执行前建议在对话里让 Agent 汇总将要修改的账号、对象 ID、字段与目标值,确认后再提交;批量场景尤其要先核对 ID 列表,避免误改非目标单元或项目。
适用场景与注意¶
适合谁
- 日常在腾讯营销投放侧做运维式调整(预算、时段、状态、定向微调等)的投放或运营同学。
- 需要在多个账号、多个营销单元/项目上做相同规则变更、希望减少后台重复点击的团队。
- 已在用 Cursor、Claude Code 等 Skills 生态,希望把「更新投放对象」纳入对话工作流的技术同学。
限制与注意
- 依赖 API 密钥 与腾讯营销投放开放接口权限;账号无权限的字段无法通过 Skill 绕过。
- 版本以 SkillHub 为准(当前 0.5.8);升级可用
skillhub对同一坐标执行更新,并再次确认SKILL.md变更。 - 深度转化、创意增强等字段往往与广告形态、优化目标绑定,改之前应在平台侧确认对象是否支持该字段,避免接口报错。
- 批量更新前务必二次确认对象范围;Skill 提高的是执行效率,不能替代投放审核与合规检查。
结尾¶
腾讯营销投放-更新广告 把营销单元与智投项目的字段级更新、单条与批量场景收敛到一个 Skill 里,适合把「改投放配置」从纯后台操作迁到 Agent 对话中执行。安装与优先源策略见 SkillHub 安装文档;Skill 详情与下载见 SkillHub 页面,API 资源地址为 https://api.skillhub.cn/tencent-adm/tencentads-delivery-standard-update。