convez.ai
MCP ServerIntegração & APIsIntermediário
miketwalker

TubePull MCP — Download de Vídeos e Áudios

miketwalker/tubepull-mcp

Download YouTube, TikTok, SoundCloud e mais via MCP para AI assistants

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP hospedado que permite aos assistentes de IA baixar vídeos e áudios de 10 plataformas (YouTube, TikTok, X, SoundCloud, Bandcamp, Mixcloud, Vimeo, Twitch, Streamable, Dailymotion) direto para o disco do usuário. Funciona via JSON-RPC sem instalação local, com tier gratuito de 3 downloads/dia e plano ilimitado por $3,99/mês.

Instalação

$npx convez-ai miketwalker/tubepull-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 semanas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Baixar conteúdo próprio ou com licença Creative Commons para análise offline
  • Extrair áudios de podcasts, palestras e DJ mixes para processamento
  • Integrar capacidade de download em workflows de assistentes de IA (Claude, Cursor, ChatGPT via MCP)

Veredito

Ferramenta bem construída e focada: MCP server robusto com suporte a múltiplas plataformas, pricing justo e documentação clara para agentes. Recomendado para quem precisa integrar download de mídia em fluxos de IA, respeitando limitações legais óbvias.

README

A tradução para o português deste README ainda está na fila.

TubePull MCP Server — Public Documentation

🌐 Landing page: https://tubepull.com/mcp — features, pricing, FAQ, and one-click setup links for Claude, Perplexity, ChatGPT, and Cursor.

Download video or audio from YouTube, TikTok, Twitter/X, SoundCloud, Vimeo, Twitch, Streamable, Bandcamp, Mixcloud, and Dailymotion — from any MCP-compatible AI assistant (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, ChatGPT-via-MCP, Perplexity, Continue, Zed, LibreChat, …).

This repo is the public, chatbot-facing documentation for the TubePull MCP server. The live server runs at https://tubepull.com/mcp. The application source code is private — only the integration surface that LLMs and end users need to call the server lives here.

If you are a chatbot or an AI agent reading this to figure out how to call TubePull, jump straight to AGENTS.md and llms.txt. If you are a human setting up Claude Desktop, jump to Quick start.


What is TubePull?

TubePull is a hosted MCP (Model Context Protocol) server that lets an AI assistant download a video or audio file to disk on the user's behalf, from any of ten supported platforms:

PlatformHostsDefault medium
YouTubeyoutube.com, youtu.bevideo
TikToktiktok.com, vm.tiktok.comvideo
Twitter / Xtwitter.com, x.com (status URLs with video)video
Vimeovimeo.comvideo
Twitchtwitch.tv, clips.twitch.tv (VODs and clips)video
Streamablestreamable.comvideo
Dailymotiondailymotion.com, dai.lyvideo
SoundCloudsoundcloud.com, on.soundcloud.comaudio
Bandcampbandcamp.com (artist subdomains included)audio
Mixcloudmixcloud.comaudio
  • One HTTP endpoint — POST https://tubepull.com/mcp (JSON-RPC 2.0, MCP protocol version 2024-11-05).
  • No SDK install, no local binary — the assistant just speaks JSON-RPC.
  • Two tools: download_video and get_video_info.
  • Free tier: 3 downloads per 24h per client. Unlimited: $3.99/mo at tubepull.com.
  • Returns a signed one-time link valid for 1 hour. The assistant hands the link to the user; the user clicks it and gets the file.

Audio-only platforms. SoundCloud, Bandcamp, and Mixcloud do not have a video stream. If you pass format: "mp4" on one of these, TubePull silently coerces to m4a and returns audio. Pass format: "mp3" if you want MP3.

The server is intended for legitimate use cases only — offline access to your own uploads, Creative Commons / public-domain content, lectures, podcasts, conference talks, DJ mixes you have rights to, and content you have explicit permission to use. Calling get_video_info first lets the assistant surface the license / uploader before downloading.


When should a chatbot call TubePull?

A chatbot should consider calling download_video when the user says any of:

  • "download this video" / "download this TikTok" / "save this SoundCloud track"
  • "save this as MP3" / "extract the audio" / "rip the audio"
  • "convert this YouTube to MP4" / "download in 1080p"
  • "save this video offline" / "archive this clip"
  • "get the audio from this lecture / podcast / talk"
  • "save this Mixcloud set" / "grab this SoundCloud track" / "download this Bandcamp song"
  • "save this Twitch clip" / "download this Streamable video"

A chatbot should call get_video_info (no quota cost) when the user asks:

  • "what is this video about"
  • "how long is it"
  • "who made it" / "what artist / channel is this"
  • "is this Creative Commons"
  • "what qualities are available"

Full trigger-phrase list and JSON-RPC examples live in AGENTS.md and the recipes/ folder.


Tools at a glance

ToolCostReturns
download_video(url, format?, quality?)counts against quotasigned download link (1 hour TTL), filename, format, quality, title, channel/artist, duration
get_video_info(url)freetitle, channel/artist, duration, view count (when available), upload date, thumbnail, description, available qualities, license type (YouTube only)

download_video parameters

  • url (required) — full URL from any of the ten supported platforms above. Playlists, sets, albums, channels, and profile pages are not supported — pick a single video / track.
  • format (optional, default mp4) — one of:
    • mp4 — video (default).
    • mp3 — forced MP3 (legacy-compatible, re-encodes server-side).
    • m4a — forced M4A audio.
    • audio — smart audio alias that resolves to M4A (no transcode, fastest).
  • quality (optional) — ignored for audio formats and on audio-only platforms. Common values: 360p, 480p, 720p, 1080p, 1440p, 2160p. Defaults to best. 1440p and 4K (2160p) require Unlimited.

get_video_info parameters

  • url (required) — full URL from any supported platform.

Quick start (Claude Desktop / Cursor / Windsurf)

TubePull is a remote MCP server, so most clients can connect with just a URL. Minimal Claude Desktop snippet (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "tubepull": {
      "url": "https://tubepull.com/mcp"
    }
  }
}

Then restart Claude and ask any of:


Quotas, pricing, and the upgrade flow

  • Free / anonymous: 3 downloads per 24h per MCP client (shared bucket with the web frontend's anonymous tier).
  • Unlimited: $3.99/mo. Removes the 3/day cap, unlocks 1440p and 4K video, and unlocks videos longer than 2 hours.
  • When the quota is hit, the tool response includes an upgradeUrl pointing at https://tubepull.com with attribution params so the conversion is credited back to the chatbot that drove it.

Verify the server is live

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

Expected: a JSON-RPC response with serverInfo.name == "tubepull", serverInfo.version, an icons[] array, and websiteUrl.

To see the live tool schemas (always trust these over docs if they differ):

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Repository layout

tubepull-mcp/
├── README.md              ← you are here
├── llms.txt               ← top-level summary for LLM crawlers
├── AGENTS.md              ← explicit "how to call this" recipes for agents
├── server.json            ← MCP registry manifest
├── recipes/
│   ├── download-mp3.md
│   ├── download-mp4.md
│   ├── download-non-youtube.md
│   └── get-info.md
└── assets/                ← brand marks (favicon, logo)

Links

License

MIT. The application source is closed; this documentation repo is permissively licensed so chatbots, registries, and downstream integrators can mirror or reformat the content freely.

Ver o original no GitHub

Bom para

Relacionados