mcp-youtube-video-channel-scraper

YouTube Channel and Video List Scraper MCP Server

An MCP server for the Mamba Labs YouTube Channel and Video List Scraper actor on Apify. Scrape public YouTube channels, playlists, and search lists as flat rows.

What's Inside

• What it does
• Quick start
• Prerequisites
• Example prompts
• Tool
• Inputs
• Pricing
• Full actor documentation
• License

What it does

Give YouTube channels, playlists, or search terms. You get a row per video, with title, rounded views, relative date, and length, a row per channel with subscribers, total views, and links, and a free report per source that says whether its list was read to the end.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-youtube-video-channel-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-youtube-video-channel-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The scrape_youtube_videos_channels tool appears.

Prerequisites

• Node.js 18 or newer.
• An Apify API token from console.apify.com/account/integrations, set as APIFY_TOKEN. The server lists its tool without a token; a call needs one.

Example prompts

• "List the last 20 videos from the NASA channel with their views."
• "Search YouTube for home espresso and give me the top 10 videos."
• "How many subscribers does Veritasium have, and what links does the channel publish?"

Tool

scrape_youtube_videos_channels. One tool. Example arguments:

{
  "urls": [
    "https://www.youtube.com/@NASA"
  ],
  "max_videos_per_source": 5
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

Input	Type	Required	Description
urls	array	no	Channel, @handle, playlist, or search result addresses, or a bare channel ID or @handle. Up to 200 sources a run, counted with search terms. A single video address returns one free row: this actor does not open video pages. Clay users: wrap a column in a one item list.
search_terms	array	no	Terms to search on YouTube. Each term returns videos in YouTube's order, for a logged out US visitor. Clay users: wrap a column in a one item list.
max_videos_per_source	number	no	Per channel, playlist, or search term. Default 30, maximum 5000. Set 0 on a channel to get only its channel row.
include_channel_row	boolean	no	yes (default) adds one row per channel source with subscribers, total views, video count, joined date, country, and links. no skips it.
channel_tab	string	no	Which channel list to read: videos (default), shorts, or streams.
max_charge_usd	string	no	Optional. The run stops before a charge that would pass this amount. Reports are always delivered.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event	Free plan	Bronze	Silver	Gold
video-row, one video from a list: title, rounded views, relative date, and length	$0.0012	$0.00114	$0.00108	$0.00102
channel-row, one channel	$0.001	$0.00095	$0.0009	$0.00085
apify-actor-start, per run start	$0.0025	$0.0025	$0.0025	$0.0025

Source reports, refused pages, and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/youtube-video-channel-scraper

License

MIT. See LICENSE.