AppGrowing-MCP 安装说明 #

本文档说明如何将 AppGrowing-MCP（标准名 appgrowing-mcp）接入到支持 MCP 的客户端中。该服务基于 MCP over HTTP（Streamable HTTP） 协议，提供 AppGrowing 中国版的广告素材检索、榜单查询、 投放趋势与创意洞察等 64 个工具，全部通过标准 JSON-RPC 2.0 调用。

1连接信息#

配置示例#

{
  "mcpServers": {
    "appgrowing-mcp": {
      "url": "请求链接待定",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

请帮我安装以下 MCP：

{
  "mcpServers": {
    "appgrowing-mcp": {
      "url": "请求链接待定",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

2工具速览（64 个）#

服务共提供 64 个工具，按用途划分为六类。建议的调用顺序是：filterOptions 取枚举 → 榜单工具找推广物 ID → 素材 / 文案搜索 → 详情与创意解读。

筛选枚举#

几乎所有工具的前置依赖。

素材与文案搜索（核心）#

榜单#

各类推广物的投放量级排行榜，也是查找推广物 ID 的主要入口。

趋势 / 金额分布（应用 · 品牌 · 公司 · 小程序）#

素材级详情#

创意洞察（仅游戏 / 小游戏）#

3关键调用参数#

3.1  filterOptions（先调一次）#

无入参。返回体按 label 分组，常用 label 与高频枚举速查：

3.2  searchMaterials（素材搜索主力）#

必填：page、order

排序枚举（order）：

常用筛选

3.3 返回字段要点#

列表位置

同级返回 page（当前页）与 total（总量）。

素材结构（data[].material）

campaign[].type 常见值：

一条素材可能关联多个推广物，取用时请按 type 筛选（见第 5 节）。

素材类型码

入参 mtype 与 material.id 后缀一致。

榜单行结构

推广物主体字段随榜单类型不同：游戏 / 应用榜为 appBrand、品牌榜为 brand、公司榜为 company、开发者榜为 developer；共同字段有 adverts（广告创意数）、duration（投放天数）、budget（投放金额），多数榜单还含 advertHistory（投放起止）与 promoteChannel[]（分渠道量级）。

创意解读（creativeAIAnalysisData）

data.creativeAIAnalysisData[]，每项含 id（与入参 ids 一一对应）、asr（旁白）、sellPoint（创意卖点）、aiCommentary（AI 解读）；部分素材可能暂无解读内容（字段为 null）。

文案结构（data.domesticSloganList.data[]）

id、slogan、style、adverts、duration。

4返回数据截断的解决方案#

解决思路（可把这段描述交给 Agent，由它自行生成脚本，无需手写）：

5常见问题与注意事项#