Yoinku MCPサーバー
AIエージェントに動画の力を。YouTube・TikTok・Instagramの構造化メタデータ、字幕全文、ダウンロードリンクをMCPツールとして提供します。スクレイピングコードは不要です。
エンドポイント
Streamable HTTPのリモートMCPサーバーです。各リクエストはステートレスなJSON-RPCで、セッション管理は不要です。
https://yoinku.com/mcp認証
YoinkuのAPIキーで認証します。x-api-keyヘッダーでもBearerトークンでもOK。キーはアカウントページから無料で発行できます。
APIキーを取得セットアップ
Claude Code(CLI)
claude mcp add --transport http yoinku https://yoinku.com/mcp \
--header "x-api-key: YOUR_API_KEY"Claude・その他MCPクライアント(JSON設定)
{
"mcpServers": {
"yoinku": {
"type": "http",
"url": "https://yoinku.com/mcp",
"headers": { "x-api-key": "YOUR_API_KEY" }
}
}
}ツール
3つのツールを提供。クォータはREST APIと共通です。
get_video_metadata
動画の構造化メタデータ: タイトル、説明、チャンネル、長さ、再生/高評価数、タグ、チャプター、利用可能な字幕言語。
- パラメータ:
- url(必須)
- 消費クォータ:
- データリクエスト1回
get_video_transcript
字幕をトランスクリプトとして取得: プレーンテキスト+タイムスタンプ付きチャンク。RAGや分析にそのまま使えます。投稿者字幕を自動生成字幕より優先。
- パラメータ:
- url(必須)、lang(任意。"en"や"ja"など)
- 消費クォータ:
- データリクエスト1回
get_video_download_url
動画/音声ファイルを生成し、短時間有効なダウンロードURLを返します。フォーマット: v-1080 / v-720 / v-480 / v-360(MP4)、a-m4a / a-mp3(音声)。
- パラメータ:
- url(必須)、format(必須)
- 消費クォータ:
- ダウンロード1回 — 日次枠を超えるとプリペイドクレジットを自動消費
クォータと料金
無料枠は1アカウントあたり1日5ダウンロード+10データリクエスト(Webアプリ・REST API・MCPで共通)。足りない場合は$2.99からのプリペイドパック、または$9/月からのサブスクリプションをどうぞ。
プランとパックを見るよくある質問
- どのMCPクライアントに対応していますか?
- Streamable HTTPでMCPを話すクライアントすべてに対応します: Claude(claude.aiコネクタ・Claude Code)、Cursor、Windsurf、MCP SDKで作った自作エージェントなど。
- REST APIとの違いは?
- エンジン・APIキー・クォータは同一です。MCPではエンドポイントがツールとしてエージェントに自動発見・呼び出しされるため、HTTPの接続コードを書く必要がありません。
- 料金は?
- 無料枠だけでも一通り試せます。それ以上は買い切りのプリペイドパック($2.99で50DL、$9.99で250DL)か、サブスクリプション(Hobby $9/月、Pro $29/月)で上限を引き上げられます。
HTTPを直接使いたい場合は、同じ機能をREST APIでも提供しています。
REST APIドキュメント