youtube-shorts

YouTube Shorts MCP サーバー

レジストリ名：io.github.johnisanerd/youtube-shorts。AlphaOSINT（Apify 開発者 johnvc、GitHub johnisanerd）がメンテナンスしています。

機能

チャンネルの Shorts を一覧表示するか、指定した Short のリンクを取得します。再生数、いいね数、コメント数、公開日時、再生時間、ハッシュタグ、チャンネル統計を取得し、日付で並べ替え、絞り込みます。

使用する場面

チャンネルのショート動画のパフォーマンスを確認する場合に使用します。クリエイター分析、トレンド調査、競合コンテンツの追跡に活用できます。

仕組み

このサーバーは Apify のホスト型 MCP エンドポイントで動作するため、インストールやホスティングは不要です。URL で ?tools=johnvc/youtube-shorts-api を指定し、1 つの Actor に固定すると、エージェントは Actor の型付き入力スキーマをパラメーターとして持つ単一のツール johnvc--youtube-shorts-api を利用できます。エージェントは Actor を事前に検索せずにこのツールを直接呼び出すことができ、このサーバーを通じてほかの Actor を起動することはできません。Apify Store 全体にアクセスするには、tools パラメーターを指定せずに https://mcp.apify.com を使用してください。

料金

ツールを呼び出すたびに、Apify Actor johnvc/youtube-shorts-api がご自身の Apify アカウントで実行され、Actor の料金に基づいて課金されます。

課金項目	料金（USD）	対象
Short	$0.00001	データセットに返された YouTube Short ごとに課金されます（1 行に動画指標とチャンネル統計を含みます）。エラー行、空のチャンネル、スキップされた項目は課金対象外です。
日付フィルター	$0.00001	返された Short ごとに追加で少額が課金されます。oldestPostDate が設定されている場合にのみ適用されます。

2026-11-13 時点の無料プランの料金です。有料 Apify プランではイベントごとの料金がさらに安くなります。また、Apify では実行の開始と保存された行に対してトークン料金（$0.00001、$0.00001）も課金されます。最新の料金は Actor のページをご覧ください：https://apify.com/johnvc/youtube-shorts-api

エンドポイント

• トランスポート：Streamable HTTP
• URL：https://mcp.apify.com/?tools=johnvc/youtube-shorts-api
• 認証：Apify OAuth（初回使用時に表示）、またはヘッダー Authorization: Bearer <APIFY_TOKEN>（Apify Console → Settings → API & Integrations）

セットアップ

Claude Code

claude mcp add --transport http youtube-shorts "https://mcp.apify.com/?tools=johnvc/youtube-shorts-api"

VS Code（.vscode/mcp.json）

{
  "servers": {
    "youtube-shorts": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=johnvc/youtube-shorts-api"
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "youtube-shorts": {
      "url": "https://mcp.apify.com/?tools=johnvc/youtube-shorts-api"
    }
  }
}

Claude Desktop：Settings → Connectors → Add custom connector を選択し、URL を貼り付けます。リモートコネクターに対応していない古いバージョンでは、claude_desktop_config.json で mcp-remote を介して接続できます。

{
  "mcpServers": {
    "youtube-shorts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=johnvc/youtube-shorts-api"
      ]
    }
  }
}

ツール

ツール	機能
johnvc--youtube-shorts-api	以下のパラメーターで Actor を実行し、結果の行を返します。
get-actor-run	ツールが開始した実行のステータスを確認します（実行時間が長い場合）。
get-dataset-items	インラインの結果に収まらない場合に、実行結果全体をページごとに取得します。
get-key-value-store-record	実行によって保存されたレコードを読み取ります。
abort-actor-run	実行を停止します。

Apify のエンドポイントは、Actor ツールが読み込まれるたびに 4 つの補助ツールを追加します。

johnvc--youtube-shorts-api のパラメーター

パラメーター	型	必須	デフォルト	説明
channels	array		["siliconimist"]	Shorts を取得する YouTube チャンネルのリストです。ハンドル（@ の有無は問いません。例：siliconimist、@MrBeast）、チャンネル URL（https://www.youtube.com/@nasa）、またはチャンネル ID（UC...）を指定します。各チャンネルから最大 maxResultsShorts 件の S… を取得します。
startUrls	array			個別の YouTube Short または動画のリンクを貼り付けると、その項目だけを取得します（https://www.youtube.com/shorts/、watch?v=、または youtu.be/）。省略可能で、channels と自由に組み合わせられます。1 回の実行につき最大 200 件のリンクを指定できます。日付フィ…
maxResultsShorts	integer		10	各チャンネルから返す Shorts の数を制限します（1～500）。合計 1,000 件に達すると実行を停止します。
sortChannelShortsBy	string: NEWEST, POPULAR, OLDEST			チャンネルの Shorts タブの並び順を選択します：NEWEST（デフォルト）、POPULAR、または OLDEST。チャンネルページにある 3 つの並べ替えボタンに対応します。oldestPostDate が設定されている場合は無視され、NEWEST に固定されます。
oldestPostDate	string			この日付以降に公開された Shorts のみを返します。絶対日付（2025-06-03）または 7 days、2 weeks、3 months のような相対期間を指定します。設定すると NEWEST 順に固定され、最初の古い Sh… で一覧を停止できます。

