AppGrowing MCP 产品功能介绍

面向客户的产品手册 · 基于官方接入文档(docs.appgrowing.cn/mcp)整理

64 个工具 · 6 大能力模块 · 标准 MCP 协议接入

1产品概述

AppGrowing MCP(标准服务名 appgrowing-mcp)是 AppGrowing 中国版开放的标准化广告情报接口。基于 MCP over HTTP(Streamable HTTP)协议,对外提供 64 个工具,覆盖广告素材检索、投放榜单、预算趋势与创意洞察全链路。

标准协议接入JSON-RPC 2.0 + Bearer Token,无状态会话。Claude Desktop / Cursor / Cline / WorkBuddy 等任意 MCP 客户端一键接入,无需自建爬虫
全行业覆盖64 个工具横跨游戏、应用、小程序、小游戏、短剧、电商、品牌、达人全部推广物类型
结构化返回单次默认 100 条,可按 page 翻页,直接落盘做批量分析
创意解读能力内置 AI 解读(旁白 / 卖点 / 黄金 3 秒),把"看素材"升级为"读素材"

接入三要素

项目值
端点 URLhttps://api-appgrowing-cn.youcloud.com/mcp
认证Authorization: Bearer <API_KEY>
协议Streamable HTTP,会话无状态(stateless)

2六大能力模块(64 个工具分类)

官方建议调用顺序:filterOptions 取枚举 → 榜单工具找推广物 ID → 素材 / 文案搜索 → 详情与创意解读。

模块一 · 筛选枚举(1 个工具)

几乎所有工具的前置依赖。先把筛选维度的合法取值拿全,后面才不会传错参数。

工具解决的问题客户价值
filterOptions不知道流量平台、广告媒体、行业、游戏分类等维度该传什么值一次调用返回全部枚举常量,作为所有工具的统一字典,避免无效查询

模块二 · 素材与文案搜索(7 个工具)— 核心能力

从海量广告库里精准捞素材、捞文案。日常用得最勤,也是搭建素材库和文案库的入口。

工具解决的问题客户价值
searchMaterials想按关键词 / 行业 / 媒体 / 时间找广告素材,但平台素材太多翻不完主力搜索入口,支持精准匹配、AI 素材 / 新素材 / 高清筛选,一次返回 100 条
searchDetailMaterials要锁定某家公司 / 某个 App / 某个小程序的全部投放素材按推广物主体精确检索,竞品素材全景一键拉齐
searchBrandMaterials要按品牌维度看素材品牌级素材合集,适合品牌方做自身 / 竞品比对
searchSlogans文案灵感枯竭,想找行业里的优质广告语广告文案搜索,支持按公司 / 游戏 / 应用 / 小程序筛选,直接建文案库
searchBrandSlogans想看某个品牌的文案风格演变品牌 slogan 沉淀,做文案调性分析
creativeAIAnalysisData素材太多,人工看完每条旁白和卖点太慢批量获取 ASR 旁白、创意卖点、AI 解读,一次最多 100 条,把"看素材"变成"读报告"
creativeResourceUrl拿到视频封面文件名,但下不下来传入 poster 换取带时效的临时直链,方便存档和二次使用

模块三 · 榜单(23 个工具)

快速定位各行业 / 品类的头部投放者,发现竞品与标杆。做竞品发现、行业 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流量平台和媒体各自的投放量渠道 / 媒体排行,看预算流向哪里

模块四 · 趋势与金额分布(应用 / 品牌 / 公司 / 小程序)(26 个工具)

看投放量级随时间的走势、预算在媒体 / 渠道的分布、素材形式的占比。做投放策略复盘、预算 Benchmark、渠道结构分析的核心。

应用维度(3 个)

工具解决的问题客户价值
appAdVolumeTrend某个 App 投放量逐日怎么变量级趋势按日看,判断起量 / 收量节点
appBudgetByMediaOverview预算花在哪些媒体上应用按媒体分布(按月 / 季度)
appChannelBudgetOverview预算花在哪些流量平台应用按渠道分布(按月 / 季度)

品牌维度(8 个)

工具解决的问题客户价值
brandAdVolumeTrend品牌投放量逐日走势品牌量级趋势
brandBudgetHistory品牌历史投放金额按月金额回溯
brandBudgetByChannel品牌预算按流量平台分布渠道结构分析
brandBudgetByMedia品牌预算按广告媒体分布媒体结构分析
brandChannelOverview品牌在各平台投放概览一页看清版位布局
brandMediaOverview品牌在各媒体投放概览媒体布局一目了然
brandAdFormatOverview品牌用了哪些广告形式形式占比(信息流 / 开屏等)
brandMaterialTypeOverview品牌素材是视频还是图片为主素材类型占比,指导创意生产

公司维度(7 个)

工具解决的问题客户价值
companyInfo想了解一家公司底细工商信息、股东、重要人员、分支机构
companyAdProductList这家公司到底投了哪些产品游戏 / 应用 / 小游戏 / 小程序全量清单
companyPlayletList短剧公司投了哪些剧短剧剧目清单(仅短剧公司有效)
companyBudgetByChannel公司预算按渠道分布渠道维度 Benchmark
companyBudgetByMedia公司预算按媒体分布媒体维度 Benchmark
companyBudgetByProduct公司预算花在哪些产品上产品维度预算分配
companyBudgetHistory公司历史投放金额按月金额回溯

