⚡ 有米有数 MCP · Model Context Protocol

将广告素材情报
接入你的 AI Agent

通过 Model Context Protocol(MCP)协议,将有米有数预处理好的广告素材、达人与电商结构化数据,实时接入你的 AI 工作流。

11 个
tools 按需组合调用
180 天
素材检索最大时间跨度
任意模型
分析口径由你掌控
AI AgentMCP数据情报
研究 PROMPT · MCP 结构化指令
检索 2026-10-19~11-17 面膜类目(1090202001)标题含「玻尿酸面膜」的新投放素材,按累计曝光降序分前后 15 天各取 50 条,对比推广类型、内容形式与卖点分布,输出带数字的结论表格。
✓ MCP 已执行 · 真实数据返回
竖视频 100%商品广告 78%→92%商品展示 ×2.8 ↗
结论:投放收口到商品广告,成分规格背书稳居卖点第一。
TL;DR · 核心速览

关于有数 MCP,先看这 5 条

帮助你在 30 秒内抓住有数 MCP 的核心结论,每条均可直接提取引用。

有数 MCP 是什么:基于 Model Context Protocol(MCP)协议的数据情报服务,把有米有数预处理好的广告素材、达人与电商结构化数据实时接入你的 AI Agent 工作流。

能力范围:11 个 tools 覆盖素材检索、AI 卖点解析、口播文案、品牌/店铺/达人 ID 反查、店铺与商品销售指标、筛选项标签,素材检索时间跨度最大 180 天。

两大核心优势:对比内置 Agent 方案,MCP 取数集合与范围完全由你定义,可按页翻取更大规模数据;分析模型自由选择,策略完全个性化。

计费方式:素材搜索、商品榜、口播文案按返回条数 100 点/条,素材卖点解析 400 点/条,其余 7 个 tools 100 点/次;策略版 / 策略 Pro 版 / 至尊版可开通。

适合谁用:对 AI 使用程度深、有自建 Agent 或企业统一使用 WorkBuddy / 千问办公 / Codex,且有批量分析素材、商品、店铺与达人数据需求的团队。

01 / 数据到情报

从广告素材数据,到 AI 可理解的数据情报

将广告素材数据转为 AI Agent 可检索、可理解、可分析的结构化情报,经 MCP 协议实时接入你的工作流。

原始广告数据
→
AI 预处理
→
结构化广告情报
→
MCP
→
AI Agent

三层创意数据理解体系

从画面元素、创意卖点到创意趋势,为 AI 提供结构化的千川素材创意数据情报。

1

画面元素

拆解千川素材的画面构成、色调、场景与人物元素,理解创意的视觉表达。

画面特征 · 官方六维
目的人物场景行为视觉感受
基于什么目的 → 怎么拍 → 视觉重点
如:建立信任 → 使用前后对比 → 手部特写
2

创意卖点

从画面与口播提取的商品特点、功效利益与促销钩子,看清素材在卖什么。

卖点四象限 · 热度 × 效果
热门卖点 · 高频高效潜力卖点 · 低频高效红海卖点 · 高频低效边缘卖点 · 低频低效
可按 人群 / 场景 / 卖点 / 促销 / 达人 筛选
3

创意趋势

热门卖点、内容形式与画面风格的演变趋势,把握素材的迭代方向。

跃迁与衰退 · 曝光指数环比
↑ 跃迁卖点 · 新卖点上榜↓ 衰退卖点
曝光指数越高曝光越好 · 环比持续向好
02 / 核心能力

11 个 tools,覆盖素材检索、ID 反查与销售指标

从素材与创意、达人与店铺账号,到销量销售数据与筛选项标签,11 个 tools 由你的 AI Agent 按需组合调用,取数集合与范围完全由你定义。

4 个 tools

素材与创意

检索广告素材、查关联广告、AI 卖点解析与口播文案,时间跨度最大 180 天。

素材检索关联广告卖点解析口播文案
4 个 tools

