search-videos

Search YouTube videos with advanced filters like channel, duration, publish date, quality, and more. Customize results by relevancy, view count, or date. Retrieve up to 50 videos per search.

Instructions

Search for YouTube videos with advanced filtering options. Supports parameters: - query: Search term (required) - maxResults: Number of results to return (1-50) - channelId: Filter by specific channel - order: Sort by date, rating, viewCount, relevance, title - type: Filter by resource type (video, channel, playlist) - videoDuration: Filter by length (short: <4min, medium: 4-20min, long: >20min) - publishedAfter/publishedBefore: Filter by publish date (ISO format) - videoCaption: Filter by caption availability - videoDefinition: Filter by quality (standard/high) - regionCode: Filter by country (ISO country code)

Input Schema

Name	Required	Description	Default
`channelId`	No
`maxResults`	No
`order`	No
`publishedAfter`	No
`publishedBefore`	No
`query`	Yes
`regionCode`	No
`type`	No
`videoCaption`	No
`videoDefinition`	No
`videoDuration`	No

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "channelId": {
      "type": "string"
    },
    "maxResults": {
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "order": {
      "enum": [
        "date",
        "rating",
        "relevance",
        "title",
        "videoCount",
        "viewCount"
      ],
      "type": "string"
    },
    "publishedAfter": {
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$",
      "type": "string"
    },
    "publishedBefore": {
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$",
      "type": "string"
    },
    "query": {
      "minLength": 1,
      "type": "string"
    },
    "regionCode": {
      "maxLength": 2,
      "minLength": 2,
      "type": "string"
    },
    "type": {
      "enum": [
        "video",
        "channel",
        "playlist"
      ],
      "type": "string"
    },
    "videoCaption": {
      "enum": [
        "any",
        "closedCaption",
        "none"
      ],
      "type": "string"
    },
    "videoDefinition": {
      "enum": [
        "any",
        "high",
        "standard"
      ],
      "type": "string"
    },
    "videoDuration": {
      "enum": [
        "any",
        "short",
        "medium",
        "long"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

YouTube MCP Server

search-videos

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from YouTube MCP Server

Related Tools