一MCP 与 Skill 的区别
1. 什么是 MCP
MCP(Model Context Protocol)是一套让 AI 应用连接外部数据和工具的开放协议。通过 MCP,AI Agent 可以发现并调用 AppGrowing Global 提供的工具和能力。
使用 MCP 后,用户可以直接在日常使用的 AI Agent 中,用自然语言调用 MCP 来搜索和获取丰富的全球移动广告素材,不需要手动登录 AppGrowing Global。
2. 什么是 Skill
Skill 通常是一组给 AI Agent 使用工具的说明、规则和调用流程。以 AggClaw Skill 为例,它会告诉 Agent:
- 什么情况下应该调用 AppGrowing Global
- 如何识别用户的分析意图
- 新分析和连续追问分别如何处理
- 如何选择分析模式、语言和参数
- API Key 如何配置
- 超时、认证失败和素材下载失败时如何处理
3. MCP 与 Skill 的关系
MCP = 厨具和食材,提供各种基础能力。
Skill = 菜谱,告诉你用什么食材、按照什么顺序做。
例如:
MCP:鸡蛋、面粉、牛奶、烤箱 · Skill:蛋糕制作方法
换成 AppGrowing:
MCP:素材数据、投放数据、竞品数据、市场数据 · Skill:爆款素材分析方法
一句话:
MCP 提供"原料",Skill 提供"做一盘好菜的菜谱"。
MCP 告诉 AI"有什么",Skill 告诉 AI"怎么做"。
AGG MCP 告诉 AI "有什么数据",Skill 告诉 AI "怎么调用数据和利用数据有效洞察"。
- MCP 负责把 AGG 的能力接入 AI 客户端。
- Skill 负责帮助 Agent 理解用户需求,并选择合适的 Tool。
- MCP Tool 执行搜索、筛选、分析或素材获取。
- AI 客户端将结果整理成用户可读的报告,并支持继续追问。
例如,用户说"分析近 30 天美国市场 SLG 游戏的素材趋势":
- MCP 负责让 AI 客户端能够调用 AGG 的素材分析工具。
- Skill 负责识别"美国市场、SLG、近 30 天、趋势分析"等条件传给 MCP 调用哪些数据,并负责教 AI 如何利用数据进行分析。
- MCP Tool 负责搜索数据并生成分析结果。
- AI Agent 负责展示报告,并保存会话上下文供后续追问使用。
二AGG MCP 基本情况
2.1 AGG MCP 现在有哪些 tool?
AGG MCP 现已开放 21 个 tool,按用途分为四个模块:素材创意与卖点(5 个)、榜单与产品情报(4 个)、品牌投放分析(10 个)、厂商与发行商情报(2 个)。
| Tool | 作用 | 一句话场景 |
|---|---|---|
| 模块一 · 素材创意与卖点(5 个)—— AGG MCP 的差异化核心 | ||
| materialList | 素材搜索(按媒体/地区/卖点/受众/变现方式等筛选) | 近 30 天角色扮演类在 TikTok 的素材 |
| creativeMarketingWordList | 💡 创意卖点词趋势(33 万+ 词库,可按素材数/广告数/热度排序) | 角色扮演品类大家都在打什么卖点 |
| resourceMarketingWord | 单个素材的创意卖点 | 提取近 7 天某产品热门素材的创意卖点 |
| filterList | 返回全部可选筛选值(媒体/地区/类别/风格/卖点分类) | TikTok 的媒体 ID 是多少 |
| downloadResourceUrl | 刷新素材原片/封面下载链接,链接有时效期 | 拿到素材原图/原视频 |
| 模块二 · 榜单与产品情报(4 个)—— 先定位「该看谁」 | ||
| promoteAppList | App 投放排行榜(品牌维度,含在投广告数、素材数、受众画像与发行商/开发者信息) | 近 7 天美国市场买量最猛的游戏有哪些 |
| appStoreDownloadList | iOS App Store 下载榜 | 日本益智类下载榜近期跑出了哪些新游 |
| gpAppDownloadList | Google Play 下载榜 | Android 端美国市场工具类的下载头部是谁 |
| appRelatedAndSimilarList | 相似 / 相关产品推荐(可按相似度、累计下载量排序) | 给这款 SLG 找出 10 个可直接对标的竞品 |
| 模块三 · 品牌投放分析(10 个)—— 拆「谁在投、投多少、投在哪」 | ||
| mediaLaunch | 媒体投放概览:各媒体的投放量级与占比 | 这款产品主要把量压在 Meta 还是 TikTok |
| regionLaunch | 地区投放概览:各国家地区的投放量级与占比 | 它的预算主要花在哪些市场 |
| mediaTimeline | 媒体投放时间线:各媒体随时间的量级变化 | 它是什么时候开始加投 TikTok 的 |
| regionTimeline | 地区投放时间线:各地区随时间的量级变化 | 首月与稳定期的市场重心怎么迁移 |
| formatOverview | 广告形式概览:试玩 / 激励视频 / 信息流等形式分布 | 竞品是不是已经在批量跑试玩广告 |
| creativeTypeOverview | 素材类型概览:图片 / 视频 / 竖版视频等类型分布 | 这个品类的主战场是图文还是视频 |
| materialRatio | 素材比例概览:横竖版与尺寸比例分布 | 做几套尺寸才够覆盖主流版位 |
| advertTrend | 广告数 / 素材数的投放量级趋势曲线 | 对方每周上新多少条素材、节奏如何 |
| appAgeRangeCnt | 品牌受众的年龄 × 性别分布 | 素材该往哪个年龄段、哪种性别倾斜 |
| appCycleTime | 产品生命周期 / 版本节点 / 节日节点时间 | 大版本节点前后它的买量节奏怎么变 |
| 模块四 · 厂商与发行商情报(2 个)—— 上钻到公司维度 | ||
| appBrandStatusList | 发行商旗下产品总览(在投广告数、素材数、在投时长、版本数、覆盖地区数) | 这家发行商有多少产品在投、各投得多猛 |
| developerAppBrand | 开发者旗下产品列表 | 同一个开发者还矩阵了哪些马甲包 |
2.2 🔥 AGG MCP 最独特的能力 —— 创意卖点体系
| 层级 | 工具 | 能力 | 示例 |
|---|---|---|---|
| ① 画面元素 | materialList.resourceElement | 内联返回画面元素标签(带描述) | 写实风格、3D、动漫人物、科幻风格、真人 |
| ② 卖点筛选 | materialList.marketingWord | 按 🔥33 万+ 创意卖点词筛选素材 | 高饱和特效色、轻松解压、俯视镜头、成就感、零碎时间 |
| ③ 卖点趋势 | creativeMarketingWordList | 卖点词趋势榜(按素材数/广告数/热度排序) | 发现某品类近期最热卖点词 Top N |
截至目前,AGG MCP 中的 creativeMarketingWordList 返回的卖点词库高达 337,278 个。
覆盖视觉风格(高饱和特效色/暖色调主调)、镜头语言(中景特写/视角俯拍)、受众动机(休闲玩家/成就成就感/轻松解压)、场景布局(美观生活场景/垂直列表布局)等,颗粒度极细。
在画面元素 material.resourceElement[].description 中,是真正有信息量的描述,对每个画面元素标签的判定口径说明,告诉你这个标签为什么会这么打。如:
| 标签名 | description(判定口径) |
|---|---|
| 动漫人物 | 以日式动漫或国产动漫为主的人物类型,不包含拟人动物(例如孙悟空猪八戒)。 |
| 3D | 人物、物体无黑线/细线描边,光影效果明显,物体重叠部分无描边算 3D。混合类型不算。 |
| 动漫风格 | 来源上包括日韩风(东方)和欧美风(西方)动漫,画面分为 Q 版萌系可爱风和日本/欧美漫画动画为代表的动漫形象。 |
| 写实风格 | 3D 建模风格,画面逼真(包含极其仿真的人和物)强大的光影效果,常见于真三国无双、NBA2K、FIFA 等游戏。 |
| 欧美风格 | 欧洲/北美/南美等历史&现代独有要素,常见于中世纪铠甲、城堡、西部牛仔、美国大叔等。 |
| 真实场景 | 素材中出现了真实世界的场景画面,例如办公室、海边、汽车内等。 |
| 真人 | 真实的自然人或高度逼真的 CG 人物。 |
| 极简风格 | 画面简洁,一般不超过三个元素,元素立意扁平化,常见于火柴人游戏。 |
| 像素风格 | 用像素风格处理图像,强调清晰轮廓、明快色彩,颗粒像素组成独特画面风格。 |
| 动物 | 牛马羊等家禽、动物。 |
2.3 AGG MCP Tool 明细
以下 21 个 tool 按四个模块列出。每个 tool 的参数表默认只展示前 5 个参数,点击表下方的「展开其余参数」即可查看全部;导出 PDF 时会自动展开全部参数。
2.3.1 materialList — 素材检索能力(核心 Tool)
| 参数 | 必填(✅为必填,—为可选) | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 / 3-网站 |
order | ✅ | 排序(具体见下表) |
startDate / endDate | — | 投放时间范围(YYYY-MM-DD) |
isAllDate | — | 是否查所有时间(1-是 / 0-否) |
category | — | 商店类别(ID 取自 filterList) |
resourceElement | — | 素材标签/画面元素(仅游戏/应用) |
appStyle | — | 应用风格(仅游戏/应用) |
media | — | 媒体(ID 取自 filterList) |
area | — | 投放地区(国家代码数组) |
format | — | 广告形式(ID 取自 filterList) |
platform | — | 推广平台(仅游戏/应用) |
language | — | 投放素材的语言 |
videoTime | — | 视频时长(ID 取自 filterList) |
minDuration / maxDuration | — | 投放天数范围 |
accurateSearch | — | 精准匹配(1/0) |
isNew / isNewAd | — | 新素材 / 新广告(1/0) |
resolution | — | 高清素材(1/0) |
keyword | — | 搜索关键词 |
isCreative | — | 创新素材(1/0,仅游戏/应用) |
gender | — | 性别(1-男 / 2-女 / 3-未知,仅游戏/应用) |
ageRange | — | 年龄:13-17 / 18-24 / 25-34 / 35-44 / 45-54 / 55-64 / 65+ |
isW2a / excludeW2a | — | W2A 网站推广判定 |
campaignTypeCombine | — | 是否进行推广类型筛选(1/不传) |
campaignType | — | 推广类型:App下载(101,201,298,295) / W2Apk(299) / PWA&H5(297) |
platformCampaignType | — | 推广平台:GooglePlay(201) / Galaxy(295) / RuStore(298) / APK(299) / AppStore(101) |
appCashWay | — | 变现方式:iaa / iap / iaa_iap / subscribable |
materialRatio | — | 素材比例(如横竖屏) |
blockIds | — | 屏蔽素材 id |
blockAppIds | — | 屏蔽推广物 |
isPre | — | 预约/预注册游戏(1/0,仅游戏) |
asr | — | 是否有旁白(1/0) |
asrLanguage | — | 旁白语言 |
searchDsl | — | 高级搜索:{key, type, value},见下 |
isViolation | — | 违规广告(1/0,仅游戏/应用) |
hasCooperate | — | 合作达人广告(1/0) |
marketingWord | — | 创意卖点词(仅游戏/应用) |
singleArea | — | 仅看某地区(1/0) |
postpage | — | 是否广告原帖(1/0) |
hasPpid | — | 是否有 CPP 自定产品页面(仅游戏/应用) |
order 排序参数
| order 排序参数 | 排序含义 | 适用场景 |
|---|---|---|
_score_desc | 按搜索相关性降序(仅当传了 keyword/searchDsl 时有效) | 关键词搜索时按匹配度排 |
max_dt_desc | 按最后投放时间降序(最新的素材在前) | 看最近仍在投的素材 |
max_dt | 按最后投放时间升序(最老的在前) | — |
min_dt_desc | 按首次发现时间降序(最近新抓到的素材在前) | 看最新入库/新出现的素材 |
min_dt | 按首次发现时间升序(最早抓到的在前) | — |
cnt_ad_id_desc | 按关联广告数降序(投得最广的素材在前) | 找投放规模大的素材 |
cnt_dt_desc | 按投放天数降序(投得最久的素材在前) | 找"常青"素材/长跑型 |
cnt_dt | 按投放天数升序 | — |
impression_inc_2y_desc | 按曝光数降序 | 找头部爆量素材(例如找 Top10/Top5) |
similar_cnt_desc | 按近似素材数降序 | 找"爆款母版"素材(近似素材数越多说明越值得抄) |
searchDsl 对象字段
key(enum):campaign_name(游戏名/应用名/域名)/appid/slogan(文案)/asr(旁白)/brands_name(短剧)/developer_name/websitetype(enum):contain/exclude/equal/notEqualvalue(str):检索内容
2.3.2 creativeMarketingWordList — 创意卖点能力(核心 Tool)
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 1-游戏 / 2-应用 |
category | — | 商店类别 |
appStyle | — | 应用风格 |
area | — | 投放地区 |
wordAttr | — | 卖点分类 |
keyword | — | 关键词 |
order | — | adverts_desc / material_cnt_desc / shot_cnt_desc / product_cnt_desc / ratio_desc |
page | — | 页码 |
2.3.3 resourceMarketingWord — 单个素材的创意卖点
| 参数 | 必填 | 说明 |
|---|---|---|
id | ✅ | 素材资源 ID(materialList 中 creative.resource.id) |
purpose | ✅ | 推广物类型(须与 materialList 调用时一致) |
2.3.4 filterList(无入参,仅用于返回常量筛选值)
| 参数 | 必填 | 说明 |
|---|---|---|
| (无) | — | 无入参,返回全部常量筛选值 |
2.3.5 downloadResourceUrl — 返回可供下载的素材链接
| 参数 | 必填 | 说明 |
|---|---|---|
key | ✅(实际必填) | key = materialList 返回的 creative.resource.path,或截取该链接的文件名+后缀 |
2.3.6 promoteAppList — App 投放排行榜(品牌取数总入口)
返回 AppBrand 维度的排行榜,一条记录即可同时拿到品牌 ID、关联的单应用 ID、发行商 ID、开发者 ID 与受众画像,是模块三、模块四所有 tool 的 ID 来源。每页固定返回 20 条。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 |
order | ✅ | adverts_desc 广告数 / duration_desc 投放天数 / material_cnt_desc 素材数 / _score_desc 搜索相关性 |
page | ✅ | 页码(每页 20 条) |
startDate | ✅ | 开始日期(YYYY-MM-DD) |
endDate | ✅ | 结束日期(YYYY-MM-DD) |
area | — | 投放地区(国家代码数组) |
media | — | 媒体(ID 取自 filterList) |
category | — | 商店类别(ID 取自 filterList) |
appStyle | — | 应用风格(ID 取自 filterList) |
developerArea | — | 开发者来源地区(国家代码) |
isNew | — | 新投放游戏 / 应用(1/0),order=adverts_desc + isNew=1 即新品榜 |
isPre | — | 做过预约 / 预注册的游戏(1/0,仅游戏) |
keyword | — | 搜索关键词(仅匹配应用名 / 品牌名) |
accurateSearch | — | 精准匹配(1/0) |
appCashWay | — | 变现方式:iaa / iap / iaa_iap / subscribable |
ageRange | — | 受众年龄段(仅游戏 / 应用) |
gender | — | 受众性别:1-男 / 2-女 / 3-未知(仅游戏 / 应用) |
2.3.7 appStoreDownloadList — App Store 下载榜
返回单平台 App 维度列表(不是品牌合并口径),结束日期最晚只能到昨天,不可查询今日数据。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 |
order | ✅ | download_cnt 下载量 / ad_cnt 广告数 / material_cnt 素材数 / change_rate 变化率 |
page | ✅ | 页码 |
startDate | — | 开始日期,默认近 7 天起始(今天-7 天) |
endDate | — | 结束日期,默认昨天(今天-1 天) |
timeType | — | daterange(仅支持近 7/15/30 天)/ month(不支持查当月) |
area | — | 投放地区(国家代码) |
category | — | 商店类别(ID 取自 filterList) |
appStyle | — | 应用风格(ID 取自 filterList) |
developerArea | — | 开发者来源地区(国家代码) |
preAdditional | — | 预约增发(1/0) |
keyword / accurateSearch | — | 关键词与是否精准匹配 |
2.3.8 gpAppDownloadList — Google Play 下载榜
参数与 appStoreDownloadList 完全一致,仅数据源换成 Google Play;同样最晚只能查到昨天。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 |
order | ✅ | download_cnt / ad_cnt / material_cnt / change_rate |
page | ✅ | 页码 |
startDate / endDate | — | 默认近 7 天,结束日期最晚为昨天 |
timeType | — | daterange / month |
area | — | 投放地区(国家代码) |
category / appStyle | — | 商店类别、应用风格(ID 取自 filterList) |
developerArea | — | 开发者来源地区 |
preAdditional | — | 预约增发(1/0) |
keyword / accurateSearch | — | 关键词与是否精准匹配 |
2.3.9 appRelatedAndSimilarList — 相似 / 相关产品
给定一款产品或一个品牌,反查其相似竞品与相关产品池。appId 与 appBrandId 不能同时为空;传 appId 走单包口径,否则走品牌口径。
| 参数 | 必填 | 说明 |
|---|---|---|
appBrandId | — | 品牌 ID(与 appId 二选一) |
appId | — | 产品 ID,传了即查单包相似品 |
type | — | 推广物类型,有 appId 时必传 |
key | — | 取哪几类结果:site 同站点 / global 全球包 / similar 相似品;不传返回全部 |
sort | — | similar_desc 相似度 / new_desc 新品在前 / old_desc / gp_download_desc / ios_download_desc |
appCategory | — | 品类筛选:0-全部 / 1-相同 / 2-不同 |
limit | — | 请求 similar 时的数量上限 |
has_advert | — | 全球包与双端是否一并请求广告数据 |
2.3.10 mediaLaunch — 媒体投放概览
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 |
brandId | ✅(口径必填) | 应用品牌 ID |
ids | — | 品牌口径:关联的所有单应用 ID 列表 |
id | — | 单应用口径:填应用 ID;品牌口径填品牌 ID |
type | — | 单应用口径填该应用的 type,品牌口径不传 |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
dimension | — | adverts 按广告去重 / material 按素材去重 |
area / media / format / creativeType | — | 地区与媒体、广告形式、素材类型筛选(ID 取自 filterList) |
2.3.11 regionLaunch — 地区投放概览
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型:1-游戏 / 2-应用 |
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type,品牌口径不传 |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选(ID 取自 filterList) |
dimension | — | adverts / material |
2.3.12 regionTimeline — 地区投放时间线
参数与 regionLaunch 相同,输出改为按时间展开的分地区量级变化。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型 |
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选 |
dimension | — | adverts / material |
2.3.13 mediaTimeline — 媒体投放时间线
参数与 mediaLaunch 同族,但不接受 id / ids,靠 brandId(+ type)区分品牌与单应用口径。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型 |
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type,品牌口径不传 |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选 |
dimension | — | adverts / material |
2.3.14 formatOverview — 广告形式概览
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型 |
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选;形式 ID 取自 filterList 的 format 分组 |
dimension | — | adverts / material |
2.3.15 creativeTypeOverview — 素材类型概览
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型 |
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选;类型 ID 取自 filterList 的 creativeType 分组 |
dimension | — | adverts / material |
2.3.16 materialRatio — 素材比例概览
输出各素材比例的广告数、素材数与占比,用于判断横竖版覆盖策略。
| 参数 | 必填 | 说明 |
|---|---|---|
brandId | ✅(口径必填) | 应用品牌 ID |
type | — | 单应用口径填应用 type |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
area / media / format / creativeType | — | 通用筛选(ID 取自 filterList) |
dimension | — | adverts / material |
2.3.17 advertTrend — 广告 / 素材投放量级趋势
返回按日聚合的量级曲线(广告投放量级趋势图 / 素材投放量级趋势图)。brandId 与 id 不能同时为空。
| 参数 | 必填 | 说明 |
|---|---|---|
purpose | ✅ | 推广物类型 |
brandId | ✅(口径必填) | 应用品牌 ID |
id | — | 品牌口径填品牌 ID;单应用口径填应用 ID |
ids | — | 品牌口径:关联的所有单应用 ID 列表 |
type | — | 单应用口径填该应用的 type |
startDate / endDate | — | 默认近 30 天 |
isAllDate | — | 是否查所有时间(1/0) |
dimension | — | adverts 出广告数曲线 / material 出素材数曲线 |
area / media / format / creativeType | — | 通用筛选 |
2.3.18 appAgeRangeCnt — 品牌受众年龄 × 性别分布
仅支持应用品牌口径,不支持单应用。日期为必填参数,不可省略。
| 参数 | 必填 | 说明 |
|---|---|---|
startDate | ✅ | 开始日期,默认近 30 天 |
endDate | ✅ | 结束日期,默认今天 |
appBrandId | ✅(口径必填) | 应用品牌 ID,须照 promoteAppList 返回值传入 |
2.3.19 appCycleTime — 产品生命周期节点
| 参数 | 必填 | 说明 |
|---|---|---|
propId | ✅(口径必填) | 应用品牌 ID |
appCycleType | — | product_lifecycle 产品生命周期 / app_version 版本节点 / festivals 节日节点 |
2.3.20 appBrandStatusList — 发行商旗下产品总览
一次拿到某发行商全部产品的在投广告数、素材数、在投时长、版本数与覆盖地区数,适合厂商盘点。id 取 promoteAppList 返回的发行商 ID。
| 参数 | 必填 | 说明 |
|---|---|---|
id | ✅ | 发行商 ID(品牌记录里的 publisher.id) |
order | — | adverts_desc 广告数降序 / material_cnt_desc 素材数降序 |
page | — | 页码 |
2.3.21 developerAppBrand — 开发者旗下产品
id 取 promoteAppList / 下载榜返回的开发者 ID,用于排查同一开发者旗下的产品矩阵。
| 参数 | 必填 | 说明 |
|---|---|---|
id | ✅ | 开发者 ID(品牌记录里的 developer.id) |
page | ✅ | 页码 |
order | ✅ | adverts_desc 广告数降序(当前仅此一种) |
三AGG MCP 的配置和调用
3.1 AGG MCP 怎么配置
复制下面的命令,直接在 Agent 对话框输入让 Agent 执行。命令内的 API Key 替换为您自己的 API Key,可在"个人中心 → 企业信息"找到 API Key。accept-language 可替换语言,zh 为中文,en 为英文。
安装这个 MCP: { "mcpServers": { "AppGrowing-Global-MCP": { "url": "https://api-appgrowing-global.youcloud.com/mcp", "headers": { "Authorization": "Bearer API Key", "accept-language": "zh" } } } }
等待安装完毕,并尝试对话进行调用,若返回结果则说明配置成功。
- 输入命令发送给 Workbuddy
- Workbuddy 自定义连接器点击信任
- 测试 MCP 连接是否正常,若返回正常结果,则说明 MCP 服务连接成功
3.2 通过自然语言调用
正常接入后,用户不需要提供参数,直接用自然语言描述目标、范围和分析重点即可,可以参考下列几个典型调用示例。
调用链:
调用链:
调用链:
四AGG MCP 基础使用案例
需求:在某品类里发现正在起量的素材方向,并锁定该打什么卖点。
需求:锁定某一个竞品 App,拆解它近期的素材打法与投放强度。
需求:为目标市场批量采集可参考的原片,给本地化团队翻拍。
需求:扫描某品类当前主流卖点主题及各自素材热度,指导创意选题。
需求:对比同一品类在不同渠道/形式上的创意风格差异。
需求:进入新市场前,先拉该市场同品类的标杆素材作冷启动参考。
其余基础使用案例
| 案例 | 常见问题 | Tool 支持 |
|---|---|---|
| 变现模式对标 | IAA vs IAP 游戏素材差异? | materialList(支持 IAA/IAP 变现方式筛选) |
| 受众定位研判 | 面向 25-34 女性的素材? | materialList(支持性别和年龄范围筛选) |
| 网站/W2A 推广分析 | Web 推广素材怎么打? | materialList(支持搜索推广网站的素材) |
五AGG MCP 进阶使用场景
AGG MCP 用得好不好,能不能实际嵌入到你的工作流中,主要由 3 个因素有关:
- Agent 能力
- AI 大模型聪明程度
- Prompt 和 Skill 写的好不好
而大部分人都是在 Prompt 和 Skill 没过关,一个好的 Prompt 和 Skill 决定任务的质量。正如我们前面讲到的,要做出一盘好菜(深度广告洞察),除了要有原材料和工具(MCP),更关键要有教你做出好菜的菜谱(Skill)。
除了推荐大家使用 📘 AggClaw Skill,我们也欢迎大家将 MCP 融入自己特定的业务场景和工作流上,写出专属的 Skill,让 Agent 更好地调用 MCP 并能将通过 MCP 得到的数据转换成独特的数据洞察,并内化成自动化提效流程。
业务目标:每周自动产出某款产品的素材策略简报:盘点在投素材、识别起量卖点、给出下周素材方向建议。适合配定时任务(如每周一 9:00)自动执行。
工具链:filterList → creativeMarketingWordList → materialList(按 campaign_name 高级搜索 + 卖点筛选)📄 参考 SKILL(agg-single-product-report)— 点击折叠
---
name: agg-single-product-report
description: 本技能适用于:当需要基于 AGG-MCP(materialList、creativeMarketingWordList、filterList、downloadResourceUrl)获取的**单个产品/App** 的海外移动广告创意数据,产出「单产品创意策略诊断报告」时。它聚焦某一个指定产品(自家 App 或单个竞品),诊断其创意引擎活跃度、卖点聚焦度、TOP 素材、创意生命周期与衰退信号,并给出「放大 / 迭代 / 淘汰」的创意资产处置建议。触发场景:单产品创意复盘会、自家产品创意健康度诊断、单个竞品深度拆解;或用户提问「帮我系统诊断一下我们 XX 游戏近一个月的素材打法,哪些素材该加投、哪些该换、哪些该砍」「深度拆一下竞品 YY 在日本的创意策略」。
agent_created: true
---
# AGG 单产品创意策略报告
## 概述
AGG-MCP × Skill × Automation 体系下的**单场景**分析技能。它把某一个指定产品的归一化创意数据集,转化为一份结构化的**单产品创意策略诊断报告**(新场景「F · 单产品创意策略报告」)。与 `agg-category-report`(品类级、跨产品)不同,本技能只盯**一个产品**,做创意资产的深度体检。本技能与 MCP 取数层解耦:它消费由 MCP/编排层事先拉取并归一化的 `CreativeRecord[]`(建议用 `searchDsl.campaign_name` 锁定单产品),自身不调用任何工具。
## 何时调用
- 单产品创意复盘 / 自家产品创意健康度诊断(手动或 Automation)。
- 对某一个竞品做深度拆解(而非跨竞品并排对比,后者用 `agg-competitor-compare`)。
- 用户提问如「系统诊断一下我们 XX 游戏近一个月的素材打法,哪些该加投、哪些该换、哪些该砍」「深度拆一下竞品 YY 在日本的创意策略」。
**不要**用它来取数。若还没有 `CreativeRecord` 数据集,先跑 AGG-MCP(filterList + creativeMarketingWordList 锁定维度 → 用 `searchDsl.campaign_name` 锁定单产品拉取 materialList,最好覆盖多时间切片),再回到本技能。
## 核心工作流
1. **加载契约**:读取 `references/data_contract.md`,确认必填字段(`app_name`、`selling_points`、`format`、`ratio`、`language`、`impression`、`similar_cnt`、`advertising_days`、`max_dt`;该产品窗口内 ≥20 条)。
2. **发出分析提示词**:复制 `references/analysis_prompt.md`,替换 `<DATASET_SUMMARY>` / `<PARAMS>`(产品名、地区、时间窗),执行之。
3. **套用确定性规则**(见下,严格照此):
- **创意引擎活跃度**:总量、窗口新上数、新上比 `new_ratio`、advertising_days 中位数。
- **卖点聚焦度**:TOP1 卖点占比;≥40% 判为「聚焦」,<20% 判为「分散」。
- **TOP 素材**:impression / similar_cnt 各取 TOP5,标注「标杆素材」。
- **创意生命周期**:advertising_days 分布 → 区分 evergreen(长投)与短命素材;衰退信号 = 近期新上少 且 老素材仍占主导。
- **处置建议三分类**:放大(高表现且仍可投)、迭代(表现平平但形式/卖点可优化)、淘汰(低表现长投或已衰退)。
4. **按信封交付**:固定信封(结论 → 证据 → 建议 → 边界)。建议按「放大/迭代/淘汰」三栏给出,每条对应具体素材或卖点。
5. **处理缺口**:样本不足或某维度缺失时,只省略对应小节并在边界标注;不得估算。
## 输入/输出契约(摘要)
- **输入**:某单一产品的 `CreativeRecord[]`(建议带时间切片以看演变)。可选附带同品类基线用于对照偏离度。
- **输出**:固定信封的 Markdown 洞察块。数字须由数据集计算得出;不可得则写「数据不足」。
## 边界声明(关键——须告知干系人)
本分析使用的是**素材侧代理指标**(素材量级、相似数、曝光代理、投放天数)。它**不是**真实投放量级/消耗数据(后者需 `advertTrend` / `regionLaunch`)。每份交付物都须标注:*「本分析基于素材侧代理指标,非真实投放量级。」*
用户触发 Prompt 参考:
自动化任务 Prompt 参考:
业务目标:对比两款同品类产品(如两款 SLG)的投放策略差异:卖点侧重、媒体选择、地区侧重、素材风格,给出差异化竞争建议。
工具链:materialList ×2(分别按 campaign_name 锁定两款产品)→ 横向对比📄 参考 SKILL(agg-competitor-compare)— 点击折叠
---
name: agg-competitor-compare
description: 本技能适用于:当需要通过 AGG-MCP(materialList、creativeMarketingWordList、filterList、downloadResourceUrl)获取的多个竞品 App 的海外移动广告创意数据,进行竞品创意投放策略横向对比时。它把竞品创意记录归一化后,产出结构化的跨竞品对比——素材量级、上新节奏(新上比)、媒体/形式/语言占比、TOP 卖点,并按硬规则将每个竞品分类为「加量方 / 换素材方 / 守成方」,给出针对我方可执行的跟进建议。触发场景:UA 周会前的竞品监控周推送(Automation);或用户提出「对比一下竞品 XX 和 YY 这周的买量素材打法」「谁更激进、各自主推什么卖点、渠道和形式有什么差异」。
agent_created: true
---
# AGG 竞品创意策略对比
## 概述
AGG-MCP × Skill × Automation 体系下的**单场景**分析技能。它把归一化后的多竞品创意数据集,转化为一份可直接进周会的**竞品创意策略对比**报告(对应「A · 竞品投放策略对比推送」场景)。本技能与 MCP 取数层解耦:它消费由 MCP/编排层事先拉取并归一化的 `CreativeRecord[]`,自身不调用任何工具。
## 何时调用
- 预定的竞品监控周推送(Automation),用于 UA/买量周会前同步情报。
- 用户要求对比竞品创意买量打法,例如「对比一下竞品 XX 和 YY 在北美 SLG 的买量素材打法:谁更激进?各自主推什么卖点?渠道和形式上有什么差异?」
- 任何需要对 ≥2 个竞品做创意姿态并排对比、而非单品牌视角的任务。
**不要**用它来取数。若还没有 `CreativeRecord` 数据集,先跑 AGG-MCP(filterList → 用 `searchDsl.campaign_name` 逐个竞品 materialList),再回到本技能。
## 核心工作流
1. **加载契约**:读取 `references/data_contract.md`,确认输入符合 schema 与本技能必填字段(`app_name`、`advertising_days`、`selling_points`、`media`、`format`、`language`、`similar_cnt`;至少 1 个竞品 ≥10 条记录)。
2. **发出分析提示词**:复制 `references/analysis_prompt.md`,替换 `<DATASET_SUMMARY>` / `<PARAMS>`(竞品列表、时间窗、目标地区),执行之。
3. **套用确定性分类**:逐竞品计算 `new_ratio = 窗口新上数 / 总量`;按硬规则分类——加量方 `new_ratio ≥ 0.40` 或新上绝对数为集合最高;换素材方 `0.15 ≤ new_ratio < 0.40` 且素材偏新;守成方 `new_ratio < 0.15`。严格照此执行,不得自创类别。
4. **按信封交付**:用 `references/data_contract.md` 的固定信封包裹输出(结论 → 证据表 → 建议 → 边界)。证据表列「竞品 | 总量 | 新上比 | 主投媒体/形式 | TOP卖点 | 分类」。给出恰好 3 条针对我方的跟进建议。
5. **处理缺口**:某竞品样本不足下限时,仍基于现有数据产出,并在边界中标注;不得估算。
## 输入/输出契约(摘要)
- **输入**:`dict[app_name, CreativeRecord[]]` 或带 `app_name` 的扁平 `CreativeRecord[]`。
- **输出**:固定信封的 Markdown 洞察块。数字须由数据集计算得出;不可得则写「数据不足」。
## 边界声明(关键——须告知干系人)
本分析使用的是**素材侧代理指标**(素材量级、上新节奏、媒体/形式/语言占比)。它**不是**真实投放量级/消耗数据(后者需 `advertTrend` / `regionLaunch`,不在当前 MVP 内)。每份交付物都须标注:*「本分析基于素材侧代理指标,非真实投放量级。」*
用户触发 Prompt 参考:
自动化任务 Prompt 参考:
报告样式:📊 双产品投放策略对比(新窗口打开)
业务目标:不聚焦单个产品,而是对整个品类(如 4X SLG)的卖点趋势做汇总,回答「这个品类现在流行打什么卖点」,为新品立项/素材方向提供依据。
工具链:filterList(拿 category)→ creativeMarketingWordList(按品类筛)→ materialList(按 Top 卖点拉样本验证)📄 参考 SKILL(agg-sellingpoint-trend)— 点击折叠
---
name: agg-sellingpoint-trend
description: 本技能适用于:当需要基于 AGG-MCP(materialList、creativeMarketingWordList、filterList、downloadResourceUrl)获取的某海外移动广告品类、跨两个时间切片的创意数据,汇总「卖点趋势变化」时。它计算卖点热度排名环比、按固定阈值标记新兴/衰退卖点,并输出下月创意选题优先级清单。触发场景:月度创意选题会;或用户提出「帮我看看上个月 跨境电商 的素材卖点趋势:哪些卖点热度在涨、哪些在跌?下个月该主推什么 angle」。
agent_created: true
---
# AGG 品类卖点趋势汇总
## 概述
AGG-MCP × Skill × Automation 体系下的**单场景**分析技能。它把两个时间切片的品类数据集,转化为一份结构化的**卖点趋势汇总**(对应「C · 品类素材卖点趋势汇总」场景)。本技能与 MCP 取数层解耦:它消费由 MCP/编排层事先拉取并按时间切片的归一化 `CreativeRecord[]`,自身不调用任何工具。
## 何时调用
- 预定的月度趋势简报(Automation),用于创意选题前。
- 用户要求卖点热度走势,例如「上个月 跨境电商 的卖点趋势:哪些在涨、哪些在跌?下个月主推什么」。
- 任何需要对比某品类卖点格局在两个周期变化的任务。
**不要**用它来取数。若还没有数据集,先跑 creativeMarketingWordList(列出全部卖点)→ 对该品类本月与上月分别 materialList,再回到本技能。
## 核心工作流
1. **加载契约**:读取 `references/data_contract.md`,确认必填字段(`selling_points`、`impression` 须覆盖**两个**切片;≥2 个切片各 ≥20 条)。
2. **发出分析提示词**:复制 `references/analysis_prompt.md`,替换 `<DATASET_SUMMARY>` / `<PARAMS>`(品类、两个切片定义),执行之。
3. **套用确定性标签**:逐卖点计算月环比素材量与排名变化。新兴卖点 = 增长 ≥50% 且 上月基数 <20;衰退卖点 = 下降 ≥30%。结合新兴卖点 + 高基数稳增长卖点,排出 P0/P1/P2 优先级。严格照阈值执行。
4. **按信封交付**:固定信封(结论 → 证据表 → 建议 → 边界)。证据表列「卖点 | 上月量 | 本月量 | 环比 | 排名变化 | 标签」。
5. **处理缺口**:某切片低于下限时,仍基于现有数据产出并在边界标注;不得估算缺失切片。
## 输入/输出契约(摘要)
- **输入**:按两个时间切片(本月/上月)分组的品类卖点数据。
- **输出**:固定信封的 Markdown 洞察块。数字须由数据集计算得出;不可得则写「数据不足」。
## 边界声明(关键——须告知干系人)
本分析使用的是**素材侧代理指标**(素材量、曝光代理)。它**不是**真实投放量级数据(后者需 `advertTrend`)。每份交付物都须标注:*「本分析基于素材侧代理指标,非真实投放量级。」*
用户触发 Prompt 参考:
自动化任务 Prompt 参考:
业务目标:针对某产品或某品类,分析「在哪个地区、用哪个媒体、打什么素材」最有效,指导预算分配。
工具链:materialList(area × media 交叉)→ downloadResourceUrl(抽样下原片)📄 参考 SKILL(agg-region-media)— 点击折叠
---
name: agg-region-media
description: 本技能适用于:当需要基于 AGG-MCP(materialList、creativeMarketingWordList、filterList、downloadResourceUrl)获取的海外移动广告「地区 × 媒体」创意数据,分析地区×媒体创意生态时。它绘制地区×媒体创意地图、标记渠道集中度、描述跨渠道创意风格差异,并输出媒介预算优先级与风险。触发场景:季度媒介预算规划或新市场进入前;或用户提出「我们准备进 拉美 市场,帮我分析 巴西/墨西哥 在 TikTok 和 Meta 上同品类素材的渠道侧重和创意风格差异,预算该往哪边倾斜」。
agent_created: true
---
# AGG 地区 × 媒体 创意生态分析
## 概述
AGG-MCP × Skill × Automation 体系下的**单场景**分析技能。它把(地区, 媒体)交叉分组的创意数据集,转化为一份结构化的**地区 × 媒体创意生态分析**(对应「D · 地区和媒体投放策略分析」场景)。本技能与 MCP 取数层解耦:它消费由 MCP/编排层事先拉取并打标的归一化 `CreativeRecord[]`,自身不调用任何工具。
## 何时调用
- 预定的季度媒介预算复盘,或进入新市场前的一次性分析(Automation / 手动)。
- 用户要求地区/媒体创意差异与预算倾斜,例如「进 拉美,分析 巴西/墨西哥 在 TikTok 与 Meta 上的创意差异,预算怎么倾斜」。
- 任何需要地区×媒体创意地图、而非单渠道视角的任务。
**不要**用它来取数。若还没有数据集,先跑 filterList(地区码 / 媒体ID)→ 按 地区×媒体 交叉 materialList,再回到本技能。
## 核心工作流
1. **加载契约**:读取 `references/data_contract.md`,确认必填字段(`region`、`media`、`format`、`selling_points`、`advertising_days`;≥3 个(地区,媒体)单元各 ≥5 条)。
2. **发出分析提示词**:复制 `references/analysis_prompt.md`,替换 `<DATASET_SUMMARY>` / `<PARAMS>`(地区集、媒体集、时间窗),执行之。
3. **套用确定性规则**:对每个(地区,媒体)单元输出素材量 / 形式占比 / TOP 卖点;渠道集中度——某 media 在某 region 内占比 ≥50% 标「高度集中」,否则「分散」;创意风格差异——基于各 media 的 format/language/selling_points 组合做定性描述;预算优先级 + 风险(如某渠道高度同质化 → 建议差异化或降本)。
4. **按信封交付**:固定信封(结论 → 证据 → 建议 → 边界)。样本 <5 的单元在边界标「样本不足」。
5. **处理缺口**:缺失单元只省略该单元,并在边界枚举;不得估算。
## 输入/输出契约(摘要)
- **输入**:带 `region` 与 `media` 标签(可交叉)的 `CreativeRecord[]`。
- **输出**:固定信封的 Markdown 洞察块。数字须由数据集计算得出;不可得则写「数据不足」。
## 边界声明(关键——须告知干系人)
本分析使用的是**素材侧代理指标**(素材量级、形式/媒体/语言占比)。它**不是**真实投放量级/消耗或媒介成本数据(后者需 `advertTrend` / `regionLaunch` / 媒体 API)。每份交付物都须标注:*「本分析基于素材侧代理指标,非真实投放量级。」*
用户触发 Prompt 参考:
自动化任务 Prompt 参考:
业务目标:每天扫描指定品类的新素材,发现「新出现 + 高曝光」的潜在爆款,第一时间预警,适合配定时任务。
工具链:materialList(isNew=1 + 近 N 天 + 曝光降序)→ downloadResourceUrl📄 参考 Prompt(agg-viral-alert)— 点击折叠
---
name: agg-viral-alert
description: 本技能适用于:当需要基于 AGG-MCP(materialList、creativeMarketingWordList、filterList、downloadResourceUrl)获取的新素材集、对照 ≥7 天基线,监测海外移动广告「爆款素材突发信号」时。它套用三道硬阈值门(相似数超 P95 / 曝光陡增 / ≥3 个独立 App 在 48h 内集中跟投同一卖点),仅当至少一门命中才发预警。触发场景:日级/条件式爆款素材监控(Automation);或用户提出「帮我盯一下 日本市场 RPG 这两天有没有突然冒出来的爆款素材或者新的卖点打法,有就立刻提醒我」。
agent_created: true
---
# AGG 爆款素材监测预警
## 概述
AGG-MCP × Skill × Automation 体系下的**单场景**分析技能。它把「新素材集 + 基线」转化为一个**爆款素材预警**判定(对应「E · 最新爆款素材监测预警」场景)。本技能与 MCP 取数层解耦:它消费由 MCP/编排层事先拉取的归一化 `CreativeRecord[]`(新素材 + 基线),自身不调用任何工具、也不下载素材。
## 何时调用
- 预定的日级 / 高频条件监控任务(Automation),无信号时应保持静默。
- 用户要求盯防突发爆款素材或新卖点打法,例如「盯一下 日本 RPG 这两天有没有突然冒出来的爆款素材,有就提醒我」。
- 任何「无信号时正确输出应为『无异常』而非编造洞察」的任务。
**不要**用它来取数或下载素材。取数由 MCP 层负责;命中后由 MCP 层解析 `downloadResourceUrl`。若还没有数据集,先跑 materialList(isNew=1, order=max_dt_desc, 限定品类/地区)+ 7 天基线,再回到本技能。
## 核心工作流
1. **加载契约**:读取 `references/data_contract.md`,确认必填字段(`material_id`、`similar_cnt`、`impression`、`selling_points`、`media`、`max_dt`、`app_name`、`is_new`;基线 ≥7 天历史;当前窗 ≥1 条)。
2. **发出分析提示词**:复制 `references/analysis_prompt.md`,替换 `<DATASET_SUMMARY>` / `<PARAMS>`(品类、地区、监控窗),执行之。
3. **先算基线**:取近 7 天 `similar_cnt` 的 P95 与各 media 的 `impression` 中位数。若基线 <7 天 → 直接返回「无异常(基线不足 7 天,暂不预警)」并停止。
4. **套用三道硬门(任一命中即预警)**:① 单条 `similar_cnt` > 基线 P95;② `impression` ≥ 同窗口同 media 中位数的 3 倍(或日环比 ≥200%,若有时序);③ 同一 `selling_points` 被 ≥3 个独立 `app_name` 在 48h 内集中投放。**不得放宽**。
5. **交付**:命中时——信封且 Headline=信号类型,证据表列「素材ID+详情页链接 | 卖点 | 主投渠道 | 信号类型」,建议动作为 跟投 / 避坑 / 拆解;未命中任何门——**只**返回「无异常」,绝不编造信号。
## 输入/输出契约(摘要)
- **输入**:带基线形态一致的「新素材 `CreativeRecord[]`」+「≥7 天基线」。
- **输出**:要么「无异常」(或基线不足变体),要么固定信封的预警 Markdown 块。
## 边界声明(关键——须告知干系人)
本分析使用的是**素材侧代理指标**(相似数、曝光代理、卖点共投)。它**不是**真实投放量级数据(后者需 `advertTrend`)。预警触发时须标注:*「本预警基于素材侧代理指标,非真实投放量级。」*
用户触发 Prompt 参考:
自动化任务 Prompt 参考:
六FAQ 常见问题
- ① 画面元素,会带描述,价值:知道标签怎么打
- ② 卖点筛选,33 万+ 动态词库,而是 AI 自动创建新卖点,发现新兴趋势
- ③ 卖点趋势:直接看某品类最近 Top10 卖点,按热度排序,让你知道'为什么火',而不仅是'有哪些'
creativeMarketingWordList(卖点趋势榜)是唯一能回答'为什么这个卖点最近火'的工具。因此 AGG MCP 既能在广度上覆盖从「谁在投」到「为什么有效」的完整链路,也能在深度上给出别处拿不到的创意结论。- AGG Tool 没有成功被客户端发现
- 用户请求没有明确表达素材搜索或分析意图
- Agent 的工具调用权限被关闭
- Skill 或系统指令没有正确加载
- Tool 描述与当前 Agent 的兼容性存在问题