importly-mcp について
importly-mcpは、対応サイトの動画や音声のURLをダウンロード、文字起こし、調査するためのツールをAIエージェントに提供します。非同期ジョブで処理し、ホストされたメディアのリンク、文字起こし、メタデータを返します。
主な機能
- 01URLからメディアをダウンロード
- 02タイムスタンプ付き音声文字起こし
- 03詳細なメディアメタデータの取得
- 04基本メタデータの簡易検索
- 05残りクレジットの確認
活用シーン
- 01講演を文字起こしして内容を確認
- 02ポッドキャスト回の音声をダウンロード
- 03動画の長さと投稿者を確認
MCP 対応
このMCPサーバーはImportly APIをラップし、メディアの取り込み、文字起こし、メタデータ、残高確認のツールをMCPクライアントに提供します。時間のかかる処理はジョブIDを返し、クライアントが状態をポーリングします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y importly-mcpIMPORTLY_API_KEYシークレットImportly API key — free key with $3 credits at https://importly.io/?utm_source=mcp&utm_medium=integration&utm_campaign=official-registryローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
9掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | メディアページの URL。例:https://www.youtube.com/watch?v=... |
| audioQuality | enum | いいえ | デフォルトは mediumlowest | low | medium | high | best |
| includeAudio | boolean | いいえ | 音声ストリームを含めます(デフォルトは true) |
| includeVideo | boolean | いいえ | 動画ストリームを含めます(デフォルトは true) |
| videoQuality | enum | いいえ | デフォルトは 720plowest | 144p | 240p | 360p | 480p | 720p | 1080p | 1440p | 2160p | best |
| includeTranscript | boolean | いいえ | 同じジョブで音声も文字起こしします |
| transcriptLanguage | string | いいえ | 文字起こしに使用する ISO 言語ヒント。例:"en" |
詳細
Importly MCP サーバー
AI エージェントが、YouTube、TikTok、X、ポッドキャストなど、1000以上のサイトのあらゆる動画や音声の URL をダウンロード、文字起こし、調査できるようにします。
Importly は、yt-dlp、ローテーションする住宅用プロキシ、ffmpeg、音声認識をサーバー側で実行するため、エージェントもユーザーも、IP ブロック、429 エラー、Cookie の劣化、抽出機能の破損に悩まされることはありません。
ツール
| ツール | 機能 |
|---|---|
import_media / check_import | メディアをホストされたストレージにダウンロードし、直接リンクを取得します(文字起こしも任意で取得できます) |
transcribe_media / check_transcription | タイムスタンプ付きセグメントによる音声認識 |
get_metadata / check_metadata | 詳細なメタデータ:フォーマット、アップロード者、サムネイル、統計情報 |
get_basic_metadata / check_basic_metadata | タイトル、再生時間、サムネイルをすばやく取得 |
check_balance | 残りのクレジット残高 |
ジョブは非同期です。送信ツールは jobId を返し、確認ツールでポーリングします。レスポンスは、次に何をすればよいかをエージェントに正確に伝えます。
セットアップ
- importly.io で API キーを取得します — カード不要で、3.00ドル分の無料クレジットが付与されます。
- MCP クライアントにサーバーを追加します。
Claude Code
claude mcp add importly -e IMPORTLY_API_KEY=your_key -- npx -y importly-mcp
Claude Desktop / Cursor / Cline / Windsurf
{
"mcpServers": {
"importly": {
"command": "npx",
"args": ["-y", "importly-mcp"],
"env": { "IMPORTLY_API_KEY": "your_key" }
}
}
}
(Claude Desktop:claude_desktop_config.json · Cursor:.cursor/mcp.json · Cline:MCP 設定 UI · Windsurf:~/.codeium/windsurf/mcp_config.json)
プロンプトの例
- 「この講演を書き起こして、要点をまとめてください:https://www.youtube.com/watch?v=…」
- 「このポッドキャストのエピソードの音声をダウンロードして、リンクを教えてください」
- 「この動画の長さとアップロード者を教えてください」
料金
使用量に応じたクレジット制です(ダウンロードは約0.01ドル/MB、文字起こしはメディアの再生時間1分ごと)— 詳しくは料金をご覧ください。新規アカウントには3.00ドル分の無料クレジットが付与されます。
ドキュメントとサポート
MIT ライセンスです。このサーバーはImportly APIを呼び出す薄いラッパーです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。