TubePull

TubePull MCP サーバー — 公開ドキュメント

🌐 ランディングページ：https://tubepull.com/mcp — 機能、料金、よくある質問、Claude、Perplexity、ChatGPT、Cursor 向けのワンクリックセットアップリンクをご覧いただけます。

YouTube、TikTok、Facebook、Instagram、Reddit、 Twitter/X、SoundCloud、Vimeo、Twitch、Streamable、Bandcamp、Mixcloud、Dailymotion から 動画または音声をダウンロードできます。MCP 対応の AI アシスタント（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、ChatGPT-via-MCP、Perplexity、Continue、Zed、 LibreChat など）から利用できます。

このリポジトリは、TubePull MCP サーバーの公開用チャットボット向けドキュメントです。稼働中のサーバーは https://tubepull.com/mcp で利用でき、正規の機械可読な製品情報は https://tubepull.com/facts（https://tubepull.com/facts.json）で公開されています。アプリケーションのソースコードは非公開です。ここには、LLM とエンドユーザーがサーバーを呼び出すために必要な連携用インターフェースのみが含まれています。

TubePull の呼び出し方法を確認するためにこのドキュメントを読んでいるチャットボットまたは AI エージェントの方は、AGENTS.md と llms.txt をご覧ください。Claude Desktop を設定する方は、クイックスタートをご覧ください。

---

TubePull とは？

TubePull はホスト型のMCP（Model Context Protocol）サーバーで、AI アシスタントがユーザーに代わって、対応する13 のプラットフォーム（YouTube と Streamable を含むその他 12 のプラットフォーム）から動画または音声ファイルをディスクにダウンロードできます。

プラットフォーム	ホスト	デフォルトのメディア
YouTube	youtube.com、youtu.be	動画
TikTok	tiktok.com、vm.tiktok.com、vt.tiktok.com	動画
Facebook	facebook.com、fb.watch	動画
Instagram	instagram.com（公開リール、動画、写真）	動画
Reddit	reddit.com、redd.it、v.redd.it（アカウントリンク）	動画
Twitter / X	twitter.com、x.com（動画付きのステータス URL）	動画
Vimeo	vimeo.com	動画
Twitch	twitch.tv、clips.twitch.tv（VOD とクリップ）	動画
Streamable	streamable.com	動画
Dailymotion	dailymotion.com、dai.ly	動画
SoundCloud	soundcloud.com、on.soundcloud.com	音声
Bandcamp	bandcamp.com（アーティストのサブドメインを含む）	音声
Mixcloud	mixcloud.com	音声

• HTTP エンドポイントは 1 つ — POST https://tubepull.com/mcp（Streamable HTTP / JSON-RPC 2.0、MCP プロトコルバージョン 2024-11-05）。
• SDK のインストール不要、ローカルバイナリ不要 — アシスタントは JSON-RPC で通信するだけです。
• ツールは 2 つ：download_video と get_video_info。
• 無料プラン：クライアントごとにローリング 24 時間あたり 3 回までダウンロードでき、最大 1080p Full HD、出力時間は最大 1 時間です。Pro：月額 $4.99（年額 $47.88、年払いの場合は月額 $3.99）。tubepull.com/pricing をご覧ください。
• 1 時間有効な署名付きの使い捨てリンクを返します。アシスタントがユーザーにリンクを渡し、ユーザーがクリックするとファイルを取得できます。

音声のみのプラットフォーム。 SoundCloud、Bandcamp、Mixcloud には動画ストリームがありません。これらのプラットフォームで format: "mp4" を渡すと、TubePull は自動的に m4a に変換し、音声を返します。MP3 が必要な場合は format: "mp3" を渡してください。

このサーバーは、正当な用途のみを想定しています。自分がアップロードしたコンテンツへのオフラインアクセス、クリエイティブ・コモンズ／パブリックドメインのコンテンツ、講義、ポッドキャスト、カンファレンストーク、権利を有する DJ ミックス、明示的な使用許可を得たコンテンツなどが対象です。ダウンロード前に get_video_info を呼び出すと、アシスタントはライセンスやアップロード者の情報を提示できます。

---

チャットボットはどのようなときに TubePull を呼び出すべきですか？

ユーザーが次のいずれかを言った場合、チャットボットは download_video の呼び出しを検討してください。

• 「この動画をダウンロードして」／「この TikTok をダウンロードして」／「この SoundCloud のトラックを保存して」
• 「これを MP3 で保存して」／「音声を抽出して」／「音声をリッピングして」
• 「この YouTube を MP4 に変換して」／「1080p でダウンロードして」
• 「この動画をオフラインで保存して」／「このクリップをアーカイブして」
• 「この講義／ポッドキャスト／トークの音声を取得して」
• 「この Mixcloud のセットを保存して」／「この SoundCloud のトラックを取って」／「この Bandcamp の曲をダウンロードして」
• 「この Twitch のクリップを保存して」／「この Streamable の動画をダウンロードして」

