ShortsMonkey YouTube Outlier Research

ShortsMonkey MCP

英語 | 简体中文

ShortsMonkey MCP は、YouTube の異常値動画の発見、急上昇中の Shorts のランキング、個別動画のパフォーマンス分析に対応する、読み取り専用のリモート Model Context Protocol サーバーです。

保存された ShortsMonkey のデータに、MCP 対応の AI アシスタントからアクセスできるようになります。クリエイター、代理店、研究者、コンテンツチームは、登録者数に対して再生回数が異常に多い動画を見つけ、その事例を調査に基づくコンテンツの意思決定に活用できます。

ホスト型サーバーに接続する

リモート 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 件です

例：米国で今日最も人気のある YouTube Shorts を10件探してください。

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 件です

例：過去7日間の、登録者数が50,000人未満で V/S 比率が20を超える長尺 AI 動画を探してください。

analyze_video_url

保存された ShortsMonkey のパフォーマンススナップショットを使って、YouTube の視聴ページ、Shorts、埋め込み、または youtu.be の URL を1件分析します。

入力	説明
url	必須の YouTube 動画 URL

例：この YouTube 動画を分析し、異常値かどうか説明してください：<URL>

3つのツールすべてに、readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: false が設定されています。

返されるデータ

ツールに応じて、次の情報がレスポンスに含まれます。

• 動画とチャンネルの URL
• チャンネル登録者数と動画の再生回数
• 再生回数と登録者数の比率、およびバイラルスコア
• Shorts または長尺動画の分類
• ニッチ、地域、公開時刻、スナップショットの時刻
• 結果が異常値である理由を数値で簡潔に説明した情報

値は保存された ShortsMonkey のスナップショットに基づいており、YouTube に現在表示されている数値とは異なる場合があります。

クォータと認証

• 認証には Authorization: Bearer smcp_live_... を使用します。
• トライアルアカウントでは、トライアル期間中に MCP ツールを5回呼び出せます。
• 有料アカウントでは、ShortsMonkey ウェブサイトでの検索と共有される、1日あたり200回の呼び出しが利用できます。
• 各アカウントで有効なトークンを最大3つ保持できます。
• 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 のホスティングプローブ用に提供されるエイリアスです。ブラウザーから /mcp に GET すると、MCP プロトコルのリクエストでは POST を使用するため、設計上 405 Method Not Allowed が返されます。 公開サーバーカードでは静的な MCP メタデータのみを公開するため、レジストリはユーザートークンを受け取ることなく 3 つのツールを検出できます。ツールの呼び出しには引き続き認証が必要です。

アーキテクチャ

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] までお問い合わせください。