# YouTube Search MCP Server — Video Search for AI (`longanimous_bracken/youtube-search-scraper`) Actor MCP Server for YouTube search. Search videos by keyword across regions. AI-agent ready — returns title, channel, views, duration, and publish date. - **URL**: https://apify.com/longanimous\_bracken/youtube-search-scraper.md - **Developed by:** [petteri mähönen](https://apify.com/longanimous_bracken) (community) - **Categories:** Videos, Social media, MCP servers - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## YouTube Search MCP Server — Video Search for AI Agents Search **YouTube** videos by keyword across multiple regions. Extract video title, channel, views, duration, publish date, and thumbnails. ### 🧠 MCP Server — AI Agent Ready This actor is a **Model Context Protocol (MCP) server** — AI assistants can call it directly to find YouTube videos: ```json { "searchQuery": "node.js tutorial", "maxResults": 10, "language": "en" } ```` Returns structured video data: title, channel, views, duration, publish date — perfect for **content research**, **video monitoring**, and **AI media pipelines**. ### Features - **21 countries** — US, UK, FR, DE, ES, IT, BR, JP, KR, IN, RU, CA, AU, MX, AR, SE, FI, DK, NO, NL, PL - **16 interface languages** — English, French, German, Spanish, Italian, Portuguese, Japanese, Korean, Hindi, Russian, and more - **12 output fields** — videoId, title, url, length, views, channel, channelId, published, description, thumbnail, badges, country - **CheerioCrawler** — extracts `ytInitialData` JSON from page HTML, 256MB RAM, ~1s per query - **No proxy needed** — standard User-Agent works - **No API key needed** — works from the public search page ### Quick Start #### Search tutorials ```json { "searchQuery": "node js tutorial", "maxResults": 20, "countryCode": "US", "language": "en" } ``` #### Search music in German ```json { "searchQuery": "pop musik 2026", "maxResults": 10, "countryCode": "DE", "language": "de" } ``` #### Search Finnish content ```json { "searchQuery": "suomi", "maxResults": 5, "countryCode": "FI", "language": "fi" } ``` ### Input Parameters | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchQuery` | string | `"node js tutorial"` | Search term | | `maxResults` | integer | `20` | Max videos to return (max 100) | | `countryCode` | select | `US` | Content region (21 countries) | | `language` | select | `en` | Interface language (16 languages) | ### Output Fields | Field | Type | Description | |-------|------|-------------| | `videoId` | string | YouTube video ID | | `title` | string | Video title | | `url` | string | Full watch URL (`youtube.com/watch?v=...`) | | `length` | string | Duration (e.g., "12:34", "1:05:20") | | `views` | string | View count text (e.g., "2,155,030 views") | | `channel` | string | Channel name | | `channelId` | string | Channel URL | | `published` | string | Relative publish time (e.g., "6 years ago") | | `description` | string | Video description snippet | | `thumbnail` | string | Thumbnail image URL (highest quality) | | `badges` | string | Badges (e.g., "4K", "CC", "LIVE") | | `searchQuery` | string | Original search term | | `country` | string | Country code searched | | `scrapedAt` | string | Timestamp of scrape | ### Use Cases - **Content research** — find trending videos by topic across 21 regions - **Video SEO** — analyze titles, descriptions, and thumbnails of top results - **Channel discovery** — find creators and channels in specific niches - **Market analysis** — compare video performance across countries - **Content aggregation** — build video feeds and playlists ### Pricing **$1.50 / 1,000 results** — pay only for what you scrape. No monthly subscription. ### Changelog | Version | Date | Changes | |---------|------|---------| | 0.0.1 | 2026-07-24 | Initial build — CheerioCrawler, ytInitialData extraction, 21 countries, 16 languages | ### Support - [Open an issue](https://apify.com/longanimous_bracken/youtube-search-scraper/issues) for bugs or feature requests - [Leave a review](https://apify.com/longanimous_bracken/youtube-search-scraper) — it helps others discover the tool # Actor input Schema ## `searchQuery` (type: `string`): Search term (e.g., 'node js tutorial', 'cats', 'music 2026') ## `maxResults` (type: `integer`): Maximum number of videos to return (max 100) ## `countryCode` (type: `string`): YouTube content region ## `language` (type: `string`): YouTube interface language ## Actor input object example ```json { "searchQuery": "node js tutorial", "maxResults": 20, "countryCode": "US", "language": "en" } ``` # Actor output Schema ## `videos` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "node js tutorial" }; // Run the Actor and wait for it to finish const run = await client.actor("longanimous_bracken/youtube-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "node js tutorial" } # Run the Actor and wait for it to finish run = client.actor("longanimous_bracken/youtube-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "node js tutorial" }' | apify call longanimous_bracken/youtube-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=longanimous_bracken/youtube-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Search MCP Server — Video Search for AI", "description": "MCP Server for YouTube search. Search videos by keyword across regions. AI-agent ready — returns title, channel, views, duration, and publish date.", "version": "0.0", "x-build-id": "tG2NT7n1cMxxSoWjx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/longanimous_bracken~youtube-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-longanimous_bracken-youtube-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/longanimous_bracken~youtube-search-scraper/runs": { "post": { "operationId": "runs-sync-longanimous_bracken-youtube-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/longanimous_bracken~youtube-search-scraper/run-sync": { "post": { "operationId": "run-sync-longanimous_bracken-youtube-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term (e.g., 'node js tutorial', 'cats', 'music 2026')" }, "maxResults": { "title": "Max Results", "type": "integer", "description": "Maximum number of videos to return (max 100)", "default": 20 }, "countryCode": { "title": "Country", "enum": [ "US", "GB", "FR", "DE", "ES", "IT", "BR", "JP", "KR", "IN", "RU", "CA", "AU", "MX", "AR", "SE", "FI", "DK", "NO", "NL", "PL" ], "type": "string", "description": "YouTube content region", "default": "US" }, "language": { "title": "Interface Language", "enum": [ "en", "fr", "de", "es", "it", "pt", "ja", "ko", "hi", "ru", "sv", "fi", "da", "nb", "nl", "pl" ], "type": "string", "description": "YouTube interface language", "default": "en" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```