Archivarix Tube Search

tube-search-mcp

Archivarix Tube Search 用の MCP サーバーです。AI アシスタントを通じて、アーカイブされた YouTube 動画を検索できます。

2005 年以降にインデックスされた 10 億件以上の YouTube 動画を検索できます。削除された動画、メタデータ、サムネイル、字幕を見つけられます。

クイックスタート

npx tube-search-mcp --api-key tsk_YOUR_KEY

または、環境変数を使います。

export TUBE_API_KEY=tsk_YOUR_KEY
npx tube-search-mcp

API キーは tube.archivarix.net から取得できます（プロフィール → API キー）。

設定

Claude Desktop

~/.claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Claude Code

~/.claude/mcp.json に追加します。

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

VS Code

プロジェクト内の .vscode/mcp.json に追加します。

{
  "servers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

利用可能なツール

ツール	説明
search_channel	YouTube チャンネルのアーカイブ済み動画をすべて検索します
search_videos	動画のタイトルと説明文を全文検索します
get_video	ID を指定して、特定の動画のメタデータを取得します
get_subtitles	読みやすいプレーンテキスト形式でトランスクリプトを取得します
get_summary	AI が生成した動画の要約を取得します
generate_summary	動画の新しい AI 要約を生成します
browse_summaries	タグ、チャンネル、言語で要約を閲覧します
get_video_status_history	動画のステータス変更履歴を表示します
get_usage	現在の API 使用状況と上限を確認します

リソース

URI	説明
tube://video/{videoId}	動画のメタデータ
tube://channel/{channelId}	チャンネル情報
tube://subtitles/{videoId}	プレーンテキスト形式のトランスクリプト
tube://summary/{videoId}	AI が生成した要約
tube://tags	人気の要約タグ

プロンプト

プロンプト	説明
research_video	動画を包括的に分析するワークフロー
channel_overview	チャンネルの調査と統計
find_deleted	削除された動画を見つけて分析します

環境変数

変数	説明	デフォルト
TUBE_API_KEY	API キー（必須）	—
TUBE_MCP_URL	カスタム MCP エンドポイント	https://tube.archivarix.net/mcp

仕組み

このパッケージは、stdio と HTTP の間のプロキシとして機能します。Streamable HTTP を介してリモートの Archivarix Tube Search MCP サーバーに接続し、同じツール、リソース、プロンプトを stdio トランスポート経由でローカルの AI クライアントに公開します。

AI Client ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp

ドキュメント

詳しいドキュメント：tube.archivarix.net/guide/mcp

ライセンス

MIT