前言¶

在 Agent 里接腾讯营销（原腾讯广告）开放能力时，往往会装多个 tencent-ads 系列 Skill：报表、投放、账户查询等。每个 Skill 调用接口都要带 APIKEY；一旦密钥未配置、过期或填错，业务 Skill 会直接返回认证错误，Agent 也很难判断该让用户改哪一项配置。

单独在每个 Skill 里各存一份密钥，既重复又容易不一致。下面介绍 SkillHub 上的 腾讯营销投放-鉴权（@tencent-adm/tencentads-auth），它专门负责凭证校验与保存，供同账号下所有腾讯营销相关 Skill 共享。

这是什么¶

腾讯营销投放-鉴权 是腾讯营销品牌发布的 enterprise 来源 Skill，坐标 @tencent-adm/tencentads-auth，当前版本 0.5.6，分类为 ai-agent，标签含 requires_api_key=true。

定位可以概括为：腾讯营销技能的 鉴权凭证管理 入口。它负责检查 APIKEY 是否有效；当其他腾讯营销（tencent-ads）系列 Skill 因认证失败报错时，引导用户提供 APIKEY 并完成保存。官方说明强调：腾讯营销 APIKEY 必须通过该技能保存，保存后由所有 tencent-ads 技能共用，无需在每个业务 Skill 里重复配置。

核心功能¶

依据 SkillHub 与 API 摘要，已核实的能力包括：

1. 校验 APIKEY：在调用链路上确认当前密钥是否可用，减少「密钥无效却继续调接口」的无效重试。
2. 认证失败时的引导：当 tencent-ads 系列 Skill 返回认证相关错误时，由本 Skill 接手，提示用户补充或更新 APIKEY。
3. 统一存储与共享：凭证经本 Skill 写入后，同环境下的其他腾讯营销 Skill 共享同一套密钥，避免多 Skill 各配各的。

本 Skill 不替代具体投放、报表等业务接口；它是接入腾讯营销 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

安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。

skillhub install @tencent-adm/tencentads-auth --dir <skills 目录>

在 Cursor 中，常用 skills 路径为：

skillhub install @tencent-adm/tencentads-auth --dir ~/.cursor/skills/

也可将下列提示词发给支持 Skill 安装的 AI，让其按官方说明完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentads-auth`。

安装后若 Agent 未自动识别新 Skill，需按所用客户端说明重启或刷新技能目录。

典型用法¶

公开页面未给出独立 REST 示例；实际用法与 腾讯营销 Skill 套件 绑定，可按下面顺序理解：

1. 先装鉴权 Skill：在接入任意 tencent-ads 业务 Skill 之前或同时，安装 @tencent-adm/tencentads-auth。
2. 通过本 Skill 保存 APIKEY：在 Agent 对话中按引导提交腾讯营销开放平台的 APIKEY；不要只在某个报表或投放 Skill 里口头说明密钥而跳过鉴权 Skill。
3. 再调用业务 Skill：账户、报表、投放等 tencent-ads Skill 复用已保存凭证；若仍报认证错误，回到鉴权 Skill 检查密钥是否有效或需更新。

具体保存字段名、本地存储路径以 Skill 包内 SKILL.md 及运行时行为为准；本文仅复述官方摘要中的职责边界。

适用场景与注意¶

适合谁

• 已在 Cursor、Claude Code、Codex 等支持 SkillHub 的 Agent 环境中使用腾讯营销 API 的开发者或运营同学。
• 需要同时使用多个 tencent-ads 系列 Skill，并希望 一处配置、全局生效 的团队。

需要注意

• 密钥入口唯一：官方明确要求 APIKEY 必须通过本 Skill 保存；绕过它可能在部分 Skill 上反复遇到认证失败。
• 依赖 APIKEY：标签 requires_api_key=true 表示使用前必须准备腾讯营销开放平台颁发的有效密钥。
• 版本与来源：当前 SkillHub 展示版本为 0.5.6，来源为 enterprise，由腾讯营销品牌发布；升级可用 skillhub 对同一坐标更新，并继续指定正确的 --dir。
• 数据口径：SkillHub 页面展示的评分为 100000，下载约 7089 次（统计随平台更新变化，写作时以页面为准）。

结尾¶

腾讯营销投放-鉴权解决的是多 Skill 场景下 APIKEY 分散、认证错误难排查的问题：先校验、再引导保存、再供全系 Skill 共享。接入腾讯营销 Agent 能力时，建议把它当作固定依赖一并安装。

• SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencentads-auth
• API 摘要：https://api.skillhub.cn/tencent-adm/tencentads-auth