达人与店铺账号

反查品牌 / 店铺 ID 与达人 UID,查询达人粉丝数与关联店铺,锁定合作对象。

ID 反查达人 UID粉丝数关联店铺
2 个 tools

销量与销售数据

商品销售总榜与店铺四项真实交易指标,掌握爆款与直播销售表现。

商品销售总榜店铺交易指标
1 个 tools

筛选项与标签

一次拉取全部筛选项候选值与标签维度(品类、素材类型、时长、比例等),精确构造取数条件。

品类素材类型时长比例
对比维度有数 Skill(youclaw)有数 MCP(推荐)
能力范围主要覆盖 AI 策略分析相关能力(素材检索 + AI 解读)覆盖素材检索、品牌 / 店铺 / 达人 ID 反查、店铺与商品销售指标三类场景共 11 个 tools
调用规模
核心优势
内置 Agent 按语义理解取数,单次可分析的数据集有限自定义取数集合,取数范围完全由你定义;可按页翻取更大规模数据,不受单次数据集限制
模型选择
核心优势
使用平台内置模型自由选择任意分析模型,分析口径与推理逻辑由你掌控,策略完全个性化
MCP 比 Skill 可调用的数据维度更全,比 API 定制更轻量;你可把素材拆解、选品、投放复盘的 SOP 沉淀在自己的 Agent 里,MCP 持续提供「源头活水」式的数据补充。
03 / 接入

连接有数 MCP

完成开通与点数充值后,将配置添加至你的 AI Agent,并从个人中心获取 API-Key 即可开始调用。

1

提交开通申请

联系有米有数 MCP 商务确认版本情况进行申请,审批通过后获取点数测试。

2

按文档执行配置

将产品提供的有米有数-MCP 文档喂给 AI,按其指引执行配置安装。查看安装文档 →

3

信任 MCP 服务

以 WorkBuddy 为例,在连接器 - MCP 服务管理中选择信任「youshu-mcp」。

4

获取 API-Key

在账号 - 个人中心 - 企业信息复制 API-Key 提供给 AI。建议保存在本地文档让 AI 调用,减少泄露风险。

