在达人研究与社交聆听 Skills 中使用 TikTok、Instagram 和 YouTube 公开记录——先走 MCP，产品化时再用 HTTP。

一句话概括：本食谱写给处于实现阶段的读者——他们需要 TikTok、Instagram 与 YouTube 记录来做创作者调研或社交聆听，又不想搭三套集成。

UnifAPI 通过一套共享的 MCP 与 HTTP 接口对外提供 TikTok、Instagram 与 YouTube 公开数据，以 $0.001 积分计费。本指南梳理通用原语、分页与成本算法，让一个 agent 无需自定义 GUI 就能运行创作者调研与社交聆听 Skills。

大多数面向消费者的公开数据工作流——品牌监测、创作者调研、产品发布分析、趋势检测——最终都落到同样这三个平台上：TikTok 用于短视频，Instagram 用于视觉社交，YouTube 用于长视频。从这三家搭出一条稳定的数据流，过去往往意味着三份供应商合同和三种不同的封装。换成 UnifAPI，就是一个 MCP 服务器、一套贯穿全部的形态。

你实际需要哪些端点

对大多数 agent 工作流来说，每个平台三个原语就够了：按关键词或话题标签搜索、按 ID 获取单条帖子或视频，以及列出某位创作者的近期帖子。其余的一切——评论、相关帖子、粉丝背景——都是辅助细节，agent 在拿到主集合后可以再扇出去取。

在 UnifAPI 上，这些对应于：TikTok——/tiktok/search、/tiktok/videos/{id}、/tiktok/users/{id}/videos。YouTube——/youtube/search、/youtube/videos/{video_id}、/youtube/channels/{channel_id}/videos。Instagram——/instagram/search、/instagram/posts/{shortcode}、/instagram/users/{username}/posts。命名有意在各平台之间对齐，这样学会了一个平台的 agent 提示词，就同时学会了全部三个。

统一的请求形态

每个 HTTP 端点都接受相同的 Authorization: Bearer <key> 请求头，并返回相同的外层封装：{ request_id, data, pagination?, billing }。data 内部的字段是平台专属的（TikTok 视频有话题标签列表，YouTube 视频有频道元数据），但围绕它的形态是一致的。

这种一致性比听起来更重要。它意味着你 agent 的工具调用循环只有一套重试策略、一个分页处理器、一个错误封装——而不是三套。平台专属的知识留在 data 字段内部，模型在那里能看见它。

跨三个平台的分页

每个平台分页方式各异——TikTok 用 cursor 令牌，YouTube 用 pageToken，Instagram 用 end_cursor。UnifAPI 把这些信号归一化为单个 { cursor, has_more } 对象。你的 agent 循环读取 cursor，在下一次调用时把它作为 cursor 查询参数传回，并在 has_more 翻转为 false 时停下。

每个平台的默认页面大小都是 20 条记录，上限是 50。对大多数 agent 运行来说，一页就足够了——模型很少需要超过前 20 条命中就能做出决策。

估算每次 agent 运行的成本

成本是记录数 × $0.001。一次"监测我们品牌本周在 TikTok 上的提及"的运行，拉取 20 条搜索结果，再扇出去取 5 条单独视频以获得字幕，就是 25 条记录——$0.025。一次"对这个账号做创作者调研"的运行，拉取 50 条近期帖子与 10 条视频详情，就是 60 条记录——$0.06。

一条对我们很管用的粗估法则：典型调研工作流按每次 agent 运行 $0.05 编预算，深度挖掘按 $0.20。首充一次性赠送的 2,000 积分本身就足够大约四十次轻量运行。

把它们拼起来

一个端到端的"找出我们本周在这三个平台上最热门的话题"的 agent 长这样：用品牌关键词并行调用 /tiktok/search、/instagram/search、/youtube/search；从每个平台收集前 10 条；对每个平台的前 3 条，扇出到 /tiktok/videos/{id}、/instagram/posts/{shortcode} 或 /youtube/videos/{video_id} 取完整字幕或文案；把全部内容连同一段概括提示词交给模型。

总成本：30 条搜索记录 + 9 次详情查询 = 45 积分，$0.045——其中 3 次 Instagram 帖子查询各按 OpenAPI 契约公布的每次调用最低 3 积分计费。集成总数：一个。这就是卖点——从一个 Skill 起步，连接位于 https://mcp.unifapi.com 的 MCP 服务器，仅当工具调用与工作空间积分需要 OAuth 时才登录。

接下来读什么

用 MCP 运行一个 KOL 定价 agent - 把这些平台用作创作者定价的补充信息。

统一响应封装 - 解释多平台响应如何保持可比。

API 目录 - 列出实时的平台操作。