English Français العربية

io.github.nnnoel/ytranscript-mcp

السجل الرسمي التسويق والمبيعات

YouTube transcripts for AI tools. No proxies needed; transcribes videos without captions.

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

ماذا يمكنك أن تفعل مع io.github.nnnoel/ytranscript-mcp؟

  • "Summarize this video: https://youtu.be/...";
  • "What does the speaker say about pricing, and at what timestamps?"
  • "Pull the transcript of this Spanish video and translate it to English."

التثبيت

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

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

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

  • YTRANSCRIPT_API_KEY إلزامي سري API key from https://ytranscript.com/developers (free plan available)

التوثيق

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

المحتويات
  1. ytranscript-mcp
  2. Setup
  3. Tool: get_transcript
  4. Pricing
  5. Related
  6. License

ytranscript-mcp

An MCP server that gives Claude, Cursor, VS Code, and other AI tools the transcript of any YouTube video.

  • Works from anywhere. Runs fine on AWS, Lambda, Vercel, n8n Cloud, and other cloud hosts. There are no proxies to buy and no IP bans to work around. YouTube blocks most cloud IPs for transcript requests; the yTranscript API handles that for you.
  • Handles videos without captions. If a video has no captions, it's transcribed with AI speech-to-text.
  • Returns the language actually spoken by default, including on auto-dubbed videos. Pass lang to pick a specific caption track.
  • Keeps long videos manageable. Choose plain text or timestamped lines, and cap the length so a two-hour video doesn't flood the model's context.

Setup

  1. Get a free API key at ytranscript.com/developers. The free plan includes 50 units a month, no card required.
  2. Add the server to your client using one of the configs below.
Claude Code
claude mcp add ytranscript -e YTRANSCRIPT_API_KEY=yk_live_your_key -- npx -y ytranscript-mcp
Claude Desktop

Add this to claude_desktop_config.json. Open it from Settings → Developer → Edit Config.

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}
Cursor

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}
VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

Any other MCP client that runs stdio servers works the same way: run npx -y ytranscript-mcp with YTRANSCRIPT_API_KEY set.

Tool: get_transcript

ArgumentRequiredDescription
videoyesA YouTube URL (watch, youtu.be, shorts, embed) or an 11-character video ID
langnoLanguage code of the caption track to fetch, such as en or es. Omit it to get the video's original language
formatnotext (default) returns plain text. timestamped returns one line per segment with [m:ss] times
max_charactersnoCut the transcript at about this many characters. The response says how much was left out

Things to ask your assistant:

  • "Summarize this video: https://youtu.be/...";
  • "What does the speaker say about pricing, and at what timestamps?"
  • "Pull the transcript of this Spanish video and translate it to English."

Every response ends with the units used and your monthly total, so you can keep an eye on your quota.

Pricing

A transcript from captions costs 1 unit. A video without captions, transcribed with AI, costs 15 units. Failed requests are free.

PlanPriceUnits per month
Free$050
Starter$9/mo1,000
Developer$29/mo10,000
Scale$79/mo50,000

See ytranscript.com/developers for details.

  • ytranscript-api is the JavaScript/TypeScript client this server is built on.

License

MIT

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

ما هو io.github.nnnoel/ytranscript-mcp؟

YouTube transcripts for AI tools. No proxies needed; transcribes videos without captions.

كيف أثبّت io.github.nnnoel/ytranscript-mcp؟

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

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

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

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

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

من يصون io.github.nnnoel/ytranscript-mcp؟

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

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