← 返回案例库

有数 MCP 安装说明

把有数-MCP(标准名 youshu-mcp)接入任意支持 MCP 的客户端,即可使用 11 个广告素材与销售数据工具(V1)。

1 · 连接信息

项目值
服务名(标准)youshu-mcp,配置文件中 mcpServers 的键名
端点 URLhttps://api.youshu.youcloud.com/mcp
协议MCP over HTTP(Streamable HTTP),JSON-RPC 2.0
认证Authorization: Bearer <api-key>
API Key由有数服务方提供,接入时替换 <api-key>
请求头Content-Type: application/json + Accept: application/json, text/event-stream

2 · 配置示例

方式一 · 手动写入配置

标准 MCP 客户端配置(mcpServers):

JSON · mcpServers 配置
{
  "mcpServers": {
    "youshu-mcp": {
      "url": "https://api.youshu.youcloud.com/mcp",
      "headers": {
        "Authorization": "Bearer <api-key>"
      }
    }
  }
}

方式二 · 交给 Agent 安装

把下面这段话整段发给你的 Agent(先将 <api-key> 替换为服务方提供的值),由它写入对应客户端的配置文件并完成安装:

发送给 Agent 的提示词
请帮我安装以下 MCP:

{
  "mcpServers": {
    "youshu-mcp": {
      "url": "https://api.youshu.youcloud.com/mcp",
      "headers": {
        "Authorization": "Bearer <api-key>"
      }
    }
  }
}
🔒 密钥请妥善保管:请勿写入公开仓库或分享给他人;如怀疑泄露,请联系服务方更换。

3 · 工具速览(11 个)

建议的调用链路:filterOptions 取枚举 → searchBrands / searchShops / searchKols 反查 ID → searchMaterials 检索素材 → materialCreativeList / creativeAIAnalysisData / creativeAsr 下钻;商品与店铺线走 productSalesRanking → shopSalesMetrics。

工具作用扣点权限
searchMaterials主素材搜索:按关键词 / 品牌 / 店铺 / 达人 / 品类 / 时间(最大 180 天)等维度检索广告素材100/条策略版起可用
filterOptions一次拉全部筛选项候选值(品类、素材类型、视频时长、素材比例等)100/次策略版起可用
searchBrands按品牌名搜品牌 ID(供 searchMaterials 的 brandId)100/次策略版起可用
searchShops按店铺名搜店铺 ID(供 shopId 筛选)100/次策略版起可用
searchKols按达人关键词搜 UID(media 固定 20 = 抖音)100/次策略版起可用
kolBaseInfo达人基本信息(UID、昵称、粉丝数、关联店铺),入参 ccUid100/次策略版起可用
shopSalesMetrics店铺级真实交易指标,仅四项:直播销售额、直播销量、新增销量、新增销售额(禁推导客单价)100/次策略版起可用
productSalesRanking商品销售总榜-抖店:时间范围 + 商品关键词,按新增 / 累计销量排序100/条策略版起可用
materialCreativeList按素材 ID 查关联广告(文案、流量平台、投放日期 / 天数、广告 ID)100/次策略版起可用
creativeAIAnalysisData素材 ID 查卖点标签与自然语言理解内容(画面 / 台词提取的商品特点、功效等)400/条仅策略 pro 版 / 至尊版
creativeAsr按素材 ID 批量获取口播文案(asr 旁白)100/条策略版起可用

4 · 常见问题与使用须知

#场景建议做法
1哪些套餐可用旗舰版 / 旗舰 pro 版 / 尊享版均不可用;策略版 / 策略 pro 版 / 至尊版可用,其中 creativeAIAnalysisData 仅策略 pro 版 / 至尊版开放
2扣点怎么算多数工具 100/次;searchMaterials、productSalesRanking、creativeAsr 按返回条数 100/条,creativeAIAnalysisData 400/条 —— 按条计费时先根据 total 估算总量再翻页
3想搜指定品牌 / 店铺 / 达人的素材先 searchBrands / searchShops / searchKols 拿 ID,再传 brandId / shopId / uid,不要用 keyword 硬搜名称
4店铺销售额 / 销量怎么答shopSalesMetrics 仅返回 live_sales / live_solds / solds / sales 四项;不要推导客单价、不补充其他指标、不用素材数据替代
5时间范围超过 180 天searchMaterials 时间窗最大 180 天,更长周期拆成多次调用
6拉全量素材 / 商品榜单页条数固定且按条扣点,建议采用「脚本直连端点 + 逐页落盘 + 终端只回传摘要」的方式,避免客户端截断和点数浪费
💡 扣点提醒:每次请求都会扣点。调用前严格阅读工具文档、根据 MCP 说明规划请求路径,避免乱尝试导致点数浪费。接入问题可联系有数服务支持获取协助。

5 · 下一步

接入完成后,去案例库挑一个工作流,复制 Prompt 即可开始。推荐从爆量素材检索与参考清单开始。