前言¶
投放团队在对接腾讯营销（原腾讯广告）时，常见操作是登录投放端或走开放平台接口：拉关联广告主列表、看日预算与资金余额、核对共享钱包。若希望在 Cursor、Claude Code 等支持 Skills 的客户端里用自然语言完成同类查询，并在授权范围内改日预算，需要把官方能力封装成 Agent 可调用的 Skill，而不是每次手写 HTTP 请求。
下面介绍 SkillHub 上的企业级 Skill「腾讯营销投放-广告主」（坐标 @tencent-adm/tencentads-advertiser），由腾讯营销品牌发布，当前版本 0.5.8，分类为 business-ops，并标注 requires_api_key=true。
这是什么¶
「腾讯营销投放-广告主」是面向腾讯营销广告主信息与账户管理的 Agent Skill。发布方为腾讯营销品牌，来源类型为 enterprise，在 SkillHub 上的简介为：腾讯营销（原腾讯广告）广告主信息查询与管理技能，支持查询关联广告主账号列表、查询/修改账户日预算、查询资金账户余额、查询共享钱包信息。
它解决的是「在对话式开发环境里完成广告主侧只读与有限写操作」的问题，能力边界以 Skill 说明与腾讯营销开放接口为准，不替代投放后台的全部功能。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装并配置 API 密钥后，由 Agent 按 Skill 指引调用后端接口：
- 关联广告主账号列表：查询当前授权下可操作的广告主账号。
- 账户日预算：查询账户日预算，并在允许范围内修改。
- 资金账户余额：查询资金账户可用余额等信息。
- 共享钱包：查询共享钱包相关信息。
Skill 基于通用 SKILL.md 格式分发；具体字段、权限与接口行为以腾讯营销开放平台及该 Skill 包内文档为准。
安装与启用¶
安装 SkillHub CLI（如尚未安装）¶
先确认本机是否已有 skillhub：
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
安装说明全文见：https://skillhub.cn/install/skillhub.md
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端加载。
skillhub install @tencent-adm/tencentads-advertiser --dir <skills目录>
常用客户端 skills 目录示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
SkillHub 技能页也提供面向 AI 的安装提示：请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/tencentads-advertiser。
API 密钥¶
该 Skill 在 SkillHub 上带有标签 requires_api_key=true，使用前需按 Skill 包内说明配置腾讯营销相关 API 密钥；未在公开页面核对到的具体环境变量名或配置文件路径，请在安装后阅读 Skill 目录中的 SKILL.md 及附带说明完成配置。
典型用法¶
公开资料未附带固定脚本示例时，用法以自然语言驱动 Agent、由 Skill 路由到对应接口为主。可与简介中的四类能力对齐，例如：
- 让 Agent「列出我关联的广告主账号」——对应查询关联广告主账号列表。
- 指定广告主 ID 后「查询该账户日预算」或「将日预算调整为某金额」——对应查询/修改账户日预算（修改需具备写权限）。
- 「查询某广告主资金账户余额」——对应资金账户余额查询。
- 「查询共享钱包信息」——对应共享钱包查询。
实际请求参数、返回结构与错误码以 Skill 实现及腾讯营销 API 文档为准；改预算类操作建议在 Agent 执行前确认账号与金额，避免误操作。
适用场景与注意¶
适合谁：在 business-ops 场景下做投放运维、财务对账、多账号巡检的开发者或运营，已具备腾讯营销 API 访问权限，并希望在 IDE Agent 内完成高频查询与受控的预算调整。
平台侧信息（SkillHub，截至资料抓取）：评分 100000，下载 7563，安装 9；官方技能页与 API 入口分别为 https://www.skillhub.cn/skills/tencent-adm/tencentads-advertiser 与 https://api.skillhub.cn/tencent-adm/tencentads-advertiser。
注意：
- 企业级 Skill，需有效 API Key 与接口授权；只读与写操作权限可能不同。
- 修改日预算属于写操作，应在测试账号或明确审批流程下使用。
- 客户端需重启或刷新 Skills 缓存后，新安装的 Skill 才会生效（以各客户端文档为准）。
结尾¶
「腾讯营销投放-广告主」把广告主列表、日预算、资金余额与共享钱包四类常见操作收敛到 Agent Skill，减少重复查文档和拼请求的工作。安装坐标为 @tencent-adm/tencentads-advertiser，可从 SkillHub 技能页或官方 API 地址获取详情：https://www.skillhub.cn/skills/tencent-adm/tencentads-advertiser
