AppGrowing MCP(标准服务名 appgrowing-mcp)是 AppGrowing 中国版开放的标准化广告情报接口。基于 MCP over HTTP(Streamable HTTP)协议,对外提供 64 个工具,覆盖广告素材检索、投放榜单、预算趋势与创意洞察全链路。
| 项目 | 值 |
|---|---|
| 端点 URL | https://api-appgrowing-cn.youcloud.com/mcp |
| 认证 | Authorization: Bearer <API_KEY> |
| 协议 | Streamable HTTP,会话无状态(stateless) |
官方建议调用顺序:filterOptions 取枚举 → 榜单工具找推广物 ID → 素材 / 文案搜索 → 详情与创意解读。
几乎所有工具的前置依赖。先把筛选维度的合法取值拿全,后面才不会传错参数。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
filterOptions | 不知道流量平台、广告媒体、行业、游戏分类等维度该传什么值 | 一次调用返回全部枚举常量,作为所有工具的统一字典,避免无效查询 |
从海量广告库里精准捞素材、捞文案。日常用得最勤,也是搭建素材库和文案库的入口。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
searchMaterials | 想按关键词 / 行业 / 媒体 / 时间找广告素材,但平台素材太多翻不完 | 主力搜索入口,支持精准匹配、AI 素材 / 新素材 / 高清筛选,一次返回 100 条 |
searchDetailMaterials | 要锁定某家公司 / 某个 App / 某个小程序的全部投放素材 | 按推广物主体精确检索,竞品素材全景一键拉齐 |
searchBrandMaterials | 要按品牌维度看素材 | 品牌级素材合集,适合品牌方做自身 / 竞品比对 |
searchSlogans | 文案灵感枯竭,想找行业里的优质广告语 | 广告文案搜索,支持按公司 / 游戏 / 应用 / 小程序筛选,直接建文案库 |
searchBrandSlogans | 想看某个品牌的文案风格演变 | 品牌 slogan 沉淀,做文案调性分析 |
creativeAIAnalysisData | 素材太多,人工看完每条旁白和卖点太慢 | 批量获取 ASR 旁白、创意卖点、AI 解读,一次最多 100 条,把"看素材"变成"读报告" |
creativeResourceUrl | 拿到视频封面文件名,但下不下来 | 传入 poster 换取带时效的临时直链,方便存档和二次使用 |
快速定位各行业 / 品类的头部投放者,发现竞品与标杆。做竞品发现、行业 Benchmark、投放规模摸底最快的入口。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
gameAdRanking | 想知道游戏行业谁在猛投 | 游戏广告投放量级排行 |
appAdRanking | 想知道应用行业投放规模 | 应用 App 排行,支持按月 / 季度 |
miniGameAdRanking | 小游戏赛道谁在放量 | 小游戏排行,支持按月 / 季度 |
miniProgramAdRanking | 小程序投放谁最猛 | 小程序排行 |
playletMiniProgramAdRanking | 短剧小程序投放格局 | 短剧类小程序排行 |
playletAdRanking | 短剧剧目投放热度 | 单部短剧排行,选剧 / 跟投参考 |
novelAdRanking | 小说行业投放情况 | 小说排行 |
ecomBrandAdRanking | 电商品牌投放力度 | 电商品牌排行 |
leadBrandAdRanking | 线索行业(教育 / 金融等)谁在投 | 线索收集品牌排行 |
productAdRanking | 电商某个 SKU 投了多少 | 电商品(SKU)排行 |
shopAdRanking | 电商店铺投放排名 | 电商店铺排行 |
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
gameDeveloperAdRanking | 游戏开发商整体投放实力 | 游戏开发商排行 |
appDeveloperAdRanking | 应用开发商投放实力 | 应用开发商排行 |
shopCompanyAdRanking | 电商商家主体投放排名 | 电商商家(公司)排行 |
leadCompanyAdRanking | 线索行业投放公司排名 | 线索收集公司排行 |
playletAdvertiserAdRanking | 短剧投放公司格局 | 短剧投放公司排行 |
copyrightCompanyAdRanking | 短剧版权方投放情况 | 短剧版权公司排行 |
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
miniGameTrendRanking | 想抓正在起量的小游戏 | 小游戏上升榜(创意数 > 10 且环比上升),近 30 天 |
wechatMiniGameRanking | 微信小游戏榜单动态 | 微信官方榜(畅销 / 人气 / 畅玩) |
douyinMiniGameRanking | 抖音小游戏榜单动态 | 抖音官方榜(热门 / 新游 / 畅销) |
taptapReservationRanking | 预约期游戏投放 + 预约排名 | 游戏预约榜,仅游戏有效 |
kolAdRanking | 游戏品类哪些达人被投放 | 游戏达人(KOL)投放排行,仅游戏 |
channelAdRanking | 流量平台和媒体各自的投放量 | 渠道 / 媒体排行,看预算流向哪里 |
看投放量级随时间的走势、预算在媒体 / 渠道的分布、素材形式的占比。做投放策略复盘、预算 Benchmark、渠道结构分析的核心。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
appAdVolumeTrend | 某个 App 投放量逐日怎么变 | 量级趋势按日看,判断起量 / 收量节点 |
appBudgetByMediaOverview | 预算花在哪些媒体上 | 应用按媒体分布(按月 / 季度) |
appChannelBudgetOverview | 预算花在哪些流量平台 | 应用按渠道分布(按月 / 季度) |
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
brandAdVolumeTrend | 品牌投放量逐日走势 | 品牌量级趋势 |
brandBudgetHistory | 品牌历史投放金额 | 按月金额回溯 |
brandBudgetByChannel | 品牌预算按流量平台分布 | 渠道结构分析 |
brandBudgetByMedia | 品牌预算按广告媒体分布 | 媒体结构分析 |
brandChannelOverview | 品牌在各平台投放概览 | 一页看清版位布局 |
brandMediaOverview | 品牌在各媒体投放概览 | 媒体布局一目了然 |
brandAdFormatOverview | 品牌用了哪些广告形式 | 形式占比(信息流 / 开屏等) |
brandMaterialTypeOverview | 品牌素材是视频还是图片为主 | 素材类型占比,指导创意生产 |
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
companyInfo | 想了解一家公司底细 | 工商信息、股东、重要人员、分支机构 |
companyAdProductList | 这家公司到底投了哪些产品 | 游戏 / 应用 / 小游戏 / 小程序全量清单 |
companyPlayletList | 短剧公司投了哪些剧 | 短剧剧目清单(仅短剧公司有效) |
companyBudgetByChannel | 公司预算按渠道分布 | 渠道维度 Benchmark |
companyBudgetByMedia | 公司预算按媒体分布 | 媒体维度 Benchmark |
companyBudgetByProduct | 公司预算花在哪些产品上 | 产品维度预算分配 |
companyBudgetHistory | 公司历史投放金额 | 按月金额回溯 |
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
miniAppInfo | 想看某个小程序 / 小游戏底细 | 行业、开发商、备案号、出版号、变现方式 |
miniAppAdVolumeTrend | 小程序投放量随时间变化 | 量级趋势按时间范围 |
miniAppChannelOverview | 小程序在平台和媒体的占比 | 渠道 / 媒体结构 |
miniAppMediaOverview | 小程序在各媒体投放概览 | 媒体布局 |
miniAppAdFormatOverview | 小程序用了哪些广告形式 | 形式占比 |
miniAppMaterialTypeOverview | 小程序素材类型占比 | 视频 / 图片占比 |
miniGameOfficialTopRank | 小游戏在各官方榜的历史最高 | 峰值排名参考 |
miniGameOfficialRankTrend | 小游戏官方排名变化趋势 | 排名走势,判断上升势能 |
单条素材的全链路投放数据拆解。想复制一条爆款素材,或者判断它为什么能跑,靠这组。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
materialChannelOverview | 这条素材到底投了哪些平台 / 媒体 | 版位分布,指导自己的投放选位 |
materialPlatformOverview | 素材在 iOS / Android 的占比 | 设备结构,判断人群 Device 偏好 |
materialScoreTrend | 素材质量指数怎么变化 | 生命周期判断,决定加投还是弃 |
materialCreativeList | 这条素材关联了多少条广告 | 投放规模,判断是不是主力素材 |
materialCampaignOverview | 素材投了哪些产品 | 关联推广物,理清素材归属 |
创意方向缺乏数据支撑时的救命工具,帮你看清当前主流打法。
| 工具 | 解决的问题 | 客户价值 |
|---|---|---|
gameSellingPointTrends | 不知道当前游戏赛道主流卖点是什么 | 创意卖点趋势榜,支持全局或按产品筛选,指导创意方向 |
golden3sLinesRanking | 开头 3 秒抓不住用户 | 黄金 3 秒台词排行榜,直接抄优秀开场 |
64 个工具串起"找竞品 → 看素材 → 析趋势 → 拆创意"的完整链路,不用在多个后台之间来回切。
任何支持 MCP 的客户端配一段 JSON 就能用,研发零成本。
支持脚本直连端点逐页拉取,百万级素材也能稳定入库做二次分析。
内置 AI 解读,把素材旁白、卖点、黄金 3 秒直接结构化输出,省掉人工扒素材的时间。
searchMaterials + creativeAIAnalysisData 批量建库,按卖点 / 形式打标。| 项目 | 值 |
|---|---|
| 服务名(标准) | appgrowing-mcp |
| 端点 URL | https://api-appgrowing-cn.youcloud.com/mcp |
| 协议 | MCP over HTTP(Streamable HTTP),JSON-RPC 2.0 |
| 认证 | Authorization: Bearer <API_KEY> |
| 请求头 | Content-Type: application/json + Accept: application/json, text/event-stream |
| 响应格式 | SSE(逐行返回,data: 前缀后是 JSON) |
| 会话模式 | stateless(可不带 mcp-session-id) |
API Key 由 AppGrowing 服务方提供。登录控制台获取:
https://appgrowing-cn.youcloud.com/dashboard?finance=%2Fteam%2Finfo
方式一 · 手动写入客户端配置(在 MCP 客户端的配置文件里加入):
{
"mcpServers": {
"appgrowing-mcp": {
"url": "https://api-appgrowing-cn.youcloud.com/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
}方式二 · 交给 Agent 安装:把下面整段发给你的 Agent(先把 <API_KEY> 替换为服务方提供的密钥),由它写入对应客户端配置并完成安装:
请帮我安装以下 MCP:
{
"mcpServers": {
"appgrowing-mcp": {
"url": "https://api-appgrowing-cn.youcloud.com/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
}filterOptions(无入参)取回全部筛选枚举,后续工具复用。searchMaterials / searchSlogans 拉素材和文案。searchMaterials 必填参数:page、order。order 可选:
| 枚举值 | 含义 |
|---|---|
max_dt_desc | 投放时间降序 |
cnt_dt_desc | 投放天数降序 |
cnt_ad_id_desc | 关联广告数降序 |
material_score_desc | 质量指数降序 |
_score_desc | 相关性(不带 keyword 时禁用) |
105 巨量 / 102 腾讯 / 110 百度 / 209 快手;媒体 8 抖音 / 4 头条 / 48 B站 / 69 穿山甲;设备 1 Android / 2 iOS;游戏分类 10101 角色扮演 / 10105 休闲益智。accurateSearch: 1 开启精准匹配,否则会被拆词带入无关素材。| # | 场景 | 建议做法 |
|---|---|---|
| 1 | 搜索多字中文品牌词命中大量无关素材 | 传 accurateSearch: 1 开启精准匹配 |
| 2 | 文案 / 榜单日期参数跨月报错 | 日期仅支持单月或单季度,跨月拆多次调用 |
| 3 | 不确定筛选参数该传什么值 | 先调 filterOptions 取回全部枚举后复用 |
| 4 | 想按素材类型(视频 / 图片)筛选 | 用 mtype 传类型码,与 material.id 后缀一致 |
| 5 | 一条素材的 campaign 有多个推广物 | 按 type 筛选(如 appBrand-401)再取 name,别默认取数组首位 |
| 6 | creativeAIAnalysisData 的 ids 传什么 | 传 material.creative.resource[].id,返回与入参一一对应 |
| 7 | 下载视频素材封面 | 将 resource[].poster 作 key 传 creativeResourceUrl 换临时直链(仅视频有 poster) |
| 8 | 拉取素材单次最多 100 条且可能被截断 | 用"脚本直连 + 逐页落盘",终端只回传摘要 |
| 9 | 调用频率过高返回 00:400998 | 控制并发,间隔 2~3 秒重试 |
| 10 | 创意洞察类工具适用范围 | golden3sLinesRanking / gameSellingPointTrends 支持游戏 / 小游戏;kolAdRanking 仅游戏 |
page 从 1 开始循环翻页、每页原始响应直接落盘,终端只打印 total 和落盘路径等统计信息,分析时再读文件。若脚本报证书错误,安装 certifi 并指定其证书即可。接入问题可联系 AppGrowing 服务支持获取协助。