前言¶
在 Cursor、Claude Code 等环境里做投放相关问答时，常见做法是让模型凭公开资料「猜」开户流程、审核口径或报表字段，既容易过时，也无法落到你自己的账户数据。腾讯广告侧已有「妙问」这类面向营销场景的 AI 助手；若能把同一套能力以 Skill 形式装进 Agent，就可以在对话里用自然语言查规则、拉报表、做诊断，而不必每次手动打开 e.qq.com 或妙问网页。
下面介绍 SkillHub 上的 腾讯营销妙问（坐标 @clawhub_yishuang07/tencent-ads-assistant），以及如何在本地安装与典型提问方式。
这是什么¶
腾讯营销妙问 是腾讯广告官方「妙问」AI 营销助手对应的 Agent Skill。发布方标注为「腾讯营销妙问」，来源为 enterprise，当前 SkillHub 版本为 1.0.7，分类为 business-ops。Skill 通过妙问开放能力（平台入口 miaowen.qq.com）对接后台服务，由妙问侧 Agent 理解自然语言并编排具体能力。
适用话题包括：广告投放、开户充值、审核规则、素材规范、数据报表、腾讯广告 / 微信广告、妙问、e.qq.com 等。不适用于 Google Ads、巨量引擎等其他广告平台的独立问题。
SkillHub 页面标注 requires_api_key=true，实际使用需按 Skill 内指引配置妙问 Token（脚本会在缺失或失效时通过退出码提示，详见 Skill 自带的 references/token_management.md）。
核心功能¶
以下能力与上游 Skill 文档一致，由 Chat 模式下的不同 agent_type 或默认问答路由区分；复杂任务可由 Agent 多轮组合调用。
- 普通知识库问答：开户流程、审核规则、素材规范、平台政策等，不传
agent_type。 - 广告数据查询（
DATA_QUERY）：账户信息、报表与消耗等，支持在agent_params.account_id_list中限定账户范围。 - 账户深度分析（
ACCOUNT_ANALYSE）：指定账户与时间段投放分析，并可配置对比时间段。 - 广告诊断（
DIAGNOSE）：针对不起量、掉量等问题，需账户 ID 与广告 ID。 - 创意灵感（
CREATIVE_INSPIRATION）：按行业、版位、素材类型、关键词等查看平台优秀创意参考。 - 素材审核（
AUDIT）：规则咨询、预审检测、状态查询、拒审分析、素材修复；本地图片可先经upload.js上传再带attachments预审。
除 Chat 模式外，Skill 还提供 API 模式（api_tool_call.js），适合参数明确、单次查数的场景，当前文档列出的结构化接口包括 daily_reports/get（天粒度报表）与 hourly_reports/get（小时粒度报表）。运行环境要求 Node.js ≥ 18。
安装与启用¶
通过 SkillHub 安装（推荐国内环境）¶
SkillHub 技能页给出的安装提示为：依据 SkillHub 安装说明 安装本技能。核心步骤如下。
- 确认是否已安装
skillhubCLI：
command -v skillhub && skillhub --version
未安装时可执行官方一键脚本（完整安装或仅 CLI，以安装页为准）。
- 将技能安装到当前 Agent 正在使用的 skills 目录（未指定
--dir时默认./skills/，Agent 可能无法加载）：
skillhub install @clawhub_yishuang07/tencent-ads-assistant --dir <你的 skills 目录>
常见路径示例（以安装页列举为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装或更新后，按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
通过 ClawHub / OpenClaw 安装¶
上游仓库页面提供的命令为：
openclaw skills install @yishuang07/tencent-ads-assistant
坐标在 SkillHub 侧为 @clawhub_yishuang07/tencent-ads-assistant，与 ClawHub 的 @yishuang07/tencent-ads-assistant 指向同一套技能内容，按你环境选用的包管理器择一即可。
Token 配置¶
不要预先在对话里反复检查 Token；直接调用 Skill 脚本即可。若退出码为 2（TOKEN_NOT_FOUND）或 3（TOKEN_EMPTY），读取 Skill 内 references/token_management.md，按指引让用户完成 Token 获取与保存后重试。不得在 Agent 输出中明文展示完整 Token。
典型用法¶
日常在 Agent 中启用本 Skill 后，用自然语言描述需求即可；Agent 应按 Skill 说明选择 Chat 或 API 模式。下面示例来自官方文档，便于对照脚本入参。
自然语言（由 Agent 路由）¶
在对话中可直接提问，例如：
- 「朋友圈素材有哪些尺寸规范？」
- 「帮我查最近 7 天各账户消耗」
- 「账户 123456789 最近一周投放效果，并和上一周对比」
- 「广告 987654 不起量，帮我诊断」
- 「电商行业微信朋友圈图片类 Top 创意有哪些参考？」
- 「这条拒审文案可能违反哪条规则，怎么改？」
Agent 应据意图选择普通问答或对应 agent_type，必要时追问账户 ID、时间范围等，缺省分析周期常见默认为最近 7 天并在结果中注明。
Chat 模式（脚本直调）¶
知识库问答：
node scripts/chat.js '{"query": "开户需要准备哪些资质？"}'
数据查询：
node scripts/chat.js '{"query": "查最近7天按账户汇总的消耗","agent_type":"DATA_QUERY","agent_params":{"account_id_list":[123456789]}}'
素材预审（先上传再带附件）：
node scripts/upload.js "/path/to/creative.png"
node scripts/chat.js '{"query":"帮我预审这张素材","agent_type":"AUDIT","attachments":[{"content_type":"IMAGE","url":"<upload.js 返回的 data.file_url>"}]}'
API 模式（固定报表查询）¶
天粒度示例：
node scripts/api_tool_call.js '{"method":"GET","path":"daily_reports/get","params":{"begin":"2026-04-02","end":"2026-04-08","group_by_type":"DATE","fields":["cost"],"page_size":7,"account_id_list":[2345678]}}'
小时粒度示例：
node scripts/api_tool_call.js '{"method":"GET","path":"hourly_reports/get","params":{"date":"2026-04-09","group_by_type":"HOUR","fields":["cost","hour"],"page_size":24,"account_id_list":[2345678]}}'
调用 API 模式前，应先加载 references/api/ 下对应文件的参数 schema。若 Chat 返回 JSON 中 code 为 140209，表示 Skill 版本过期，需按 message 指引升级后重试。
适用场景与注意¶
适合谁：在腾讯广告体系内投放的团队、代运营、以及需要在 IDE 里把「问规则 + 查自己账户数据 + 诊断 / 审核」串在一起的开发者或运营人员。
使用注意：
- 能力与数据范围以腾讯广告 / 妙问为准，勿用于其他广告平台的主流程。
- Chat 模式返回的 Markdown 在单轮场景下应原样呈现，避免改写指标或结论；多轮综合分析时可整合，但不得篡改数据。
- API 模式仅适合已文档化的简单查数；复杂分析仍应走 Chat 与多 Agent 组合（例如「数据查询 → 账户分析 → 知识库解读」）。
- SkillHub 统计（截至页面展示）：评分 100000，下载约 17535 次；安装与版本以 SkillHub 技能页为准。
结尾¶
若你的工作流已经围绕 Cursor 或同类 Agent 展开，腾讯营销妙问 把官方妙问的知识库、数据查询、分析、诊断、创意与审核能力收敛进一个 Skill，减少「网页 + 表格 + 再问一次模型」的割裂。安装与坐标以 SkillHub 为准：
