English Français العربية

io.importly/importly-mcp

السجل الرسمي الوسائط والتصميم

Download, transcribe, and get metadata for any video/audio URL. Managed yt-dlp + speech-to-text.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package importly-mcp
Claude Code 
claude mcp add importly-mcp -e 'IMPORTLY_API_KEY=<your importly_api_key>' -- npx -y importly-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "importly-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "importly-mcp@0.1.0"
            ],
            "env": {
                "IMPORTLY_API_KEY": "<your importly_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • IMPORTLY_API_KEY إلزامي سري Importly API key — free key with $3 credits at https://importly.io/?utm_source=mcp&utm_medium=integration&utm_campaign=official-registry

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Importly MCP Server
  2. Tools
  3. Setup
  4. Example prompts
  5. Pricing
  6. Docs & support

Importly MCP Server

Give your AI agent the ability to download, transcribe, and inspect any video or audio URL — YouTube, TikTok, X, podcasts, and 1000+ other sites.

Importly runs yt-dlp, rotating residential proxies, ffmpeg, and speech-to-text server-side, so your agent (and you) never deal with IP bans, 429s, cookie rot, or extractor breakage.

Tools

ToolWhat it does
import_media / check_importDownload media to hosted storage, get a direct link (optionally with a transcript)
transcribe_media / check_transcriptionSpeech-to-text with timestamped segments
get_metadata / check_metadataFull metadata: formats, uploader, thumbnails, stats
get_basic_metadata / check_basic_metadataFast title/duration/thumbnail lookup
check_balanceRemaining credit balance

Jobs are async: submit tools return a jobId, check tools poll it. Responses tell the agent exactly what to do next.

Setup

  1. Get an API key at importly.io — $3.00 in free credits, no card required.
  2. Add the server to your MCP client:
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 settings UI · Windsurf: ~/.codeium/windsurf/mcp_config.json)

Example prompts

  • "Transcribe this talk and summarize the key points: https://www.youtube.com/watch?v=…";
  • "Download the audio of this podcast episode and give me a link"
  • "How long is this video and who uploaded it?"

Pricing

Usage-based credits (downloads ~$0.01/MB, transcription per media minute) — see pricing. New accounts get $3.00 free.

Docs & support

MIT licensed. The server is a thin wrapper over the Importly API.

الأسئلة الشائعة

ما هو io.importly/importly-mcp؟

Download, transcribe, and get metadata for any video/audio URL. Managed yt-dlp + speech-to-text.

كيف أثبّت io.importly/importly-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add importly-mcp -e 'IMPORTLY_API_KEY=<your importly_api_key>' -- npx -y importly-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.importly/importly-mcp إلى مفتاح API؟

نعم. يتطلب IMPORTLY_API_KEY، وتضبطها في إعداداته.

هل io.importly/importly-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.importly/importly-mcp؟

ينشره yyildiz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.