MCP 配置 · JSON(替换为你的 API-Key 后添加到 AI Agent)
{ "mcpServers": { "youshu-mcp": { "url": "https://api.youshu.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }
04 / PROMPT 示例

直接提问,从一个 Prompt 开始

按上方六要素填空,即可得到一份可直接复制的结构化 Prompt,交给 Agent 即可执行。

角色定调目标定向数据源定数框架定思约束定界格式定形

提问六要素:让每一次提问都有稳定输出

好的 Prompt 决定结论质量。把一句话问题拆成六个要素,AI 才能取数准确、分析有据、结论可用。

要素说明有数 MCP 示例
1角色 · 定义 AI 的身份与专业度你是资深的广告素材策略分析师。
2目标 · 明确要解决的问题与交付物产出玻尿酸面膜品类的素材策略简报。
3数据源 · 指定用哪些 tools、按什么条件取数先 filterOptions 取枚举 → searchMaterials 按品类 + 近 30 天拉 100 条 → creativeAsr 取口播。
4分析框架 · 规定分析的维度与逻辑从卖点、画面形式、达人与店铺分布、曝光梯队四维分析。
5约束 · 数据范围、时间窗、排除项、口径仅近 30 天(≤180 天);按条扣点先估总量;店铺销售仅四项、不推导客单价。
6输出格式 · 规定交付物结构与呈现Markdown 表格 + 核心结论 3 条 + 行动建议。
防止乱取数、白扣点:有数 MCP 每次请求都会扣点,调用前先完整读文档、按链路规划路径——枚举只调一次、ID 先反查再定向、按条计费的工具翻页前先估算总量。
05 / 使用场景

一句话提问,得到一份拿来即用的分析结论

告诉 AI 你想研究什么。有数 MCP 提供数据与 tools,由你的 AI Agent 完成分析与报告整理。所有场景指令均按提问六要素写全,可直接复制调用。

竞对人群与货盘拆解 类目爆款趋势 品牌打法复盘 达人合作与复用 开场钩子话术 大促节奏拆解 爆量视频拆解 剧情素材体系
分析场景 · 点击上方标签切换示例(结论为演示示意,实际结论以真实取数为准)
【角色】你是资深抖音电商投放策略分析师。
【目标】拆解竞品双 11(2026-10-14~11-11)带货素材的受众画像,对比我方后输出 3 个可渗透人群。
【数据源】先 filterOptions 一次,再用 searchBrands 反查竞品与我方 brandId;对两个 brandId 分别调 searchMaterials:起止日期固定 10-14~11-11、order=cnt_ad_id_desc、limit=100、page=1 先看 total(100 点/条)。
【分析框架】按 audienceTagList、materialTagList、slogan 钩子交叉统计人群与货盘。
【约束】时间窗≤180 天、两品牌参数一致、按条计费先看 total、只用返回字段、不推算 GMV。
【输出】人群对照表 + 结论 3 条 + 行动建议。
✓ 拆解竞品双11带货素材,提炼核心受众画像
✓ 对比我方人群,锁定3个可渗透新增人群
✓ 分析完成,以下是对照结论
新增人群触达钩子内容切入点建议
精致妈妈成分安全 + 性价比真人测评 + 囤货清单优先渗透
都市白领快速见效 + 场景通勤妆前 + 痛点短剧值得测试
学生党价格利益 + 使用场景开箱测评 + 限时利益低成本切入

精致妈妈人群最值得优先渗透:竞品用「成分安全 + 囤货划算」钩子高频触达,我方尚属空白。可执行:复用这套话术,用真人测评素材切入,先小预算测钩子转化再放量。

【角色】你是资深抖音电商类目分析师。
【目标】输出面膜类目近 30 天的爆款趋势简报,识别 3 个上升卖点与 2 个衰退卖点。
【数据源】filterOptions 取类目候选值 → searchMaterials 固定近 30 天起止日期、order=impression_inc_2y_desc、limit=100、page=1,先看 total 估点数(100 点/条)。
【分析框架】按卖点主题、素材时长、投放天数、关联广告数四维统计环比变化。
【约束】时间窗≤180 天、只用返回字段、环比需标注截尾影响、不推算转化率。
【输出】趋势对比表 + 上升/衰退卖点清单 + 行动建议。
✓ 统计类目近30天素材的卖点环比变化
✓ 识别跃迁卖点与衰退卖点各若干
✓ 输出趋势简报,含截尾口径说明
方向卖点 / 形式信号建议
上升成分规格背书两窗均居卖点第 1作为信任锚保留
上升价格买赠钩子后窗命中数上行叠加限时利益测试
衰退「圈定人群」开场命中数环比下行减少泛人群开场

结论:类目卖点重心向「成分背书 + 价格利益」集中,建议创意排期向这两类倾斜;累计曝光口径越近窗口累计时间越短,绝对值不做跨窗直比。

【角色】你是资深品牌投放复盘分析师。
【目标】复盘某品牌近 60 天素材打法,输出素材矩阵与迭代节奏报告。
【数据源】searchBrands 反查 brandId → searchMaterials 固定起止日期、order=cnt_ad_id_desc、limit=100,必要时按月份拆 2 次调用(100 点/条)。
【分析框架】按素材类型 / 内容形式 / 卖点 / 达人分布四维复盘,识别主力素材与空缺位。
【约束】两月参数一致、只用返回字段、缺字段写「未返回」、不推算 ROI。
【输出】素材矩阵表 + 打法结论 3 条 + 下阶段建议。
✓ 拉取品牌近60天素材并按月对比
✓ 识别主力素材类型与卖点主线
✓ 输出复盘结论与下阶段建议
素材类型角色特征建议
单人口播种草主力痛点开场 + 成分背书维持基本盘
商品展示转化承接直陈卖点 + 价格钩子加大占比
剧情短剧破圈试投场景代入小预算测试

结论:该品牌呈「口播种草 + 商品直给承接」双主力结构,剧情素材为试投位;建议下阶段把商品展示类素材提至与口播同量级。

【角色】你是资深达人 BD 策略顾问。
【目标】为某品牌筛选 5 个可复用的高性价比达人,并输出合作切入点。
【数据源】searchBrands 反查 brandId → searchMaterials 取该品牌近 30 天素材(100 点/条)→ searchKols 的 media 固定传 20(抖音)反查关联达人。
【分析框架】按达人粉丝量级、素材复用条数、内容形式三维度评估性价比。
【约束】只用返回字段、不推算带货 GMV、达人数据以返回值为准。
【输出】达人评估表 + 合作优先级 + 切入话术建议。
✓ 反查品牌近30天素材的关联达人
✓ 按粉丝量级与复用条数评估性价比
✓ 输出达人优先级与合作切入点
达人类型信号切入方式优先级
低粉高复用同品牌素材多条复用直接加投P0
中腰测评类真人测评形式稳定寄样 + 固定脚本P1
头部的成素材量少但曝光高单点合作P2

结论:优先复用「低粉高数据」达人已验证的内容形式,中腰测评达人做规模补充;达人数据以 MCP 返回字段为准,不做 GMV 推算。

【角色】你是资深短视频编导。
【目标】提炼某品类高曝光素材的开场 3 秒钩子话术,输出 5 条可复用模板。
【数据源】filterOptions 取素材标签候选值 → searchMaterials 固定近 30 天、order=impression_inc_2y_desc、limit=100(100 点/条)→ creativeAsr 取 Top 素材口播原文(一次≤100 个 ID)。
【分析框架】按开场类型(直陈痛点 / 价格利益 / 圈定人群 / 效果承诺)归类统计。
【约束】只用返回字段、摘录口播需保留原文、不叠加外部话术库。
【输出】钩子类型分布表 + 5 条原文模板 + 适用场景标注。
✓ 统计高曝光素材的开场钩子分布
✓ 摘录Top素材口播原文作模板
✓ 输出5条可复用话术与适用场景
钩子类型模板结构适用
直陈痛点痛点场景 + 人群点名功效类目
价格利益到手量 + 限时机制标品走量
效果承诺前后对比 + 时间锚护肤 / 大健康

结论:高曝光素材开场以「直陈痛点 + 效果承诺」为主力结构,模板需保留口播原文引用,禁止改写数字与承诺表述。

【角色】你是资深大促投手。
【目标】拆解某品牌双 11(10-14~11-11)的投放节奏,输出蓄水 / 爆发两阶段素材策略对比。
【数据源】searchBrands 反查 brandId → searchMaterials 按蓄水期与爆发期拆 2 次调用,参数一致、order=cnt_ad_id_desc、limit=100(100 点/条)。
【分析框架】按投放量级、素材类型、卖点侧重、关联广告数四维对比两阶段。
【约束】时间窗≤180 天、两阶段参数完全一致、先看 total 估点、不推算消耗金额。
【输出】两阶段对比表 + 节奏结论 + 下次大促排期建议。
✓ 对比蓄水期与爆发期的素材结构
✓ 识别两阶段卖点侧重变化
✓ 输出大促排期建议
阶段素材侧重卖点主线作用
蓄水期口播种草为主成分 / 功效背书建认知池
爆发期商品直给为主价格买赠 + 限时收口转化

结论:大促节奏呈「蓄水种草 → 爆发直给」的素材接力结构,下次大促建议提前 2 周布局种草素材、爆发期首日切换价格钩子。

【角色】你是资深素材拆解分析师。
【目标】拆解某类目 Top 20 爆量视频的完整结构,输出逐段拆解表。
【数据源】filterOptions 确认标签 → searchMaterials 固定近 30 天、order=impression_inc_2y_desc、limit=20 先估 total(100 点/条)→ 对 Top ID 调 creativeAsr 取口播(一次≤100 个 ID)。
【分析框架】按开场 / 中段 / 收尾三段拆解画面形式、口播钩子与卖点位置。
【约束】只用返回字段、口播保留原文、缺字段写「未返回」。
【输出】逐段拆解表 + 结构共性 3 条 + 可复用分镜建议。
✓ 拉取类目Top 20爆量视频
✓ 按开场/中段/收尾逐段拆解
✓ 输出结构共性与分镜建议
段落高共性结构要点
开场 3 秒痛点直陈 + 产品入镜前 3 秒抛核心冲突
中段使用演示 + 成分讲解卖点逐条递进
收尾价格机制 + 行动指令限时利益收口

结论:爆量视频高度收敛于「痛点开场 → 演示讲解 → 价格收口」三段式,建议按此结构做分镜模板并 A/B 开场钩子。

【角色】你是资深内容策略编导。
【目标】梳理某品牌剧情类素材的题材体系与爆量单元,输出剧情选题库。
【数据源】searchBrands 反查 brandId → searchMaterials 按素材标签过滤剧情类、固定近 60 天、order=cnt_ad_id_desc、limit=100(100 点/条)。
【分析框架】按剧情题材(反转 / 情景剧 / 街访 / 短剧续集)、人物设定、卖点植入方式三维归纳。
【约束】只用返回字段、时间窗≤180 天、按条计费先估总量、不改写原始素材标签。
【输出】题材分布表 + 爆量单元拆解 + 选题库 10 条。
✓ 拉取品牌近60天剧情类素材
✓ 归纳题材与人物设定体系
✓ 输出选题库与植入方式建议
题材特点植入方式建议
反转剧情前 3 秒强冲突产品为转折点主力扩充
情景剧家庭 / 职场场景场景化种草稳定更新
街访多人证言口碑背书小批量测试

结论:剧情体系中「反转剧情」承担破圈、情景剧承担种草,建议以卖点植入位置为变量做题材内 A/B,沉淀专属选题库。

06 / 用对 Prompt

把约束写清楚,MCP 才不会跑偏

MCP 用得好不好,取决于三件事——大部分人倒在第三件上。一份写全约束的 Prompt,决定结论质量;把它写具体,Agent 才不会疯狂拉素材、更不会跑偏。

1提问前 · 把角色和约束写清楚

  • 按提问六要素写全:角色 / 目标 / 数据源 / 分析框架 / 约束 / 输出格式
  • filterOptions 同一次对话只调一次,之后复用返回的候选值
  • 品牌、店铺、达人、类目 ID 一律反查,不猜测、不用大类代替细类
  • 「近 30 天」「高曝光」必须换成起止日期 + 排序字段 + 样本上限

2取数时 · 先估算点数再翻页

  • searchMaterials / productSalesRanking / creativeAsr 按返回条数扣点(100 点/条)
  • 固定 startDate / endDate(单次跨度≤180 天)、limit 与 page=1,先看返回 total 估算点数再决定是否翻页
  • 需跨 180 天时拆成多次调用,不要放宽单次跨度;不要写「拉全量」
  • 明确排序字段与样本上限,避免 Agent 自行放大范围

3翻块 ≠ 翻页 · 最容易踩的坑

  • 一次调用可能返回完整 200 条,但被切成多个 TOON 分块(_chunk.hasMore=true)
  • 必须用 getMcpChunk 按 nextChunk 取完所有分块再分析;翻块读缓存、不产生新的取数扣点
  • 把「分块」误判成「分页」继续翻页,曾导致实际拉取约 4000 条素材、理论消耗约 40 万点
  • 只有返回 MCP_CHUNK_EXPIRED(缓存过期)时才重新调用原始工具

4工具权限与数据边界

  • creativeAIAnalysisData(400 点/条)仅策略 Pro / 至尊版,一次最多 100 条,只对 Top 素材使用
  • searchKols 的 media 固定传 20(抖音);productSalesRanking 仅抖店商品榜
  • shopSalesMetrics 只有直播销售额 / 销量 / 新增销量 / 新增销售额四项,不得推导客单价
  • 不引入「推荐算法原理」等外部知识;缺字段写「未返回」,不推算转化率 / GMV
咨询与开通

扫码加微信,咨询有数 MCP 开通

开通申请、点数充值、套餐适配与接入答疑,扫码添加微信即可一对一沟通。

有数 MCP 微信咨询二维码
微信扫码 · 一对一咨询
开通申请 / 点数充值 / 接入答疑
07 / 常见问题

常见问题

关于有数 MCP 的高频疑问,点击对应问题即可查看答案;如仍有疑问,欢迎扫码咨询。

Q什么是有数 MCP?

有数 MCP 是一个基于 Model Context Protocol(模型上下文协议)的服务,将你的 AI Agent 连接有数预处理好的广告素材、创意内容、达人与电商结构化数据情报。

QMCP 和数据定制 API 有什么区别?

API / 数据定制给你原始素材,客户需自行加工;MCP 给你可直接喂给 Agent 的结构化数据。你省下的是算法团队的人力与时间成本。

QMCP 和有数 Skill(youclaw)有什么区别?

youclaw 是 AI 策略分析的个性化入口;MCP 是素材检索、品牌 / 店铺 / 达人 ID 反查、店铺与商品销售指标等 11 个 tools 的深度个性化接入,取数集合由你定义、模型由你选择。

Q哪些客户适合使用 MCP?

对 AI 使用程度深、有自建 Agent 或企业统一使用 WorkBuddy / 千问办公 / Codex,且有批量分析素材、商品、店铺与达人数据需求的客户。合作门槛与 365 保持一致。

Q哪些套餐可以开通 MCP?

策略版 / 策略 Pro 版 / 至尊版可用;其中 10 个 tools 策略版起即可用,仅 creativeAIAnalysisData(素材卖点解析)需策略 Pro / 至尊版。旗舰版 / 旗舰 Pro 版 / 尊享版暂不支持。

Q调用点数怎么算?

素材搜索、商品榜、口播文案按返回条数 100 点/条,素材卖点解析 400 点/条;其余 7 个 tools 100 点/次。按条计费的 tools 翻页拉全量前,建议先估算总条数。

Q为什么看不到画面卖点数据?

素材卖点解析(creativeAIAnalysisData)仅策略 Pro 版 / 至尊版开放,策略版不返回画面卖点数据;策略版客户可改用口播文案 tools(creativeAsr)获取素材文案。

Q时间范围超过 180 天怎么办?

素材搜索的时间窗最大为 180 天,更长周期可拆成多次调用。

Q可以多人同时使用 MCP 吗?

不建议多人同时使用,会有速率限制。分析结果包含平台素材链接,仅登录相应账号的用户可点击查看具体素材。

关于品牌

关于有米有数

有米有数是 AI 驱动的内容电商营销大数据策略平台,隶属有米云,服务抖音 / 快手等新电商品牌方商家、投流操盘手、代运营服务商与创意编导。2022 年上线并成为巨量市场首家千川应用,2024 年注册用户数突破 50 万。

有米云以「用 AI 重新定义营销大数据分析」为品牌主张,围绕 Know What / Know Why / Know How 帮助商家看清异动向、看透爆款逻辑、落地创意迭代,覆盖拓人群、定策略、筛达人、提卖点四大业务场景。

有数 MCP 是有米有数面向 AI Agent 时代推出的数据情报接入服务,让企业把素材拆解、选品、投放复盘的 SOP 沉淀在自己的 Agent 里。