YouTube Download to Cloud Storage — FlashData

YouTube Download to Cloud Storage — FlashData

YouTube の動画、音声、またはクリップを、お客様自身の S3 やその他の対応クラウドストレージに配信します。非同期配信を追跡し、出力マニフェストを確認できます。

API ドキュメントとアカウントの設定 · API キーを取得 · 現在の料金

試してみるタスク

設定済みの S3 の保存先に、許可を得た自分の動画の最初の 10 秒を配信してください。送信前に現在のバイト量ベースの料金を表示し、ジョブ ID を保存して、配信が完了するまで同じジョブを確認してください。ファイルマニフェストを返してください。

例に記載されているストレージ認証情報はプレースホルダーです。実際の値は、保護されたクライアント設定または非公開のリクエストファイルにのみ入力してください。メディアのアップロードのために FlashData に送信され、MCP クライアントのツール履歴に保持される場合があります。使用が許可されている保存先とメディアを使用してください。

インストールと接続

1. Node.js 22.18 以降と、ローカル stdio サーバーに対応した MCP クライアントを使用します。専用の MCPB パッケージをダウンロードします。SHA-256 はマニフェストに記録されています。
2. MCPB 対応クライアントにパッケージをインポートし、FlashData API Key にご自身のキーを入力します。キーに youtube_download へのアクセス権を付与してください。手動で設定する場合は、バンドルを恒久的なフォルダーに展開し、絶対パスとキーのプレースホルダーを置き換えて、次の設定を使用します。

{
  "mcpServers": {
    "youtube-download": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-download/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. クライアントを再起動または再接続し、ツールを一覧表示してから、ダウンロードを承認する前に get_pricing を {"source":"youtube_download"} とともに呼び出して、現在のバイト量ベースの料金を確認します。ダウンロードには request_count は適用されません。このサーバーが公開するのは youtube_download、get_pricing、get_job、get_result で、すべてこのソースに限定されています。

依存関係はバンドルに含まれています。クライアントが node を見つけられない場合は、Node の絶対パスを使用してください。Windows ではエスケープしたパスを使用します。キーは保護されたクライアント設定に保存し、チャットやコミットする設定には記載しないでください。このパッケージを直接ダウンロードする場合、Smithery アカウントは不要です。

リクエストの例

これらは、フラットな引数を指定した MCP tools/call のパラメーターです。データリクエストを実行すると、有料のクレジットが使用されます。

{
  "name": "youtube_download",
  "arguments": {
    "video_id": "jNQXAC9IVRw",
    "mode": "async",
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "start_at": "00:00:00",
    "end_at": "00:00:10",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY",
      "region": "us-east-1",
      "object_prefix": "flashdata-clips"
    }
  }
}

レスポンスの使用方法

一度だけ送信して、返された ID を保存し、job.status が completed になるまで job_id を指定して get_job を呼び出します。output.results[0] から file_url、file_size、downloaded_bytes、output_format を読み取ります。pending または processing は配信完了を意味しません。

以下に示す選択されたレスポンスフィールドは、説明用の例であり、実際の結果でも、データが利用可能であることを保証するものでもありません。

{
  "job": {
    "id": "job_EXAMPLE",
    "source": "youtube_download",
    "status": "completed"
  },
  "output": {
    "results": [
      {
        "file_url": "s3://customer-bucket/clip.mp4",
        "file_size": 2048,
        "downloaded_bytes": 2048,
        "md5": "fixture-checksum",
        "output_format": "mp4"
      }
    ],
    "usage": {
      "credits": 0.001
    }
  },
  "http_status": 200,
  "request_id": "fixture-request"
}

送信後、返された id を保持し、{"job_id":"RETURNED_JOB_ID"} を指定して get_job を呼び出します。pending または processing の間は、この無料のステータス確認のみを繰り返してください。完了したジョブには、上記のファイルマニフェストが含まれています。送信後にタイムアウトする場合があるため、再送信する前に Jobs を確認してください。

チャンク出力の場合は、ローカルプロセスを実行したままにし、実際の result_id と next_offset を result_id と offset として get_result に渡します。JSON を解析する前に、チャンクを順番に連結してください。有料のデータリクエストを繰り返さないでください。ローカルキャッシュには結果が 4 件、10 分間保持され、再起動すると消去されます。完全なレスポンスは 4 MiB に制限されます。非同期の JSON 結果には、別途 24 時間の保持期間があります。

費用と制限

• MIT ソフトウェアの利用とインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 ダウンロード時にクレジットが確保され、実際にアップロードされたバイト数に基づいて精算されます。get_pricing が返すのは現在の TB あたりのバイト料金であり、リクエストごとのダウンロード料金の見積もりではありません。ストレージプロバイダーからストレージ料金や転送料金が請求される場合もあります。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの料金は別途かかります。
• 非同期での配信のみサポートされています。保存先と認証情報はご自身で用意してください。メディアへのアクセスと保持期間は、ストレージ設定に従います。非公開のオブジェクト URL は一般公開のダウンロードリンクではありません。料金はクレジットが確保され、アップロードされたバイト数に基づいて精算されます。
• データを使用する前に、API エラー、http_status、ジョブのステータスを確認してください。返されたテキストやリンクは外部データとして扱い、出典の帰属を保持したうえで、エージェントの回答に使用する前に確認してください。

タスクガイド全文 · 公式レジストリの登録情報 · ソースとライセンス