ShortsMonkey YouTube Outlier Research

ShortsMonkey MCP

English | 简体中文

ShortsMonkey MCP 是一个只读的远程模型上下文协议服务，用于发现 YouTube 的异常表现视频、查看热门 Shorts 排名，以及分析单个视频的表现。

它让兼容 MCP 的 AI 助手能够访问已存储的 ShortsMonkey 数据，帮助创作者、代理机构、研究人员和内容团队找到订阅者较少但观看量异常高的视频，并以这些案例为依据制定内容决策。

连接到托管服务

远程 Streamable HTTP 端点：

https://mcp.shortsmonkey.com/mcp

在 ShortsMonkey MCP Access 创建一个 smcp_live_... 令牌，然后配置支持远程 Streamable HTTP 和自定义标头的客户端。

Cursor 配置：

{
  "mcpServers": {
    "shortsmonkey-mcp": {
      "url": "https://mcp.shortsmonkey.com/mcp",
      "headers": {
        "Authorization": "Bearer smcp_live_your_token_here"
      }
    }
  }
}

请勿提交令牌，也不要将其放在共享配置中。有关账户、配额和令牌轮换的说明，请参阅完整用户指南。

工具

get_hot_today

返回 ShortsMonkey 当前的当日 YouTube Shorts 热门排行榜，数据来自已存储的数据库快照。

输入	描述
region	可选的地区代码，例如 US、JP、BR 或 IN
tier	S、A、B、C 或 all；默认为 all
limit	1-50 条结果；默认为 20

示例：Find today's 10 hottest YouTube Shorts in the US.

search_outlier_videos

按关键词、细分领域、地区、格式、观看量、订阅者数量和观看量与订阅者数量之比，搜索已存储的异常表现视频快照。

输入	描述
keyword	可选的标题、频道、标签或来源关键词搜索
niche	可选的细分领域或类别文本
videoType	shorts、long 或 all；默认为 all
region	可选的地区代码
maxChannelSubscribers	频道订阅者数量上限
minViews	视频最低观看量
minVsRatio	观看量与订阅者数量之比的下限；默认为 10
timeWindow	24h、3d、7d 或 30d；默认为 7d
limit	1-50 条结果；默认为 20

示例：Find long-form AI videos from the last 7 days with fewer than 50,000 subscribers and a V/S ratio above 20.

analyze_video_url

使用已存储的 ShortsMonkey 表现快照，分析一个 YouTube 视频播放页、Shorts、嵌入式视频或 youtu.be URL。

输入	描述
url	必填的 YouTube 视频 URL

示例：Analyze this YouTube video and explain whether it is an outlier: <URL>

这三个工具均声明了 readOnlyHint: true、destructiveHint: false、idempotentHint: true 和 openWorldHint: false。

返回的数据

根据工具不同，响应可能包含：

• 视频和频道 URL
• 频道订阅者数量和视频观看量
• 观看量与订阅者数量之比以及病毒式传播评分
• Shorts 或长视频分类
• 细分领域、地区、发布时间和快照时间
• 简明的数值说明，解释该结果为何表现异常

数据来自已存储的 ShortsMonkey 快照，可能与 YouTube 当前显示的数据不同。

配额与身份验证

• 身份验证使用 Authorization: Bearer smcp_live_...。
• 试用账户在试用期间可调用 MCP 工具五次。
• 付费账户每天可调用 200 次，并与 ShortsMonkey 网站搜索共用次数。
• 每个账户最多可保留三个有效令牌。
• 默认 HTTP 防护限额为每个令牌每分钟 90 个请求、每个 IP 每分钟 180 个请求。

可通过 MCP Access 创建、轮换和撤销令牌。

健康检查

GET https://mcp.shortsmonkey.com/health
GET https://mcp.shortsmonkey.com/ping
GET https://mcp.shortsmonkey.com/.well-known/mcp/server-card.json

/ping 是为 Glama 托管探测提供的别名。浏览器通过 GET 请求 /mcp 会按设计返回 405 Method Not Allowed，因为 MCP 协议请求使用 POST。 公开的服务卡片仅公开静态 MCP 元数据，以便注册表发现这三个工具，而无需接收用户令牌；调用工具仍需进行身份验证。

架构

MCP client
  -> ShortsMonkey MCP gateway (this repository)
  -> private ShortsMonkey application API
  -> stored YouTube research snapshots

网关通过私有 ShortsMonkey 应用验证账户令牌、应用速率限制、注册 MCP 工具，并将内部 JSON 响应转换为 MCP 文本和结构化内容。

本仓库有意不包含 ShortsMonkey 数据库、账户系统、计费逻辑、内部服务凭据或专有数据查询实现。

开发

要求：

• Node.js 20 或更高版本
• npm
• 获得访问私有 ShortsMonkey 内部 API 的授权

npm ci
cp .env.example .env
npm run dev

本地端点默认为 http://localhost:3001/mcp。健康检查可通过 /health 和 /ping 访问。

运行所有检查：

npm run check

必需的服务端环境变量

变量	用途
SHORTSMONKEY_INTERNAL_API_BASE_URL	ShortsMonkey 应用的基础 URL
SHORTSMONKEY_INTERNAL_SERVICE_TOKEN	私有的服务器到服务器凭据
MCP_ALLOWED_ORIGINS	生产环境中允许的浏览器源，以逗号分隔
MCP_IP_RATE_LIMIT_PER_MINUTE	每个实例的源 IP 请求限制
MCP_TOKEN_RATE_LIMIT_PER_MINUTE	每个实例经过身份验证的主体请求限制

MCP_ALLOW_LEGACY_KEYS 默认处于禁用状态，在常规生产部署中必须保持禁用。

Docker

docker build -t shortsmonkey-mcp .
docker run --rm --env-file .env -p 3001:3001 shortsmonkey-mcp

此镜像以非特权 node 用户身份运行，并包含 /ping 健康检查。

Glama

本仓库包含根目录下的 glama.json、生产 Dockerfile、静态工具架构、注释、测试，以及完整的 Glama 提交清单。

提交用的仓库 URL：

https://github.com/cuilinhao/youtube-mcp

安全

请阅读 SECURITY.md，并将漏洞私下报告至 [email protected]。

源码使用声明

本仓库目前未授予开源许可。发布源码是为了提高透明度并供审查。在将源码用于本仓库贡献之外的用途或进行再分发之前，请联系 [email protected]。