用途:通过 KeyAPI MCP 服务对 YouTube 频道做发现与分析,覆盖频道身份解析、元数据获取、视频库枚举、频道搜索与高级筛选发现。
主要能力:get_channel_description 获取完整频道元数据(两步:先传 channel_id 得基础信息与 continuation_token,再传该 token 得加入时间、社交链接、总观看量等);get_channel_id_from_url 将 @用户名、/channel/、/c/、/user/ 等 URL 转为频道 ID;get_channel_url_from_channel_id 反向由 ID 得 @句柄;get_channel_id 按频道名解析 ID;get_channel_videos 分页列出视频(需 UC 格式 ID);search_channels 仅返回频道类结果;search_channel 在指定频道内按关键词搜索;general_search_with_filters 按上传时间、时长、内容类型、特性、排序筛选;get_search_suggestions 获取 10–20 条搜索建议。
使用方式:需 KEYAPI_TOKEN 环境变量与 Node.js v18+,在技能目录执行 npm install 安装 @modelcontextprotocol/sdk。MCP 服务器为 https://mcp.keyapi.ai/youtube/mcp,认证头 Authorization: Bearer $KEYAPI_TOKEN。验证连接:node scripts/run.js --platform youtube --list-tools;查看参数:node scripts/run.js --platform youtube --schema <tool_name>;调用:node scripts/run.js --platform youtube --tool <tool_name> --params '<json_args>' --pretty,加 --no-cache 可跳过缓存。缓存位于 .keyapi-cache/YYYY-MM-DD/<tool>/。
适用场景:频道审计、视频内容盘点与更新频率分析、URL/ID/句柄互转、关键词频道发现、站内与站外搜索、关键词研究与自动补全。
限制:get_channel_videos 与 get_channel_description 需 UC 格式 ID;get_channel_description 必须顺序调用两次,不可同时发起;get_channel_videos 参数名存在尾随空格写法但两种均可用;需检查 code=0 为成功,500 可间隔 2–3 秒重试至多 3 次,429 需等待 60 秒,401/403/404 分别对应令牌、配额与资源问题。收费与价格信息暂未提供。