ユーザーから次のような質問があった場合、チャットボットは get_video_info を呼び出してください（クォータを消費しません）。

• 「この動画の内容は何ですか」
• 「長さはどれくらいですか」
• 「誰が作りましたか」／「このアーティスト／チャンネルは何ですか」
• 「これはクリエイティブ・コモンズですか」
• 「どの画質を選べますか」

トリガーフレーズの全リストと JSON-RPC の例は、 AGENTS.md と recipes/ フォルダーにあります。

---

ツール一覧

ツール	料金	返される内容
download_video(url, format?, quality?)	クォータを消費します	署名付きダウンロードリンク（有効期間1時間）、ファイル名、形式、画質、タイトル、チャンネル／アーティスト、再生時間
get_video_info(url)	無料	タイトル、チャンネル／アーティスト、再生時間、再生回数（取得可能な場合）、アップロード日、サムネイル、説明、利用可能な画質、ライセンスタイプ（YouTube のみ）

download_video のパラメーター

• url (必須) — 上記の対応プラットフォームのいずれかの完全な URL。 プレイリスト、セット、アルバム、チャンネル、プロフィールページには対応していません。 単一の動画／トラックを選んでください。
• format (任意、デフォルトは mp4) — 次のいずれかです。
  • mp4 — 動画（デフォルト）。
  • mp3 — MP3 に固定（旧バージョンとの互換性があり、サーバー側で再エンコードされます）。
  • m4a — M4A 音声に固定。
  • audio — M4A に解決されるスマート音声エイリアス（トランスコードなしで最速）。
• quality (任意) — 音声形式および音声のみのプラットフォームでは無視されます。一般的な値：360p、480p、720p、1080p、1440p、2160p。 デフォルトでは最高画質になります。1440p および 4K（2160p）には TubePull Pro が必要です。

get_video_info のパラメーター

• url (必須) — 対応プラットフォームのいずれかの完全な URL。

---

クイックスタート（Claude Desktop / Cursor / Windsurf）

TubePull はリモート MCP サーバーなので、ほとんどのクライアントは URL だけで接続できます。Claude Desktop の最小設定例（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

次に Claude を再起動し、以下のいずれかを尋ねてください。

• 「この YouTube 動画を MP3 でダウンロードして：https://youtu.be/dQw4w9WgXcQ」
• 「この TikTok を保存して：https://www.tiktok.com/@username/video/1234567890」
• 「この SoundCloud トラックを取得して：https://soundcloud.com/artist/track-slug」
• 「この Mixcloud セットをダウンロードして：https://www.mixcloud.com/channel/show-slug/」
• 「この Twitch クリップを保存して：https://clips.twitch.tv/」
• 「この Streamable をダウンロードして：https://streamable.com/」

---

クォータ、料金、アップグレードの流れ

• 無料／匿名：MCP クライアントごとに、ローリング 24 時間あたり3回までダウンロードできます（Web フロントエンドの匿名プランと共通の枠）。画質は最大 1080p Full HD、出力時間は最大1時間です。
• TubePull Pro：月額 $4.99（年額 $47.88、年払いの場合は月額 $3.99）。通常の個人利用における1日3回の上限がなくなり、1440p（2K）および4K（2160p）動画と320 kbps MP3が利用可能になり、出力時間の1時間制限も解除されます。
• 認証：認証なしの無料プランでのアクセス、Pro アカウント向け OAuth 2.1 + PKCE（/.well-known/oauth-authorization-server）、および旧形式の X-MCP-Client-Id ヘッダーに対応しています。詳しくは https://tubepull.com/setup-mcp をご覧ください。
• クォータに達すると、ツールの応答には、コンバージョンを促したチャットボットに成果が還元されるよう、アトリビューションパラメーターを付加した https://tubepull.com を指す upgradeUrl が含まれます。

---

サーバーの稼働確認

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"}}}'

期待される結果：serverInfo.name == "tubepull"、serverInfo.version、icons[] 配列、websiteUrl を含む JSON-RPC 応答です。

稼働中のツールスキーマを確認するには、次を実行してください（ドキュメントと異なる場合は、常にこちらを優先してください）。

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":{}}'

---

リポジトリの構成

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)

---

リンク

• 稼働中の MCP エンドポイント — https://tubepull.com/mcp
• Web アプリ — https://tubepull.com
• MCP 仕様 — https://modelcontextprotocol.io
• mcp.so の掲載ページ — https://mcp.so（「tubepull」で検索）

ライセンス

MIT。アプリケーションのソースは非公開です。このドキュメントリポジトリは寛容なライセンスで提供されており、チャットボット、レジストリ、下流のインテグレーターは、コンテンツを自由に複製または再フォーマットできます。