KOL 扩展包
创作者搜索、受众、报价与表现
用 KOL 扩展包在抖音和小红书上做明确的创作者研究。
启用并连接
在控制台为你的 Key 启用 KOL。MCP 连接地址加上 packs=kol，核心内容工具仍然可用。每次 KOL 调用单独计价，使用同一个钱包。
当前可用性
抖音 kol_search：因上游供给故障暂时不可用，调用不计费。其他 KOL 操作保持各自标注的可用状态。
抖音 kol_profile：因上游供给故障暂时不可用，调用不计费。其他 KOL 操作保持各自标注的可用状态。
选定创作者后继续
用 platform=douyin 或 xiaohongshu 和 query 调用 kol_search。把结果的 id 复制到 user，用于 kol_profile、kol_audience、kol_pricing 或 kol_performance。如需核心的 user_profile 或 user_posts，请使用返回的主页链接，不要根据昵称猜测。
搜索返回一个原生页。下一页请带上 page.cursor 并保持参数不变。小红书的稀疏页或空页仍可能有后续。动态筛选值必须来自经过核实的平台选项。
搜索前先查筛选值
用 platform 和 operation=kol_search 调用 capabilities，可列出可用的筛选字段；再加上 field 和可选的 query 查找选项。每个条目给出 label 和 filters，请有意识地合并到下一次 kol_search 输入中。查找免费，不会发起搜索或供应商请求。
继续查看时，用相同的 catalog_version 和 query 传入 next_offset。如果目录版本变了，从 offset 0 重新开始。响应里的 observed_at 表示这是一个已发布快照，不保证每个选项仍能匹配到创作者。付费调用前请检查 search_available。部分字典尚未映射；活动列表为空表示没有已发布的选项。
HTTP 需要 capabilities 和 kol 两个权限。MCP 还需要 packs=kol，并且该平台没有被这条连接排除。添加 URL 设置不会授予权限。
{
"platform": "xiaohongshu",
"operation": "kol_search",
"field": "blogger.content_tag",
"query": "美妆"
}带着限制读受众数据
kol_audience 默认 population=followers。抖音还支持 population=audience，但源端没有说明这一人群的统计口径，不要把它理解为视频观众或触达人数。小红书只支持粉丝。
抖音返回原生分桶数量；小红书返回 0 到 1 的比例。分母和覆盖范围未说明。源数据日期保留原生精度，可能缺失；获取时间不是统计窗口。
读取公开的合作报价
kol_pricing 返回 profile_card，报价按内容形式放在 platform_extra.quotes 中，金额为每条内容的人民币价格。缺失、为 0 或隐藏的金额表示不可得，不是免费。抖音提供已核实的 21–60 秒和 60 秒以上字段，1–20 秒报价不可得；小红书提供图文和视频两种形式。
公开报价不保证可以预约，也不含最终税费和平台费用，报价生效日期不可得。失败调用不扣费；确认的空结果按公开价格计费。HTTP 参数相同时复用幂等键，会重放原始结果和价格。
读取内容表现
kol_performance 读取一位创作者在一个时间窗口内的数据：time_range_days=30（默认）或 90。小红书还接受 scope=daily|sponsored、content_type=all|image|video 和 traffic=all|organic，默认分别为 daily、all、all；抖音不接受这些筛选。每次调用发起一次供应商请求，没有翻页。
返回的 profile_card 使用固定的表现卡标题，不是创作者昵称。请结合 statistic、unit 和 source_field 读取 platform_extra.metrics。均值和中位数是不同的统计量。native_units_unspecified 的数值不是经过核实的次数、百分比或秒数，不要换算，也不要跨平台比较。缺失的指标表示不可得，不是 0。
sample_counts 描述源端的总体；小红书的 samples 只包含源端选取的笔记。返回日期使用精确到天的 published_on，只有源端标记可访问时才提供链接。窗口的确切边界和数据更新时间不可得。创作者通过请求回显绑定，业务数据中没有独立的身份确认。确认的空结果计费，失败免费。
研究关键词需求
keyword_index 属于 KOL 扩展包。使用 platform=xiaohongshu、query 和 mode=overview|daily|related（默认 overview）。每种模式都是一次单独计费的调用。抖音关键词数据暂不可用，返回 not_supported 且不扣费。相关词不会被自动查询。
每种模式返回一个 item，platform_extra.card_type=keyword_index。overview 提供指标和源端创作者分布；change_30d_percent 是带符号的周期对比。搜索指数不是搜索次数。数值为 0 不代表需求为 0，也不代表统计完整。创作者分桶可能重叠、合计不一定为 100%；价格带单位未经核实。
daily 的数据点保留源端日历日期和缺失值，不补空、不臆造时区。窗口由源端选择；observed_start 和 observed_end 是返回的边界，不是日期筛选。related 保留搜索前后方向和可用的源端排名。下结论前请先比较指标单位和限制。确认的空结果计费，失败免费。
{
"platform": "xiaohongshu",
"query": "coffee",
"mode": "daily"
}| 平台 | 操作 | Credits |
|---|---|---|
| 小红书 | kol_search | 2.9 |
| 小红书 | kol_profile | 2.9 |
| 小红书 | kol_audience | 2.9 |
| 小红书 | kol_pricing | 2.9 |
| 小红书 | kol_performance | 2.9 |
| 小红书 | keyword_index | 2.9 |
| 抖音 | kol_search | 已暂停 · 不扣费 |
| 抖音 | kol_profile | 已暂停 · 不扣费 |
| 抖音 | kol_audience | 0.3 |
| 抖音 | kol_pricing | 0.3 |
| 抖音 | kol_performance | 0.2 |