SuperAPI AI 工具集

tubelab-mcp

数据与分析

查看项目

更新于 11-19 04:21

技能介绍

TubeLab MCP 是 TubeLab 的只读 YouTube 公共数据索引层,包含每日更新的突围频道、异常表现视频和热门标题公式,也支持实时读取频道、视频、字幕与评论。该技能本身不是工作流,而是汇总运行工作流技能时积累的成本、使用规则和异常情况;当工具调用失败、返回为空,或不确定该用哪个工具或筛选条件时可查阅。

连接方式:MCP 端点为 https://public-api.tubelab.net/mcp。多数客户端通过 OAuth 连接;Cursor 等 IDE 智能体使用 API key,以 Authorization: Bearer <key> 发送,需要 Pro 或 Team 套餐。各客户端设置见 https://tubelab.net/docs/api/mcp-server。不确定时先调用免费的 get_credits_balance。MCP 从 Starter 套餐起包含;Starter 账户的变现、收入、RPM 和受众字段可能为空。

工具与成本:search_channels(5 credits,按主题和多种筛选找频道,是细分领域发现工具)、search_related_channels(5 credits,找与一个或多个频道相似的频道)、search_outliers(2 credits,找超过自身频道平均表现的视频)、search_related_outliers(2 credits,按标题、视频、缩略图或频道找相似异常视频)、search_trending_formats(1 credit,标题公式及使用统计,仅英文)。get_channel、get_channel_videos、get_channel_shorts、get_video、get_video_transcript、get_video_comments、get_credits_balance 免费。每次调用成本与返回规模无关;短窗口内重复相同请求不重复计费,改动一个筛选即新计费。

标识符与链接:频道工具接受频道 ID(UC...)、URL 或 handle(@name),有 ID 时优先用 ID。视频工具需要 11 位裸视频 ID,从 watch?v=ID、youtu.be/ID、shorts/ID 或 embed/ID 中提取并去掉参数。搜索结果带 id 和 snippet.channelId,不要猜测 ID。报告链接只基于工具数据构建:视频用 https://www.youtube.com/watch?v=<id>,时间点加 &t=<seconds>s(startMs/1000),频道用 https://www.youtube.com/@<handle> 或 /channel/<channelId>。

使用规则:先宽后窄,先做一次宽泛搜索再逐步加筛选;优先设置 publishedAtFrom(month、trimester、semester、year,不用具体日期),结果少时逐步放宽并说明。Content Authenticity 保持开启,classificationQuality: "neutral" 表示 General 及以上,用于细分、异常、创意和标题工作;缩略图相关用 positive(High);不要为扩大结果而降低该筛选。以平均观看比而非原始观看量排序,同时展示两者和频道订阅数。默认语义搜索,query 用同一主题的 1 至 3 种表述。分页用 from(0 基偏移),同一搜索保持相同 seed 和筛选,每页新计费,除非用户要求否则最多两页。排除低质量细分领域时配合 excludeNiche 或 excludeKeyword。收入、RPM、受众字段是模型估算,只能作为区间展示,不得当作事实。少于 5 条结果不构成趋势,应说明并放宽一次,仍少则报告“无信号”。每条频道或视频结论需附频道 handle、视频标题原文、观看量、比例、发布日期和链接。

结果解读:频道搜索命中可按 semantic.niches[] 聚类;中位观看量反映需求,均值受异常值拉高;观看量与订阅数之比大于 1 表示算法向非订阅者推荐;变异系数低于 1 表示观看稳定,高于 1.5 表示少数爆款支撑频道。搜索命中统计来自索引,get_channel 是实时读取,小频道或新频道可能差异较大,应说明所用来源。Niche Finder 默认 subscribersFrom: 1、medianViewsFrom: 1000、videosCountFrom: 2 且无排序;Outliers Finder 默认 viewCountFrom: 5000、type: "video" 且无排序。joinedDateFrom 是频道创建时间,sortBy: "foundAt" 按 TubeLab 首次发现时间排序。无脸频道标记是预测,重要时应查看缩略图。公开 API 会剥离 monetization 内的 sponsored 标记,应读 detections.sponsored.detected。RPM 估算对北美、北欧、西欧、澳新及中高收入受众更可靠。Shorts 频道应配合 contentKind: "short-form" 与 filterBy: "short"。热门格式中 framework 是含 [X] 槽位的模板,pattern 可直接作为 titlePattern 传入 search_outliers。缩略图可用 https://i.ytimg.com/vi/<id>/hqdefault.jpg,报告中用 320 像素的 mqdefault.jpg;已终止频道用 https://cdn.tubelab.net/vi/<id>.jpeg。工具只返回链接,分析前应下载并打开缩略图,无法获取时说明未查看。字幕 30 分钟视频可超 100KB,读钩子时读到 startMs 超过 45000 即停。大响应应逐条获取并解析,不要回显。

已知异常:search_trending_formats 传 language 数组会报错,应省略(默认英文)。search_related_channels 按相似度而非规模排序,大频道可能返回小频道,需加 subscribersFrom。search_outliers 高 viewCountFrom 会带出付费品牌活动,可加 channelMonetizationAdsense: true 或手动移除。search_related_outliers 用标题锚点可能返回跑题结果并忽略部分筛选;search_outliers 的 lexical 模式曾忽略 query,继续花费前应检查相关性。异常搜索的 language 匹配标题语言而非音频。channelVideoCountTo 上限 120,titlePattern 必须含 * 和至少两个字母。频道样本日期约误差一个月,列表顺序可靠,精确日期用 get_video。评论禁用时返回“Failed Dependency”或“No comments found”,应视为无数据;评论可能重复,按作者加文本去重。空结果且 pagination.total: 0 时放宽时间、去掉一个筛选或改写 query,保持质量下限。HTTP 429 是限流,约每窗口 30 次调用且跨会话共享,应等待重置后重试并控制读取节奏。

积分使用:付费搜索用于找候选,免费读取用于理解候选,每个任务 2 至 6 次搜索属正常;搜索出错时先查余额,再用更少筛选重试一次。报告中不展示预算和积分,除非用户询问。完整参数、响应结构、REST 端点、认证、分页和错误码见 https://tubelab.net/docs/skill.md。