YouTube

io.github.mcp-dir由 GitHub 帳號 mcp-dir 發布v0.1.0更新於 Nov 2, 2026

Search, video, channel, playlist, comments, trending and related items from YouTube. Hosted by the p

已驗證Streamable HTTP可網頁執行溝通與協作媒體與設計

概覽

AI 產生的概覽

託管式 YouTube MCP 伺服器,讓助理搜尋影片、頻道與播放清單、讀取留言,並以已連結頻道身分發布或管理留言。

可以做什麼
  • 搜尋與瀏覽:搜尋影片、頻道與播放清單,解析分享連結,查看首頁推薦、熱門、Hype 與主題標籤內容流
  • 影片與播放清單:取得影片中繼資料與下載格式/串流資訊、播放清單項目、影片頂層留言串
  • 頻道資訊:頻道首頁專區、簡介、影片、短影音、播放清單、社群貼文、商店貨架、精選頻道與頻道內搜尋,支援批次 id
  • 留言管理:列出已連結頻道,回覆留言串、發布新留言、編輯、審核(發布、待審、拒絕、封鎖作者)與刪除
  • 透過通用工具呼叫 YouTube 後端的任意路徑
  • 平台工具:版本資訊、問題回報、連線狀態、工具組狀態與 MCP 市集搜尋
適用情境
適合需要做 YouTube 研究或內容經營的情境:尋找影片與頻道、彙整留言串、追蹤熱門趨勢,或管理並審核自己頻道的留言。它是託管服務,不需在本機安裝。
執行需求
透過 HTTP 連線的遠端 MCP 端點,不需本機執行環境或安裝套件。唯讀功能不需憑證;發布、編輯、審核與刪除留言需以已連結頻道身分登入(魔法連結登入,或以 Authorization Bearer 標頭提供存取權杖)。免費額度之外需付費方案。
安裝前請注意
留言類工具會寫入真實頻道:發布、編輯、審核與刪除都是實際動作,刪除無法復原。每次呼叫會消耗配額單位,部分操作每次 50 單位。伺服器為專有託管服務,回傳的資料會傳送給你所選的 LLM 宿主。通用後端路徑工具可存取命名工具以外的介面。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 YouTube,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.mcp-dir%2Fyoutube-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "youtube": {
      "type": "http",
      "url": "https://api.mcp.ai/p_youtube"
    }
  }
}

README

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:

https://api.mcp.ai/p_youtube

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Busque vídeos sobre "receita fit"Detalhes do vídeo dQw4w9WgXcQTrending 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.

來源:README.md,提交 1cf7430

工具

35

youtube_home_feed

YouTube home feed (anonymous, geo/lang aware).

輸入參數geolangtoken

youtube_resolve_url

Resolve a YouTube URL or share link to its videoId / pageType.

輸入參數url必填

youtube_download

Stream/download metadata for a video (formats, audio/video URLs, status). Bulk support: accepts ids for batched execution.

輸入參數id必填idscgeo

youtube_hype

YouTube Hype: viral / hyped videos feed.

輸入參數geolangtoken

youtube_hashtag

