tubedata

tubedata

tubedata は、JSON 形式で YouTube データを返す、ホスト型 HasData YouTube MCP サーバーへの小規模なローカルブリッジです。検索クエリを渡すと、結果ページを動画、チャンネル、ショート動画、棚、広告に分けて返します。動画 ID を 1 つ渡すと、その動画の詳細情報またはタイムスタンプ付き文字起こしを取得します。チャンネル ID またはハンドルを渡すと、そのチャンネルのページをタブごとに取得します。

このブリッジは YouTube データを独自には保持しません。ライブエンドポイントから取得した内容そのままの上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得されたインターフェースは読み取り専用の公開 YouTube データで、アップロード、コメント投稿、メッセージ送信、決済のツールは含まれていません。

ツール

• hasdata_youtube_search_getYoutubeSearchResults — YouTube を検索します。必須項目：q。任意のフィルターには gl、hl、deviceType、sp、sortBy、 date、videoType、length、filters__、paginationToken があります。動画、チャンネル、ショート動画の検索結果、棚、広告、総結果数を返します。
• hasdata_youtube_video_getYoutubeVideo — 11 文字の ID で動画を 1 本取得します。必須項目：v。 任意項目：gl、hl、deviceType。タイトル、再生回数と高評価数、再生時間、チャンネル、説明、字幕トラック、音楽の一致情報、関連動画の一覧を返します。
• hasdata_youtube_channel_getYoutubeChannel — ID（UC...）またはハンドル（@name）でチャンネルを 1 つ取得します。 必須項目：channelId。任意項目：tab、gl、hl、deviceType、paginationToken。チャンネルの情報、登録者数、指定したタブの項目を返します。
• hasdata_youtube_transcript_getYoutubeTranscript — 動画のタイムスタンプ付き文字起こしを取得します。必須項目：v。 任意項目：languageCode、type（自動生成されたトラックの場合は asr）。文字起こしのセグメントと、動画で利用可能なすべてのトラックを返します。

設定

• HASDATA_YOUTUBE_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=youtube です。（この上書き用の仕組みは、この再構築で独自にラベル付けされたものです。）
• HASDATA_API_KEY（任意）— 設定すると、すべての上流リクエストに、呼び出し元自身の HasData API キーを使った x-api-key: <key> ヘッダーが付加されます。未設定の場合、キーのヘッダーは送信されません。（ヘッダー名と環境変数名は、元のレジストリレコードに基づいて固定されています。この環境変数からキーを転送する動作は、独自にラベル付けされた再構築です。元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo の name は tubedata）、次に notifications/initialized 通知、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize への応答で Mcp-Session-Id ヘッダーを返した場合、その値は セッションの後続リクエストすべてに付加され、プロセスの終了までセッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの正常な結果は、上流が設定した isError フラグも含め、そのまま転送されます。 JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、完了できないリクエストなどの失敗は、テキストが tubedata error: で始まる isError 結果として返されます（このエラー表示は、この再構築で独自にラベル付けされたものです）。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドとしても実行できます。

npx @reneturcios/tubedata hasdata_youtube_search_getYoutubeSearchResults '{"q":"lofi beats"}'
npx @reneturcios/tubedata hasdata_youtube_video_getYoutubeVideo '{"v":"dQw4w9WgXcQ"}'
npx @reneturcios/tubedata hasdata_youtube_channel_getYoutubeChannel '{"channelId":"@PewDiePie"}'
npx @reneturcios/tubedata hasdata_youtube_transcript_getYoutubeTranscript '{"v":"dQw4w9WgXcQ","languageCode":"en"}'
npx @reneturcios/tubedata --version

終了コード：成功時は 0、isError の結果の場合は 1、使用法エラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/tubedata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "tubedata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tubedata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/tubedata
docker run --rm ghcr.io/cloudcorprecords/tubedata --version

コンテナーのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは、スタブ化された JSON-RPC 上流のみを使って実行され、ライブネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。