{"_id":"@akp-tools/yt-dlp-mcp","_rev":"2-1571adf93e30eebf0db647910849ade1","name":"@akp-tools/yt-dlp-mcp","dist-tags":{"latest":"0.0.4"},"versions":{"0.0.1":{"name":"@akp-tools/yt-dlp-mcp","version":"0.0.1","license":"MIT","_id":"@akp-tools/yt-dlp-mcp@0.0.1","maintainers":[{"name":"akp","email":"austin@akpwebdesign.com"}],"bin":{"yt-dlp-mcp":"dist/index.js"},"dist":{"shasum":"5692fb224328a0d3c3b4aa391669c8dac03a1e87","tarball":"https://registry.npmjs.org/@akp-tools/yt-dlp-mcp/-/yt-dlp-mcp-0.0.1.tgz","fileCount":11,"integrity":"sha512-2sLlKydnJ6L1b5+mngUf99ejIvP+b3lEQcjrvyE5p2tVDxm7AL9jPgc28abwGMUSnG0bTzcPu9zpvYLe2uJDfg==","signatures":[{"sig":"MEQCIBEAEvmuxThL6IiNs6ezaPctzFXhYCKi0fBq5Y77p0knAiA6k1rtuyviugYdyB0PwYDHhaEmpCM07ktj6sKR1m/BTg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30000},"type":"module","gitHead":"dc163c837db0330d0f28ea531387db958143e39b","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc && rimraf dist/resources && copyfiles -u 1 \"src/resources/**/*\" dist"},"_npmUser":{"name":"akp","email":"austin@akpwebdesign.com"},"_npmVersion":"11.9.0","description":"MCP server for retrieving video transcripts via yt-dlp","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.1.3","vitest":"^4.1.0","copyfiles":"^2.4.1","typescript":"^5.9.3","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/yt-dlp-mcp_0.0.1_1774296564492_0.22774014769890183","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@akp-tools/yt-dlp-mcp","version":"0.0.4","description":"MCP server for retrieving video transcripts via yt-dlp","type":"module","bin":{"yt-dlp-mcp":"dist/index.js"},"scripts":{"build":"tsc && rimraf dist/resources && copyfiles -u 1 \"src/resources/**/*\" dist","dev":"tsc --watch","test":"vitest run"},"repository":{"type":"git","url":"git+https://github.com/akp-tools/yt-dlp-mcp.git"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.5.0","copyfiles":"^2.4.1","rimraf":"^6.1.3","typescript":"^5.9.3","vitest":"^4.1.0"},"gitHead":"9c01a667deaa947fe1de2f78022583fc9daed92c","_id":"@akp-tools/yt-dlp-mcp@0.0.4","bugs":{"url":"https://github.com/akp-tools/yt-dlp-mcp/issues"},"homepage":"https://github.com/akp-tools/yt-dlp-mcp#readme","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-94w3pen5ThdhM86XdNpAbs3ZJ8xIPXiv4xCPZPFwFQGG0Mae1kD5prViXKQmo5y2c4ouchSjAkDSvgggepXy+Q==","shasum":"72c8c9a160d145a48f085833227d50d111be099e","tarball":"https://registry.npmjs.org/@akp-tools/yt-dlp-mcp/-/yt-dlp-mcp-0.0.4.tgz","fileCount":11,"unpackedSize":30116,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@akp-tools%2fyt-dlp-mcp@0.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDUNSSJw13CGc2S04LavZxnBgVhQmcSdJ7XozHBnUYyrwIhAMOT2coNtDIYoOuV4wO+tQhXEZ0p40ASt7s7vWOn5Mne"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:61d72df9-8dac-4148-b44e-8f439a9da9ab"}},"directories":{},"maintainers":[{"name":"akp","email":"austin@akpwebdesign.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yt-dlp-mcp_0.0.4_1774297591407_0.4293411916315488"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-23T20:09:24.424Z","modified":"2026-03-23T20:26:32.177Z","0.0.1":"2026-03-23T20:09:24.628Z","0.0.4":"2026-03-23T20:26:31.550Z"},"license":"MIT","description":"MCP server for retrieving video transcripts via yt-dlp","maintainers":[{"name":"akp","email":"austin@akpwebdesign.com"}],"readme":"# yt-dlp-mcp\n\nAn MCP server that gives AI assistants the ability to retrieve transcripts, comments, and metadata from online videos. Works with any site supported by [yt-dlp](https://github.com/yt-dlp/yt-dlp) — YouTube, Vimeo, Twitch, and [thousands more](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).\n\n## Features\n\n- **Transcripts** — Download subtitles in plain text or structured JSON, with optional timestamps and time-range filtering for long videos\n- **Comments** — Fetch top comments sorted by popularity, including author info, likes, and pinned status\n- **Subtitle tracks** — List all available subtitle languages and formats for a video\n- **Video metadata** — Title, channel, duration, view count, and more, included with every response\n- **Video insights workflow** — Built-in MCP resource with a step-by-step guide for extracting key insights from videos\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) (v18+)\n- [yt-dlp](https://github.com/yt-dlp/yt-dlp) installed and available on your `PATH`\n\nInstall yt-dlp:\n\n```bash\n# pip\npip install yt-dlp\n\n# brew\nbrew install yt-dlp\n\n# or download from https://github.com/yt-dlp/yt-dlp/releases\n```\n\n## Installation\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP server configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"yt-dlp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@akp-tools/yt-dlp-mcp\"]\n    }\n  }\n}\n```\n\n### Global install\n\n```bash\nnpm install -g @akp-tools/yt-dlp-mcp\n```\n\nThen run directly:\n\n```bash\nyt-dlp-mcp\n```\n\n## Tools\n\n### `list_subtitles`\n\nLists available subtitle tracks for a video. Returns video metadata and all available subtitle languages/formats.\n\n```\nurl: \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"\n```\n\n### `get_transcript`\n\nDownloads and returns the transcript of a video.\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| `url` | Yes | — | Video URL |\n| `language` | No | `en` | Subtitle language code |\n| `include_timestamps` | No | `false` | Add `[HH:MM:SS]` timestamps |\n| `output_format` | No | `text` | `text` or `json` |\n| `start_time` | No | — | Start of time range (`HH:MM:SS` or `MM:SS`) |\n| `end_time` | No | — | End of time range (`HH:MM:SS` or `MM:SS`) |\n\nFor long videos, use `start_time` and `end_time` to fetch specific segments instead of the full transcript.\n\n### `get_comments`\n\nFetches top comments sorted by popularity.\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| `url` | Yes | — | Video URL |\n| `max_comments` | No | `20` | Number of comments to fetch (1–500) |\n\n### `get_resource`\n\nRetrieves built-in workflow guides. Useful as a fallback for MCP clients that don't support the resources protocol.\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| `resource` | No | — | Resource name (omit to list all available) |\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `yt-dlp://instructions/video-insights` | Step-by-step workflow for extracting key insights from a video using transcripts and comments |\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Build\npnpm build\n\n# Watch mode\npnpm dev\n\n# Run tests\npnpm test\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","homepage":"https://github.com/akp-tools/yt-dlp-mcp#readme","repository":{"type":"git","url":"git+https://github.com/akp-tools/yt-dlp-mcp.git"},"bugs":{"url":"https://github.com/akp-tools/yt-dlp-mcp/issues"}}