Supadata

Supadata MCP Server

動画の文字起こし抽出、ウェブスクレイピング、クロール、サイト検出のために、Supadata と連携する Model Context Protocol（MCP）サーバーです。

機能

• YouTube、TikTok、Instagram、Twitter、ファイル URL からの動画の文字起こし抽出
• ウェブスクレイピング、クロール、URL 検出
• YouTube、TikTok、Instagram、Twitter からのメディアメタデータ取得
• 動画コンテンツからの AI を活用した構造化データ抽出

インストール

Claude、ChatGPT、Cursor、Windsurf、VS Code、その他のクライアントのセットアップ手順については、統合ガイドをご覧ください。

実行

Stdio（デフォルト）

パッケージを実行すると、stdio 上で MCP サーバーが起動します。MCP クライアント（Claude Desktop、Cursor、VS Code、Windsurf など）がサーバーを起動する際に使用します。

SUPADATA_API_KEY=your-api-key npx -y @supadata/mcp

クライアント設定の例：

{
  "mcpServers": {
    "supadata": {
      "command": "npx",
      "args": ["-y", "@supadata/mcp"],
      "env": { "SUPADATA_API_KEY": "your-api-key" }
    }
  }
}

Streamable HTTP（ホスト型）

同じツールは、src/worker.ts 内の Cloudflare Worker を通じて Streamable HTTP でも提供されます。OAuth 2.1 を使用し、https://api.supadata.ai/mcp にデプロイされています。npm run dev（wrangler）を実行すると、ローカルで起動できます。/mcp では、直接の x-api-key ヘッダー認証も受け付けます。

OAuth 接続は使用中は有効な状態を保ち、30 日間使用されないと期限切れになります。その後、クライアントは再度ログインする必要があります。Codex は再ログインを求める代わりに、期限切れのログインを繰り返し試行するため、Codex で Supadata のツールが動作しなくなった場合は、codex mcp login supadata を実行してください。

設定

環境変数

• SUPADATA_API_KEY：Supadata API キー（stdio サーバーで必須）。dash.supadata.ai で取得できます。
• DEBUG：詳細なログを有効にするには true に設定します。
• RUN_STDIO：モジュールが直接実行されるのではなくインポートされたときに、stdio サーバーを強制的に起動するには true に設定します。

ツールの選び方

ニーズに応じて適切なツールを選択してください。

• 文字起こし： プラットフォームやファイル URL から動画の文字起こしを抽出します
• スクレイピング： URL がわかっている場合に、単一ページからコンテンツを抽出します
• マップ： ウェブサイトで利用可能なすべての URL を検出します
• クロール： 関連する複数のページからコンテンツを包括的に抽出します
• メタデータ： メディア URL（YouTube、TikTok、Instagram、Twitter）からメタデータを取得します
• 抽出： AI を使用して動画コンテンツから構造化データを抽出します

ツール	最適な用途	戻り値
transcript	動画の文字起こし抽出	text/markdown
metadata	メディアメタデータ取得	JSON object
extract	AI を活用した構造化データ抽出	JSON object
scrape	単一ページのコンテンツ	markdown/html
map	サイト内の URL 検出	URL[]
crawl	複数ページの抽出	markdown/html[]

利用可能なツール

文字起こし（supadata_transcript）

対応する動画プラットフォーム（YouTube、TikTok、Instagram、Twitter）およびファイル URL から文字起こしを抽出します。

使用方法：

supadata_transcript --url "https://youtube.com/watch?v=example" --lang "en"

文字起こしのステータス確認（supadata_check_transcript_status）

ジョブ ID を使用して、文字起こし抽出ジョブの進行状況を確認します。

使用方法：

supadata_check_transcript_status --id "550e8400-e29b-41d4-a716-446655440000"

メタデータ（supadata_metadata）

対応プラットフォーム（YouTube、TikTok、Instagram、Twitter）のメディア URL からメタデータを取得します。プラットフォーム情報、タイトル、説明、投稿者の詳細、エンゲージメント統計、メディアの詳細、タグ、作成日を返します。

使用方法：

supadata_metadata --url "https://youtube.com/watch?v=example"

抽出（supadata_extract）

AI を使用して動画 URL から構造化データを抽出します。抽出する内容のプロンプト、出力形式の JSON Schema、またはその両方を指定します。非同期処理用のジョブ ID を返します。

使用方法：

supadata_extract --url "https://youtube.com/watch?v=example" --prompt "Extract the main topics discussed"

抽出ステータスの確認（supadata_check_extract_status）

ジョブ ID を使用して、抽出ジョブの進行状況を確認します。

使用方法：

supadata_check_extract_status --id "550e8400-e29b-41d4-a716-446655440000"

スクレイピング（supadata_scrape）

高度なオプションを指定して、単一 URL からコンテンツを抽出します。

使用方法：

supadata_scrape --url "https://example.com" --lang "en"

マップ（supadata_map）

スクレイピングの前に、ウェブサイト上でインデックス化されたすべての URL を見つけ、関連するページを探します。

使い方：

supadata_map --url "https://example.com"

クロール（supadata_crawl）

サイト上の複数のページからコンテンツを抽出する、非同期のクロールジョブを開始します。

使い方：

supadata_crawl --url "https://example.com/blog" --limit 100

クロールステータスの確認（supadata_check_crawl_status）

ジョブ ID を使って、クロールジョブの進行状況を確認します。

使い方：

supadata_check_crawl_status --id "550e8400-e29b-41d4-a716-446655440000"

開発

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. テストを実行します：npm test
4. プルリクエストを送信します

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください