YouTube Channel Stats Extractor について
会社のドメインまたはYouTubeハンドルからチャンネルと公開情報を特定するMCPサーバーです。企業調査やデータ補完向けに、チャンネルID、登録者数、メタデータを1行で返し、字幕取得も指定できますが、現在YouTube側の制限を受けます。
主な機能
- 01ドメインやハンドルからチャンネルを検索
- 02登録者数とチャンネル情報を返却
- 03安定したチャンネルIDと作成日を提供
- 04最近の動画の字幕取得に対応
- 057日間のキャッシュと呼び出し上限
活用シーン
- 01企業レコードにチャンネル情報を追加
- 02登録者数やチャンネル作成日を確認
- 03YouTubeハンドルからチャンネルを検索
- 04最近の動画の字幕取得を依頼
MCP 対応
MCPクライアントに `get_youtube_channel_stats` ツールを提供します。Apify Actorを利用し、`APIFY_TOKEN` が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @mambalabsdev/mcp-youtube-channel-transcript-extractorAPIFY_TOKENシークレットApify API token from https://console.apify.com/account/integrationsローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
1掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| handle | string | いいえ | 任意項目です。@shopify のような YouTube ハンドル、またはチャンネルの完全な URL を指定します。指定すると検出をスキップし、直接そのチャンネルに移動します。 |
| skipCache | boolean | いいえ | "false"(デフォルト)の場合、成功した検索結果は 7 日間キャッシュされ、再利用されます。"true" にすると、強制的に再取得します。Clay との互換性のため、文字列として送信されます。 |
| company_name | string | いいえ | 任意。検索精度が向上します。また、本人確認ゲートでは検出されたプロフィールとの照合に使用するため、指定すると誤一致を減らせます。 |
| company_domain | string | いいえ | 会社のドメインのみを指定します。例:shopify.com。この値または handle を指定してください。ドメインを指定すると actor は完全な検出処理を実行し、handle を指定すると検出をスキップして直接取得します。 |
| includeTranscripts | boolean | いいえ | "true" の場合、チャンネルの最新動画からタイムスタンプ付きの完全な字幕を取得し、動画ごとに1行で返します。デフォルトは "false" です。この actor では字幕取得のコストが高く、多くの利用者はチャンネル統計のみを必要とするためです。Clay との互換性のため、文字列として送信します。 |
| transcriptVideoCount | string | いいえ | 字幕取得が有効な場合,为该チャンネルの最新動画のうち何本から字幕を取得するかを指定します。デフォルトは5です。動画ごとに追加の取得処理と課金対象の字幕イベントが1回発生するため、この値で字幕取得の実行コストが決まります。 |
| includeFollowerCounts | boolean | いいえ | "true"(デフォルト)の場合、プロフィールページを取得して数値を抽出します。"false" にするとプロフィール URL の解決のみを行い、コストを抑えられ、プロキシも不要です。Clay との互換性のため、文字列として送信されます。 |
詳細
YouTube Channel Stats Extractor MCP サーバー
Apify 上の Mamba Labs YouTube Channel Stats Extractor アクター向け MCP サーバーです。
npm パッケージとレジストリエントリーの名前は mcp-youtube-channel-transcript-extractor のままなので、既存のインストールは引き続き動作します。製品名は YouTube Channel Stats Extractor です。
企業ドメインまたは YouTube ハンドルから、そのチャンネルと登録者数およびチャンネルのメタデータを取得します。
機能
企業ドメインまたは YouTube ハンドルから、その企業の YouTube チャンネルを特定します。登録者数、固定の UC チャンネル ID、チャンネル名、作成日、説明を、Clay ですぐに使えるフラットな 1 行として返します。YouTube では、ページ上でも公式 API 上でも、登録者数が約 1,000 人を超えると丸められます。この行には、そのことを示すフラグも含まれます。文字起こしの取得はオプションで利用できますが、現在 YouTube によって制限されています。字幕トラックのリストは読み取れますが、出所を証明するトークンがなければ字幕コンテンツのエンドポイントは空の本文を返します。このため、字幕がない動画としてではなく not_extractable として報告されます。API キーは不要です。読み取り専用です。APIFY_TOKEN が必要で、呼び出しごとに Apify クレジットを消費します。
クイックスタート
以下を MCP クライアントの設定に追加します。
{
"mcpServers": {
"mamba-youtube-channel-stats": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-youtube-channel-transcript-extractor"],
"env": { "APIFY_TOKEN": "your-apify-token" }
}
}
}
前提条件
- Node.js 18 以降
- console.apify.com/account/integrations で取得した Apify API トークン
このアクターはイベントごとの従量課金制で、呼び出しごとに Apify クレジットを消費します。料金については アクターページをご覧ください。
プロンプトの例
- 「stripe.com の YouTube 登録者数はいくつですか?」
- 「hubspot.com の YouTube チャンネル ID を調べてください。」
- 「gitlab.com は YouTube チャンネルを運営していますか? また、いつ作成されましたか?」
ツールと入力
ツール:get_youtube_channel_stats
| 入力 | 型 | 意味 |
|---|---|---|
company_domain | 文字列 | shopify.com のような、会社のドメインのみを指定します。これかハンドルを指定してください。ドメインを指定すると、アクターは完全な検出を実行します。ハンドルを指定すると、すぐに次へ進みます |
company_name | 文字列 | 任意です。検索精度が向上します。また、検出されたプロフィールが一致するかを識別ゲートが確認する際に使用されるため、指定すると誤った一致を減らせます。 |
handle | 文字列 | 任意です。@shopify のような YouTube ハンドル、またはチャンネルの完全な URL を指定します。指定すると検出をスキップし、チャンネルに直接進みます。 |
includeFollowerCounts | ブール値 | 「true」(デフォルト)の場合、プロフィールページを取得して数値を抽出します。「false」に設定すると、プロフィール URL の解決のみを行います。こちらのほうが低コストで、必要な |
skipCache | ブール値 | 「false」(デフォルト)の場合、成功した検索結果は7日間キャッシュされ、再利用されます。「true」に設定すると、最新の情報を取得します。Clay との互換性のため、文字列として送信されます |
includeTranscripts | ブール値 | 「true」の場合、チャンネルの最新動画からタイムスタンプ付きの全文トランスクリプトを取得し、動画ごとに1行として返します。デフォルトは「false」です |
transcriptVideoCount | 文字列 | トランスクリプトを有効にした場合に、チャンネルの最新動画からトランスクリプトを取得する動画の数です。デフォルトは5です。動画ごとに追加の取得が1回発生し、追加の |
max_charge_usd | 数値 | 任意です。この呼び出しの支出上限を米ドルで指定します。アクターは実行額がこの上限を超える料金が発生する前に停止し、すでに課金された行はすべて保持します。 |
出力の読み取り
すべての行には、プラットフォームごとの _status フィールドがあります。まずこのフィールドを確認してください。ステータスの語彙は、Mamba Labs のソーシャルファミリー全体で共通です。
| ステータス | 意味 |
|---|---|
ok | 取得と解析が完了し、値が存在します |
not_found | 検索しましたが、そのプロフィールは存在しません |
not_extractable | プロフィールは存在しますが、値を取得できません |
blocked | プラットフォームに拒否されました。後で再試行する価値があります |
identity_mismatch | 実在するプロフィールが見つかりましたが、別の人物のものです |
skipped | このプラットフォームを指定していません |
false と null は決して同じ意味ではありません。 false は検索した結果、答えが「いいえ」であることを意味します。null は検索できなかったことを意味します。存在感のない企業を絞り込む場合は、false で絞り込んでください。null の行は不在ではなく、不明です。
料金
Apify ではイベントごとに課金され、お支払いはご自身の Apify アカウントに請求されます。2026-10-16 に取得した最新の料金記録に基づく価格は次のとおりです。
| イベント | イベントごとの料金(USD) | 発生条件 |
|---|---|---|
apify-actor-start | $0.00005 | Actor の実行開始時に課金されます。課金されるイベント数は Actor のメモリによって異なります(1 GB あたり 1 イベント、最低 1 イベント)。 |
company-checked | Free プランでは $0.0035、上位の Apify プランでは $0.00245 まで | 検出カスケードが完了し、劣化していないチャネル行が生成された企業ごとに 1 回発生します。チャネルが見つかったかどうかは問いません。劣化した行では発生しません。 |
profile-resolved | Free プランでは $0.0025、上位の Apify プランでは $0.00175 まで | 候補チャネル URL が ID ゲートを通過した企業ごとに 1 回発生します。登録者数のセルが入力されたときではなく、検証処理に対して発生します。 |
follower-count-extracted | Free プランでは $0.0025、上位の Apify プランでは $0.00175 まで | 公開ページから数値の登録者数を取得できたチャネルごとに 1 回発生します。所有者が登録者数を非表示にしている場合は発生せず、not_extractable として報告されます。 |
transcript-extracted | Free プランでは $0.015、上位の Apify プランでは $0.0105 まで | 実際に文字起こしテキストが返された動画ごとに 1 回発生します。字幕トラックのない動画は課金されません。また、字幕トラックが存在していても、YouTube がその内容の提供を拒否した動画も課金されません。文字起こしが無効の場合は発生しません。これは意図的に厳格な扱いです。テキストが得られるかどうかにかかわらず取得にはおよそ 1 セントかかるため、その負担を購入者に負わせるべきではありません。 |
Actor の Apify ページに最新の料金が掲載されています。このサーバーを実行すると Apify クレジットが消費されます。
Actor の完全なドキュメント
apify.com/mambalabs/youtube-channel-transcript-extractor
Mamba Labs GTM Suite
Mamba Labs は、統一されたフラットな Clay 対応の出力規約を共有する GTM エンリッチメント Actor 群を構築しています。そのため、行はクリーニング処理を挟まずに company_domain で結合できます。Actor 群の全容はこちらです:apify.com/mambalabs
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。