小程序 / 小游戏维度(8 个)

工具解决的问题客户价值
miniAppInfo想看某个小程序 / 小游戏底细行业、开发商、备案号、出版号、变现方式
miniAppAdVolumeTrend小程序投放量随时间变化量级趋势按时间范围
miniAppChannelOverview小程序在平台和媒体的占比渠道 / 媒体结构
miniAppMediaOverview小程序在各媒体投放概览媒体布局
miniAppAdFormatOverview小程序用了哪些广告形式形式占比
miniAppMaterialTypeOverview小程序素材类型占比视频 / 图片占比
miniGameOfficialTopRank小游戏在各官方榜的历史最高峰值排名参考
miniGameOfficialRankTrend小游戏官方排名变化趋势排名走势,判断上升势能

模块五 · 素材级详情(5 个工具)

单条素材的全链路投放数据拆解。想复制一条爆款素材,或者判断它为什么能跑,靠这组。

工具解决的问题客户价值
materialChannelOverview这条素材到底投了哪些平台 / 媒体版位分布,指导自己的投放选位
materialPlatformOverview素材在 iOS / Android 的占比设备结构,判断人群 Device 偏好
materialScoreTrend素材质量指数怎么变化生命周期判断,决定加投还是弃
materialCreativeList这条素材关联了多少条广告投放规模,判断是不是主力素材
materialCampaignOverview素材投了哪些产品关联推广物,理清素材归属

模块六 · 创意洞察(仅游戏 / 小游戏)(2 个工具)

创意方向缺乏数据支撑时的救命工具,帮你看清当前主流打法。

工具解决的问题客户价值
gameSellingPointTrends不知道当前游戏赛道主流卖点是什么创意卖点趋势榜,支持全局或按产品筛选,指导创意方向
golden3sLinesRanking开头 3 秒抓不住用户黄金 3 秒台词排行榜,直接抄优秀开场

3客户价值总结

一站式广告情报

64 个工具串起"找竞品 → 看素材 → 析趋势 → 拆创意"的完整链路,不用在多个后台之间来回切。

标准协议、免开发接入

任何支持 MCP 的客户端配一段 JSON 就能用,研发零成本。

数据可批量落盘

支持脚本直连端点逐页拉取,百万级素材也能稳定入库做二次分析。

从"看"到"读"

内置 AI 解读,把素材旁白、卖点、黄金 3 秒直接结构化输出,省掉人工扒素材的时间。

典型落地场景

4MCP 安装指南

1. 连接信息

项目值
服务名(标准)appgrowing-mcp
端点 URLhttps://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)

2. 获取 API Key

API Key 由 AppGrowing 服务方提供。登录控制台获取:

https://appgrowing-cn.youcloud.com/dashboard?finance=%2Fteam%2Finfo

🔒 密钥请妥善保管,勿写入公开仓库或分享他人;如怀疑泄露,请联系服务方更换。

3. 配置方式

方式一 · 手动写入客户端配置(在 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>"
      }
    }
  }
}

4. 调用顺序与关键参数

  1. 先调 filterOptions(无入参)取回全部筛选枚举,后续工具复用。
  2. 用榜单工具找目标推广物 ID。
  3. 用 searchMaterials / searchSlogans 拉素材和文案。
  4. 用详情 / 创意工具做深度拆解。

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 开启精准匹配,否则会被拆词带入无关素材。

5常见问题

#场景建议做法
1搜索多字中文品牌词命中大量无关素材传 accurateSearch: 1 开启精准匹配
2文案 / 榜单日期参数跨月报错日期仅支持单月或单季度,跨月拆多次调用
3不确定筛选参数该传什么值先调 filterOptions 取回全部枚举后复用
4想按素材类型(视频 / 图片)筛选用 mtype 传类型码,与 material.id 后缀一致
5一条素材的 campaign 有多个推广物按 type 筛选(如 appBrand-401)再取 name,别默认取数组首位
6creativeAIAnalysisData 的 ids 传什么传 material.creative.resource[].id,返回与入参一一对应
7下载视频素材封面将 resource[].poster 作 key 传 creativeResourceUrl 换临时直链(仅视频有 poster)
8拉取素材单次最多 100 条且可能被截断用"脚本直连 + 逐页落盘",终端只回传摘要
9调用频率过高返回 00:400998控制并发,间隔 2~3 秒重试
10创意洞察类工具适用范围golden3sLinesRanking / gameSellingPointTrends 支持游戏 / 小游戏;kolAdRanking 仅游戏
📦 批量拉取提示:单次返回上限 100 条,内容多的返回可能超过 MCP 客户端约 100KB 的截断阈值。可靠做法是脚本直连端点、用 page 从 1 开始循环翻页、每页原始响应直接落盘,终端只打印 total 和落盘路径等统计信息,分析时再读文件。若脚本报证书错误,安装 certifi 并指定其证书即可。

接入问题可联系 AppGrowing 服务支持获取协助。