Posts under a hashtag (without leading #).

輸入參數tag必填typetoken

youtube_playlist

Playlist items by playlist id. Bulk support: accepts ids for batched execution.

輸入參數id必填idstoken

youtube_comments

Top-level comments thread for a video. Bulk support: accepts ids for batched execution.

輸入參數id必填idstokensort_by

youtube_channel_home

Channel home page payload (featured shelves + meta). Bulk support: accepts ids for batched execution.

輸入參數ididstokenforUsername

youtube_channel_about

Channel description, links, country, subscriber count, banner. Bulk support: accepts ids for batched execution.

輸入參數ididsforUsername

youtube_channel_videos

Channel videos tab. Bulk support: accepts ids for batched execution.

輸入參數ididstokensort_byforUsername

youtube_channel_shorts

Channel shorts tab. Bulk support: accepts ids for batched execution.

輸入參數ididstokenforUsername

youtube_channel_playlists

Channel playlists tab. Bulk support: accepts ids for batched execution.

輸入參數ididstokensort_byforUsername

youtube_channel_community

Community posts tab for a channel. Bulk support: accepts ids for batched execution.

輸入參數ididstokenforUsername

youtube_channel_store

Store / merch shelf for a channel. Bulk support: accepts ids for batched execution.

輸入參數ididsforUsername

youtube_channel_videos_post

POST variant of channel videos. Requires a `params` continuation token captured from a prior GET response — used to fetch deeper pages or filtered shelves that the GET surface can't address. Skip in daily smoke (no synthetic params). Bulk support: accepts ids for batched execution.

輸入參數ididstokenparams必填forUsername

youtube_channel_shorts_post

POST variant of channel shorts. Requires a `params` continuation token from a prior GET response. Skip in daily smoke (no synthetic params). Bulk support: accepts ids for batched execution.

輸入參數ididstokenparams必填forUsername

youtube_api

Escape hatch: call any path on the YouTube backend. Pass path (e.g. /search), optional method (default GET), query map, and JSON body for POST. Prefer the named youtube_* tools when available; this is for routes not in the manifest.

輸入參數bodypath必填querymethod

youtube_my_channels

Lista os canais do YouTube conectados (os que podem responder e moderar comentários), com id, nome e estatísticas. Use antes de responder para confirmar de qual canal a resposta vai sair. Custa 1 unidade da cota.

輸入參數account

youtube_comment_threads

Comentários de TOPO pela API oficial, com as respostas já existentes. É daqui que sai o `parent_id` usado em youtube_comment_reply (o id do thread), então prefira esta tool a youtube_comments quando a intenção for responder. Sem `video_id`, traz os comentários do canal conectado inteiro (bom para 'o que ainda não respondi'). Custa 1 unidade da cota. Bulk support: accepts video_ids, channel_ids for batched execution.

輸入參數orderaccountvideo_idvideo_idschannel_idpage_tokenchannel_idsmax_resultssearch_termsmoderation_status

youtube_comment_reply

Responde comentários como o canal conectado. Aceita VÁRIAS respostas numa chamada (`replies`), e um item que falha não derruba os outros. `parent_id` tem que ser o id de um comentário de TOPO (campo `id` do thread devolvido por youtube_comment_threads), nunca o id de uma resposta. Cada resposta consome 50 unidades da cota da API do YouTube, então responda o que importa em vez de varrer o canal.

輸入參數accountreplies必填

youtube_comment_post

Publica um comentário NOVO de topo em um vídeo, como o canal conectado. Para responder alguém, use youtube_comment_reply. Custa 50 unidades da cota. Bulk support: accepts video_ids for batched execution.

輸入參數text必填accountvideo_id必填video_ids

youtube_comment_update

Edita o texto de um comentário ou resposta PUBLICADO pelo canal conectado (corrigir um erro sem apagar e repostar, o que perderia as curtidas e o encadeamento). Só funciona em comentário de autoria do próprio canal. Custa 50 unidades da cota. Bulk support: accepts comment_ids for batched execution.

輸入參數text必填accountcomment_id必填comment_ids

youtube_comment_moderate

Modera comentários no canal conectado: publica (`published`), segura para revisão (`heldForReview`) ou rejeita (`rejected`). `ban_author` só é aceito junto de `rejected`. Vale apenas para comentários em vídeos do próprio canal. Custa 50 unidades por comentário.

輸入參數status必填accountban_authorcomment_ids必填

youtube_comment_delete

Apaga DEFINITIVAMENTE um comentário (não tem desfazer). Só funciona em comentário do próprio canal ou em vídeo do canal conectado. Para esconder sem apagar, prefira youtube_comment_moderate com `rejected`. Custa 50 unidades da cota. Bulk support: accepts comment_ids for batched execution.

輸入參數accountcomment_id必填comment_ids

show_version

Show Version

Show the current MCP platform and adapter versions.

無需輸入參數。

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

輸入參數contextmessage必填conversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

無需輸入參數。

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

無需輸入參數。

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

輸入參數limitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool另有 11 個

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

輸入參數token

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分