例

自然な言葉でエージェントに依頼するか、次のような引数を指定して johnvc--youtube-shorts-api を呼び出します。

{
  "channels": [
    "siliconimist"
  ],
  "maxResultsShorts": 10
}

出力

次のフィールドを含む JSON 行：

フィールド	型	説明
title	string	Shortのタイトルです。
translatedTitle	string	翻訳タイトル用に予約されています。このバージョンではnullです。
translatedText	string	翻訳された説明用に予約されています。このバージョンではnullです。
type	string: shorts, None	コンテンツの種類です。Shortの行では常にshortsです。
id	string	ShortのYouTube動画IDです。
url	string	正規のShort URLです。
thumbnailUrl	string	利用可能な最大サイズのサムネイル画像です。
viewCount	integer	取得時点の正確な再生回数です。
date	string	ISO 8601 UTC形式の公開日時です。まれにYouTubeが正確な時刻を開示しない場合のみ、日付の精度（YYYY-MM-DD）になります。
likes	integer	取得時点の正確ないいね数です。
location	string	クリエイターが設定した場合にShortに付与される場所です。通常はnullです。
channelName	string	Shortを公開したチャンネルの表示名です。
channelUrl	string	正規のチャンネルURL（チャンネルID形式）です。
channelId	string	YouTubeチャンネルID（UC...）です。
collaborators	array	Shortでコラボレーションしているチャンネルです。該当がない場合は空です。
channelUsername	string	@記号を除いたチャンネルハンドルです。
channelDescription	string	チャンネルの概要テキストです。
channelJoinedDate	string	YouTubeに表示されるチャンネルの作成日です。
channelDescriptionLinks	array	チャンネルの概要セクションにあるリンクを、{text, url}オブジェクトとして示します。
channelLocation	string	チャンネルが概要セクションに記載している国です。
channelAvatarUrl	string	チャンネルのプロフィール画像URLです。
channelBannerUrl	string	チャンネルのバナー画像URLです。
channelTotalVideos	integer	チャンネルの動画総数です。
channelTotalViews	integer	チャンネル全体の再生回数です。
numberOfSubscribers	integer	登録者数です。1,000未満は正確な数、それ以上はYouTubeの丸められた数値から解析されます（15.1M = 15100000）。
isChannelVerified	boolean	チャンネルに認証済みバッジが表示されているかどうかです。
inputChannelUrl	string	指定されたチャンネルの正規化済みURLです。
isAgeRestricted	boolean	YouTubeがShortを年齢制限付きとしているかどうかです。
aboutChannelInfo	object	利便性のため、チャンネルの全フィールドを1つのオブジェクトにまとめたものです。
duration	string	長さをHH:MM:SS形式で示します。
commentsCount	integer	コメント数です。1,000未満は正確な数、それ以上はYouTubeの丸められた数値から解析されます（11K = 11000）。コメントがオフの場合はnullです。
text	string	Shortの説明全文です。
descriptionLinks	array	説明内で見つかったURLを{url, text}オブジェクトとして示します。
subtitles	array	予約済みです。このバージョンではnullです。字幕にはYouTube Transcripts APIを使用してください。
order	integer	チャンネルの返却リストにおけるShortの位置を示す0始まりの番号です。
commentsTurnedOff	boolean	クリエイターがShortのコメントを無効にしている場合はTrueです。
fromYTUrl	string	Shortの読み取り元となったYouTubeページです。チャンネルのShortsタブ、または直接リンクの場合はShort自体のリンクです。
isMonetized	boolean	予約済みです。YouTubeは収益化情報を公開していないため、これはnullです。
hashtags	array	タイトルと説明に含まれるハッシュタグです。#記号を含みます。
tags	array	クリエイターの動画キーワード（YouTube Studioで設定されたタグ）です。YouTubeが返す順序で、#記号なしで示します。クリエイターが設定していない場合は空のリストです。ドロップイン互換の契約には含まれず、既存のパイプライン…に影響しない追加キーです。
isMembersOnly	boolean	Shortがチャンネルメンバー限定の場合はTrueです。
input	string	この行を生成した入力値（チャンネルまたはリンク）そのものです。
fromChannelListPage	string	行がチャンネルのShortsタブから取得された場合はshorts、直接リンクの場合はnullです。
error	string	エラー行にのみ存在します。値はCHANNEL_DOES_NOT_EXIST、CHANNEL_HAS_NO_SHORTS、DATE_FILTER_TOO_STRICT、VIDEO_UNAVAILABLE、AGE_RESTRICTED、INVALID_INPUT、NO_RESULTS、YOUTUBE_BLOCKED、またはINPUT_TRUNCATEDです。エラー行は決して…
note	string	エラー行の人が読める説明です。

データソースと利用規約

スクレイピングで収集した、YouTube の公開チャンネルページおよび Shorts ページのデータです。サーバーは、呼び出し時点で公開されているデータを返します。ソースの利用規約および適用される法律に従って使用する責任は、お客様にあります。AlphaOSINT はソースと提携していません。

リンク

• Apify のアクター：https://apify.com/johnvc/youtube-shorts-api
• ドキュメントページ：https://alphaosint.com/mcp/youtube-shorts/
• すべての AlphaOSINT MCP サーバー：インデックス