← 返回案例库有数 MCP 安装说明
把有数-MCP(标准名 youshu-mcp)接入任意支持 MCP 的客户端,即可使用 11 个广告素材与销售数据工具(V1)。
1 · 连接信息
| 项目 | 值 |
|---|
| 服务名(标准) | youshu-mcp,配置文件中 mcpServers 的键名 |
| 端点 URL | https://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、昵称、粉丝数、关联店铺),入参 ccUid | 100/次 | 策略版起可用 |
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 即可开始。推荐从爆量素材检索与参考清单开始。