TubeSaku MCPの使い方

接続する

1. クライアントのリモートMCPサーバー・カスタムコネクター追加画面を開きます。
2. URLに https://tubesaku.com/mcp を指定します。
3. 接続方式はStreamable HTTP、認証は不要です。TubeSakuのAPIキーやログイン情報を入力する必要はありません。
4. 接続後、ツール一覧が10件あることを確認し、下の質問例を試します。

クライアント側で有料プランや管理者の許可が必要な場合があります。会話本文をTubeSakuに送信する必要はありません。

質問例

• 今夜21時以降の初配信候補を3件探して。
• Minecraftについて最終確認時点で配信中のライブを3件探し、確認時刻も教えて。
• 2024年にデビューし、Minecraftの活動記録があるVTuberを5人探して。
• 登録者1万人以下のゲーム実況チャンネルについて、直近4週のゲーム需要と供給を比較して。

取得できる情報

• 配信予告：search_live_streams。日本時間の当日〜14日後の保存データから、1検索は最大7日間・10件。
• 配信中：search_current_live_streams。2時間以内の最終確認時点で配信中のライブ、最大10件。
• VTuber：search_vtubers。デビュー年・日付・活動ゲーム・名前・収録済み紹介文で検索、最大10件。紹介文は先頭400文字。
• ゲーム比較：get_game_trends。最大4週までさかのぼり、トップ10ランキングを取得。最新週優先で最大10行。日本語名・英語名の部分一致に対応（全半角・大文字小文字・空白・記号・かな表記を正規化）。英字名は4文字以上の語の1文字の追加・削除・置換にも対応します（例：Mecha/Meccha）。数字の違いは補完しません。欠損理由は quality.missing_fields にまとめ、series_indexes で対象行を示します。保存済み最新週は latest_available_period を確認してください。
• 歌ってみた候補：search_cover_songs。最大5曲。楽曲の利用許諾を示すデータではありません。
• 資料：get_tubesaku_index、read_tubesaku_markdown、search_tubesaku_context。
• 提供条件・品質：get_tubesaku_service_info、get_tubesaku_data_catalog。

配信予告は通常・デビューとも現行分のみです。開始予定時刻を過ぎた予告は猶予期間後に対象外となり、過去のデビュー予告や終了済み配信の履歴は取得できません。

ゲーム記録の未収録は未プレイを意味しません。検索のたびにYouTubeを再検索する仕組みではなく、保存済み観測を参照します。Markdown本文は1資料として返し、資料内の行数を検索結果件数とは数えません。

利用上限

1セッション合計20回、1検索最大10件、全体で1日20,000回です。上限時は status: usage_limit_reached を含む通常応答になります。日次上限は日本時間の翌日00:00に更新されます。セッションは会話と一対一ではない場合があります。詳しくはMCPプラン・利用条件へ。

開発者向け接続手順

initialize → notifications/initialized → tools/list / tools/call の順です。初期化応答の Mcp-Session-Id と合意した MCP-Protocol-Version を後続通信のヘッダーに付けます。POSTには Content-Type: application/json と Accept: application/json, text/event-stream を指定します。

/mcp と /mcp/ は同じ接続先です。セッションが失効した場合はクライアント側で再初期化が必要です。上限の通常応答と、失効セッション・入力形式などのプロトコルエラーは異なります。

うまく使えないとき

新ツールが表示されない場合は接続を更新してください。日付はYYYY-MM-DD、時刻は日本時間のHH:MMまたはHH:MM:SSです。該当0件も正常な応答です。接続条件・上限・データの鮮度を確認しても解決しない場合はお問い合わせ窓口へご連絡ください。

クライアント情報・検索語などのツール引数をサービス改善のため記録・集計します。詳しくはプライバシーポリシーをご覧ください。