Skip to content

trendsmcp/youtube-trends-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

youtube-trends-mcp

YouTube Trends MCP Works with Claude Works with Cursor

YouTube trend data for AI assistants Find out what people are searching for on YouTube. Rising topics, growing video keywords, and historical search demand - all queryable by your AI in plain language.

Full docs and live demo: https://trendsmcp.ai/youtube-trends

Part of Trends MCP - the MCP server for live trend data across 12+ sources. See the main repo: https://github.com/trendsmcp/trends-mcp


Get started in 2 steps

Step 1: Get your free API key at trendsmcp.ai 100 requests/day, no credit card required.

Step 2: Add to your AI client (replace YOUR_API_KEY):

+ Add to Cursor (one click)

Cursor / Windsurf / Cline   (~/.cursor/mcp.json or equivalent)

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code / GitHub Copilot   (.vscode/mcp.json)

{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop   (claude_desktop_config.json) User → Settings → Developer → Edit Config — add inside mcpServers

{
  "mcpServers": {
    "trends-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.trendsmcp.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude.ai (browser)   Settings -> Connectors -> Add custom connector:

https://api.trendsmcp.ai/mcp

Example query

After connecting, ask your AI:

get_trends(keyword='morning routine', source='youtube', data_mode='weekly')

Available tools

Tool What it does
get_trends Time-series for a keyword on this source
get_growth Growth % over 1W, 1M, 3M, 6M, 1Y periods
get_top_trends What is trending right now on this source
get_ranked_trends Top topics ranked by volume

FAQ

What YouTube data does Trends MCP provide?

YouTube video search volume trends - normalized interest over time, growth metrics, and historical series. This reflects demand for video content on specific topics, not view counts on individual videos.

How is YouTube search data different from Google Search data?

YouTube reflects video-specific intent. A keyword like 'how to do a handstand' may have high YouTube demand but lower Google Search volume. Comparing both reveals content format preferences.

Can I use this to find trending YouTube content ideas?

Yes. Query a set of topic keywords, rank by growth rate over the last 30 days, and your AI will surface which video topics are gaining search momentum right now.

Does it cover YouTube Shorts search demand?

The signal reflects overall YouTube search volume including Shorts discovery. YouTube does not separate Shorts search data, so results reflect total platform search interest.


All data sources

Trends MCP covers 12+ sources in one connection: Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia, News Sentiment, Web Traffic, App Downloads, Steam, npm, and more.

Browse all: https://trendsmcp.ai/data-sources


Also works as a Python client

Same API key works directly in Python - no MCP host needed.

pip install youtube-trends-mcp
import os
from youtube_trends_mcp import TrendsMcpClient, SOURCE

client = TrendsMcpClient(api_key=os.environ["TRENDSMCP_API_KEY"])

series  = client.get_trends(source=SOURCE, keyword="your keyword")
growth  = client.get_growth(source=SOURCE, keyword="your keyword", percent_growth=["1M", "3M", "12M"])
top     = client.get_top_trends(type="Youtube", limit=10)

Full Python docs: trendsmcp.ai/docs

License

MIT © Trends MCP

Packages

 
 
 

Contributors

Languages