tubeai-mcp
YouTube research through the TubeAI connector (MCP). Explores 400M+ YouTube videos and 4M+ channels to find video ideas and outliers, research niches and competitors, work out titles, study transcripts and draft scripts, makes thumbnails, and saves ideas and folders to the user's TubeAI workspace. Helps the user connect and sign in when they want it. Use when the user wants video ideas, what's working in a niche or on a channel, competitor research, title or thumbnail help, a transcript or a script draft, or mentions TubeAI.
tubeai-app · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add tubeai-app/tubeai-skills --skill tubeai-mcp技能说明
name: tubeai-mcp description: YouTube research through the TubeAI connector (MCP). Explores 400M+ YouTube videos and 4M+ channels to find video ideas and outliers, research niches and competitors, work out titles, study transcripts and draft scripts, makes thumbnails, and saves ideas and folders to the user's TubeAI workspace. Helps the user connect and sign in when they want it. Use when the user wants video ideas, what's working in a niche or on a channel, competitor research, title or thumbnail help, a transcript or a script draft, or mentions TubeAI.
TubeAI connector
TubeAI connects to Claude as a connector (an MCP server) at https://beta.tubeai.app/api/mcp. It gives Claude a database of 400M+ YouTube videos and 4M+ channels, plus the user's own TubeAI workspace: ideas, folders, boards and past work. Use it to explore YouTube data, find video ideas and draft scripts with the user.
Assume the user isn't technical: do the technical parts yourself, give click-level steps when they have to act, and talk in plain language.
Once connected, TubeAI sends its own instructions and a full description of every tool; follow those for each tool's exact inputs. This skill covers getting connected, which tools to use for each job, and the rules that keep the user's account safe.
Connect first
TubeAI is optional, but this skill runs on it. Before the first TubeAI task in a session:
- Check the connection with a
workspace_accountcall. When it answers with the user's plan, TubeAI is connected. - If it isn't, offer it in a line: what it gives them (video ideas, packaging and what's working in their niche) and that it needs a free TubeAI account. If they want it, walk them through one of the two ways:
- In the Claude app (claude.ai, the desktop app or mobile). A connector added there also works in Claude Code when they're signed in with the same Claude account.
- Open Settings → Connectors (under Customize).
- Click Add → Add custom connector, name it TubeAI, and paste
https://beta.tubeai.app/api/mcpas the server URL. Leave Advanced settings empty. - Click Add, then Connect. TubeAI's authorization page opens: check the account shown and press Approve. They need to be logged in to TubeAI in that browser first.
- Or in the terminal (Claude Code): run
claude mcp add --transport http --scope user tubeai https://beta.tubeai.app/api/mcpfor them. Then they type/mcp, pick tubeai, choose to authenticate, and sign in to TubeAI in the browser that opens.
- In the Claude app (claude.ai, the desktop app or mobile). A connector added there also works in Claude Code when they're signed in with the same Claude account.
- Never add a second TubeAI connection. If TubeAI is already added (in the app's Connectors, or in
/mcpin Claude Code), it only needs signing in. On Claude Team and Enterprise plans only admins can add connectors in the app, so use the terminal line there. - Tools not showing up: in the Claude app, open the TubeAI connector in Settings → Connectors and choose ⋮ → Refresh tools list, or Disconnect and Connect again. A connector added during a session may only show up in a new chat.
- Check again with
workspace_account. If they'd rather not connect, carry on without it (WebFetch, Claude in Chrome and yt-dlp for research), and don't offer it again unless they ask.
Budget and credits
- Every tool call counts against the plan's daily request budget, which the TubeAI app's database pages share. It resets at 00:00 UTC. Going over it locks the user's database access, in the app too, for 2 days. So:
- make one well-aimed call rather than many small ones
- keep
limitsmall, and ask for extrafieldsonly when you need them (results are slim by default) - for many channels at once, use one
explore_videoscall with a channel set andperChannel, never one call per channel - get the niche labels from
explore_nichesonce, then reuse them
workspace_accountshows the plan, the credits, what each paid tool costs, which features the plan lacks, and today's budget. Check it before anything that spends credits, when a tool says a feature is locked, or when the user asks about their plan.- Spending credits needs the user's explicit OK after they've seen the cost:
thumbnail_generate,thumbnail_editand a board'sdataSources(Google Trends + X posts). Everything else is free, the other thumbnail tools included. - A section or list that comes back locked names the plan that includes it. Mention the upgrade only when it matters to what the user wants.
Playbooks
Find video ideas (for the user's channel, a niche, or a saved folder)
mini_ideaswith exactly one scope:channel(an @handle or URL),niche(a label fromexplore_niches) orfolderId(fromworkspace_folder_get). Defaults: the last 90 days, videos at 2× their channel's average or more, long-form only (includeShorts: trueadds Shorts).- It returns the outlier videos, the title formats that perform best in that niche, and the words those outlier titles share. Draft ideas from these patterns: a title, the format it borrows, and the angle that makes it the user's own.
- Check the draft titles with
mini_titles(titles, up to 20). It marks which words and phrases carry proven performance. - Save the keepers (see Save the keepers).
Research a niche
explore_nicheswithout arguments lists every niche with its outlier stats. Withniche, it gives that niche's top channels, top videos and sub-niches.explore_videoswithnichesand aminDatewindow, sorted byoutlier_multiplier, shows what's working there now.minDuration: 181leaves Shorts out.explore_channelswithnichesplus size and performance filters (minSubscribers,minAvgViews,minOutlierRateas a percent,isActive) finds the channels worth watching.
Study a competitor, or the user's own channel
explore_channelgives the profile, plus theincludesections:recentandoutliersby default, andmomentumandperformancewhen the plan has them.- `explore_simila