YouTube README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the YouTube listing page.

YouTube

YouTube para Claude, ChatGPT e agentes de IA

Busca, vídeo, canal, playlist, comentários, trending e relacionados do YouTube. Hospedado pela plataforma, sem necessidade de credencial.

  • 📊 22 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes


Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome YouTube e URL https://api.mcp.ai/p_youtube.

Cursor

➕ Instalar YouTube no Cursor

VS Code (Copilot Chat)

➕ Instalar YouTube no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

Code
https://api.mcp.ai/p_youtube

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Code
Busque vídeos sobre "receita fit"
Detalhes do vídeo dQw4w9WgXcQ
Trending nos EUA

22 ferramentas disponíveis

ToolDescrição
youtube_home_feedYouTube home feed (anonymous, geo/lang aware).
youtube_trendingTrending videos by region.
youtube_searchSearch videos, channels, playlists.
youtube_resolve_urlResolve a YouTube URL or share link to its videoId / pageType.
youtube_downloadStream/download metadata for a video (formats, audio/video URLs, status).
youtube_hypeYouTube Hype: viral / hyped videos feed.
youtube_hashtagPosts under a hashtag (without leading #).
youtube_playlistPlaylist items by playlist id.
youtube_commentsTop-level comments thread for a video.
youtube_video_relatedRelated videos for a given video id.
youtube_channel_homeChannel home page payload (featured shelves + meta).
youtube_channel_aboutChannel description, links, country, subscriber count, banner.
youtube_channel_videosChannel videos tab. Bulk support: accepts ids for batched execution.
youtube_channel_shortsChannel shorts tab. Bulk support: accepts ids for batched execution.
youtube_channel_playlistsChannel playlists tab. Bulk support: accepts ids for batched execution.
youtube_channel_communityCommunity posts tab for a channel.
youtube_channel_featuredFeatured channels listed on a channel.
youtube_channel_storeStore / merch shelf for a channel.
youtube_channel_searchSearch a channel's own videos and playlists.
youtube_channel_videos_postPOST variant of channel videos.
youtube_channel_shorts_postPOST variant of channel shorts.
youtube_apiEscape hatch: call any path on the YouTube backend.

Detalhe de cada tool: docs/ferramentas.md


Preços

Planos a partir do tier grátis. Veja docs/precos.md.


Privacidade & LGPD

  • Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_youtube.


Suporte


Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_youtube é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.