{"_id":"@flashdata-dev/youtube-transcript","_rev":"7-f6a77d86078de6869e317887d4dfc27b","name":"@flashdata-dev/youtube-transcript","dist-tags":{"latest":"0.3.0"},"versions":{"0.0.0-stage":{"name":"@flashdata-dev/youtube-transcript","version":"0.0.0-stage","_id":"@flashdata-dev/youtube-transcript@0.0.0-stage","stub":true,"maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"dist":{"shasum":"ccea9b66505a2d37cc1d7a0ae58ca3a449d71cb4","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-OEFvz+Yx+qwkTjAvtvxNpO+1gXIDqCtj385EYgMw3VDxIEUUk2y6SxW7/tx4yM8QQVwLkd3U3Gwgxv8s6gdTzg==","signatures":[{"sig":"MEUCIQCPDUxwB3awlIVzsKY2Ay48JgQ57MFjXg1MEfzlrcklFQIgdpBpLi5AppujbR4pO1CljrsqrqPEhKLiHTUeH/ZczZk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":355},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@flashdata-dev/youtube-transcript","version":"0.1.0","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-transcript@0.1.0","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","bugs":{"url":"https://github.com/flashdata-dev/flashdata-mcp/issues"},"bin":{"flashdata-youtube-transcript":"bin/run.js"},"dist":{"shasum":"de444c4fbb3e320fe437b13f90641bbba992f8eb","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.1.0.tgz","fileCount":24,"integrity":"sha512-MV/3NQ9pTbb1yfZsxPe6HBc95Kek1nM9oH3ghnw25E0eFQulENXRccfMT8PRakrjVbf5ezoaWlbXFlydi4s/Pg==","signatures":[{"sig":"MEYCIQDwE6hBHm14Ir6yFZ0TexDLitXw+TXj+drmiNt8cEYAoQIhAJNfx5y9F89OL4PoQd9PoZaaumyeOfpNHTQEFVO9lk6v","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHW7mJevS8Baqs3YGQpCYVI9xhhdNqGjlOd6a8z5w+IkAiB4c3KgR4STkJTspSV7brWLcAURZMcetvPeiY6X9kSKrw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73265},"type":"commonjs","_from":"file:/Users/rocosen/Documents/GitHub/flashdata-mcp/dist/npm-reviewed/flashdata-dev-youtube-transcript-0.1.0.tgz","engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"_resolved":"/Users/rocosen/Documents/GitHub/flashdata-mcp/dist/npm-reviewed/flashdata-dev-youtube-transcript-0.1.0.tgz","_integrity":"sha512-MV/3NQ9pTbb1yfZsxPe6HBc95Kek1nM9oH3ghnw25E0eFQulENXRccfMT8PRakrjVbf5ezoaWlbXFlydi4s/Pg==","repository":{"url":"git+https://github.com/flashdata-dev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.12.1","description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.31.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/youtube-transcript_0.1.0_1791986825696_0.1438093148481916","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@flashdata-dev/youtube-transcript","version":"0.1.1","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-transcript@0.1.1","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","bugs":{"url":"https://github.com/rocosen/flashdata-mcp/issues"},"bin":{"flashdata-youtube-transcript":"bin/run.js"},"dist":{"shasum":"703a32cb59e509b18985bebf46af208407bb699f","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.1.1.tgz","fileCount":24,"integrity":"sha512-4qGcpyKGNRS/rk3ivZtT1dl/WVZsFNe9PplWDebBPGVfbDVCFuUqB7CnccuxUGPnUhfwsEj0y7KN8zwh5XjXzw==","signatures":[{"sig":"MEQCIF5JAlnfB0zCMh6tIBKM6l8+SM+y5Q1qM94ORM8YJkWqAiB6ek6AIRxId6sjGAg2/cOM7q0JFmu6A40qKF0j6pDb9g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAKEhm9+HuF16uAoEe4+sfHR3iwUFS8oixkIjLtpLXQ1AiEA2pj1swTrNDgueNqTZWtdHpMcnLC2BBtFT42GJorMadU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74015},"type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/python-examples-20261019/npm-artifacts-0.1.1-verified/flashdata-dev-youtube-transcript-0.1.1.tgz","engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"_resolved":"/Users/rocosen/Documents/FlashData/channels/python-examples-20261019/npm-artifacts-0.1.1-verified/flashdata-dev-youtube-transcript-0.1.1.tgz","_integrity":"sha512-4qGcpyKGNRS/rk3ivZtT1dl/WVZsFNe9PplWDebBPGVfbDVCFuUqB7CnccuxUGPnUhfwsEj0y7KN8zwh5XjXzw==","repository":{"url":"git+https://github.com/rocosen/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.19.0","description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.31.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/youtube-transcript_0.1.1_1792397192800_0.9541567986702446","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@flashdata-dev/youtube-transcript","version":"0.1.2","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-transcript@0.1.2","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","bugs":{"url":"https://github.com/rocosen/flashdata-mcp/issues"},"bin":{"flashdata-youtube-transcript":"bin/run.js"},"dist":{"shasum":"c1df970fc10f1683af1dbdffb3dcd019c70cca69","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.1.2.tgz","fileCount":25,"integrity":"sha512-OAhJDa5bptorsET7nYkTZlSBe9zu+HwPEenjykETM72GIkWt+zJ19XpwK5KPngkJeLyeYoSo7A8Cf/B7Z/bT3g==","signatures":[{"sig":"MEYCIQCAjXSzs2LBG6K5kBrNsWw05nw14hZJ7yKo8nQNfIoIFQIhALSBzfU0edb6msixN2u+1BqNRYrjqPkJcxqCca1DDsxX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCID3ZF7UQBc15a50UAJ2olQTnNgXhJ6p/sUUUilgcFkZLAiB5X1DVe+AepKpLZnyxyKlbdY8YHEpN/omtYyHu7ZihpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73321},"type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/npm-copy-20261104/artifacts/flashdata-dev-youtube-transcript-0.1.2.tgz","engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"_resolved":"/Users/rocosen/Documents/FlashData/channels/npm-copy-20261104/artifacts/flashdata-dev-youtube-transcript-0.1.2.tgz","_integrity":"sha512-OAhJDa5bptorsET7nYkTZlSBe9zu+HwPEenjykETM72GIkWt+zJ19XpwK5KPngkJeLyeYoSo7A8Cf/B7Z/bT3g==","repository":{"url":"git+https://github.com/rocosen/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.12.1","description":"Get existing YouTube transcripts with timed segments. Selects automatic captions by default. CLI and MCP via FlashData.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/youtube-transcript_0.1.2_1793766945108_0.6470505319923087","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@flashdata-dev/youtube-transcript","version":"0.2.0","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-transcript@0.2.0","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"bin":{"flashdata-youtube-transcript":"bin/run.js"},"dist":{"shasum":"c58edaa02d57463b7abb7f0eeace1de4699fe321","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.2.0.tgz","fileCount":27,"integrity":"sha512-4MR+D3yw+02XpIjCwLr8DKVcaD86tzJLBDsIHYrndl9H2cuULPIUG9JZMFISSxOoMrgsSGj28qyPDAkzjfbAAg==","signatures":[{"sig":"MEQCIFiHhcxxHr2EiUXWmCnwiuRwtofwu5Hdp/IyE3RX3L1gAiAIDBJWDDi4ZMy7Ok7M46MAOkQwU6Jyb4XgEcs72TW8bg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC2YyK1d5UGm+OuC1xBTLyfokWtehQepbmae1o9F0rRvwIhAOrEQ5N+1av5CKasFRnOxW0wsVSxyjGzlnHwyOItt+zK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95161},"type":"commonjs","_from":"file:/Users/rocosen/Documents/GitHub/datanity/outputs/registry-publish-20261105/npm/flashdata-dev-youtube-transcript-0.2.0.tgz","engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"_resolved":"/Users/rocosen/Documents/GitHub/datanity/outputs/registry-publish-20261105/npm/flashdata-dev-youtube-transcript-0.2.0.tgz","_integrity":"sha512-4MR+D3yw+02XpIjCwLr8DKVcaD86tzJLBDsIHYrndl9H2cuULPIUG9JZMFISSxOoMrgsSGj28qyPDAkzjfbAAg==","repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.12.1","description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/youtube-transcript_0.2.0_1793896154296_0.14882049133597808","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@flashdata-dev/youtube-transcript","version":"0.2.1","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-transcript@0.2.1","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"bin":{"flashdata-youtube-transcript":"bin/run.js"},"dist":{"shasum":"5ca1a1d1df1b30eb4eebf4be18239781e8cf544c","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.2.1.tgz","fileCount":27,"integrity":"sha512-MwTfHxF2tT0NoZXehnIVrnYlZvtjOW//4ok3mhGnjW9vV+4pZI96iWaDmnfefnZ/TT8pLTIACp+CXPix4PpbYA==","signatures":[{"sig":"MEYCIQC5WtJYVwL1TZzwcbAtRWBgtGWX0VdO57INL0wykOzgNgIhANWoVCLWrP8gYiWbayKPwZO6V4s+QNM3IT37/gMXCEwV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDvxmzo8HJtlTqaTWQAEhINNZAONQBAlohnnsPEON9W1wIhAJTQUHteyOesohN3eC1yz60xKCTY7zZQmI/IhuxAHD/c","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93719},"type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/github-npm-attribution-20261109/release/tasks/flashdata-dev-youtube-transcript-0.2.1.tgz","engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"_resolved":"/Users/rocosen/Documents/FlashData/channels/github-npm-attribution-20261109/release/tasks/flashdata-dev-youtube-transcript-0.2.1.tgz","_integrity":"sha512-MwTfHxF2tT0NoZXehnIVrnYlZvtjOW//4ok3mhGnjW9vV+4pZI96iWaDmnfefnZ/TT8pLTIACp+CXPix4PpbYA==","repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.12.1","description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/youtube-transcript_0.2.1_1794203577007_0.30573554555570126","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@flashdata-dev/youtube-transcript@0.3.0","bin":{"flashdata-youtube-transcript":"bin/run.js"},"bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"dist":{"shasum":"6b5750939f2ea0cb51f0ebbc5dc8988fd57ad123","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-transcript/-/youtube-transcript-0.3.0.tgz","fileCount":27,"integrity":"sha512-LDZSx80al9suGd4SfcGwmqPfwY1D9o3muvAA0zuaswhKcVuteJgmpuGlZPLfZz6rKfyZBTQ8gWFRW3a0fFQWpA==","signatures":[{"sig":"MEUCIAXptAEEplYiKXuMy5WFYoiUWR8ObMY1Hsv+zHS9owD3AiEAvF2XKHxQASz2bLgedpyWbu42kqqzMv49qnre7pva4YQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC2zItCE/5ltZHNnMLJyjqELjiF/Bu6g+te9OUvQr7zngIhAKD2dIHEUVOXKjznW0Wl1GCtKlJWqnN2oQgqujxeaVvI"}],"unpackedSize":96379},"name":"@flashdata-dev/youtube-transcript","type":"commonjs","_from":"file:/Users/rocosen/Documents/GitHub/datanity/outputs/registry-publish-20261117/mcp/flashdata-dev-youtube-transcript-0.3.0.tgz","author":{"name":"FlashData","email":"support@flashdata.dev"},"engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"license":"MIT","version":"0.3.0","_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"_resolved":"/Users/rocosen/Documents/GitHub/datanity/outputs/registry-publish-20261117/mcp/flashdata-dev-youtube-transcript-0.3.0.tgz","_integrity":"sha512-LDZSx80al9suGd4SfcGwmqPfwY1D9o3muvAA0zuaswhKcVuteJgmpuGlZPLfZz6rKfyZBTQ8gWFRW3a0fFQWpA==","repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"_npmVersion":"11.12.1","description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","directories":{},"maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"_nodeVersion":"25.9.0","dependencies":{"ajv":"8.20.0","axios":"1.20.0","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtube-transcript_0.3.0_1794932410885_0.11705516674377148"}}},"time":{"created":"2026-10-14T14:04:25.839Z","modified":"2026-11-17T16:20:11.332Z","0.0.0-stage":"2026-10-14T14:04:25.839Z","0.1.0":"2026-10-14T14:07:05.789Z","0.1.1":"2026-10-19T08:06:32.888Z","0.1.2":"2026-11-04T04:35:45.198Z","0.2.0":"2026-11-05T16:29:14.396Z","0.2.1":"2026-11-09T05:52:57.112Z","0.3.0":"2026-11-17T16:20:11.066Z"},"bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","homepage":"https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task","keywords":["youtube-transcript","youtube-subtitles","cli","mcp","model-context-protocol","flashdata"],"repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-transcript"},"description":"Retrieve available YouTube transcript text with start and end timestamps. Build cited summaries, searchable notes and transcript exports. CLI and MCP via the paid FlashData API.","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"readme":"# YouTube Transcript CLI and MCP — FlashData\r\n\r\nRetrieve an existing caption track and keep the timestamps beside the text. The default selects automatic captions; this package does not transcribe audio when a track is missing.\r\n\r\n`@flashdata-dev/youtube-transcript` exposes **youtube_transcript** and the supporting reads for that task. It runs locally and calls the FlashData API. Node.js **22.18 or newer** and a FlashData API key with this source enabled are required.\r\n\r\n[Inputs, outputs and source documentation](https://flashdata.dev/docs/sources/youtube_transcript?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task) · [Get an API key](https://flashdata.dev/signup?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task) · [Current API pricing](https://flashdata.dev/pricing?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task)\r\n\r\n**The MIT software is free to install. FlashData API data calls are paid and consume Credits.** Pricing and job reads are free. MCP client/model fees are separate.\r\n\r\n## Run with npx\r\n\r\nSet `FLASHDATA_API_KEY` in your shell environment or secret manager. Keep the real value out of chat, committed files and command arguments. These first checks do not submit a data query:\r\n\r\n```sh\r\nnpx --yes @flashdata-dev/youtube-transcript@0.3.0 --help\r\nnpx --yes @flashdata-dev/youtube-transcript@0.3.0 tools\r\nnpx --yes @flashdata-dev/youtube-transcript@0.3.0 call get_pricing\r\n```\r\n\r\nSave the following as `query.json`. It uses flat tool arguments; no REST `params` wrapper is needed.\r\n\r\n```json\r\n{\r\n  \"video_id\": \"dQw4w9WgXcQ\",\r\n  \"language\": \"en\",\r\n  \"auto\": true\r\n}\r\n```\r\n\r\nThis command performs **one paid data request** and writes its response to a file:\r\n\r\n```sh\r\nnpx --yes @flashdata-dev/youtube-transcript@0.3.0 call youtube_transcript --input query.json > result.json\r\n```\r\n\r\nUse `--input -` to read JSON from stdin. For a local project installation, run `npm install @flashdata-dev/youtube-transcript@0.3.0` and use `npx flashdata-youtube-transcript` with the same arguments.\r\n\r\n## Export timestamped evidence for citations\r\n\r\nThe CLI returns `{\"ok\":true,\"tool\":\"...\",\"result\":...}`. Check `ok` and the API/job status before consuming data. Use Python **3.10 or newer**; only the standard library is needed. Save this as `process-result.py` beside `result.json` and run `python3 process-result.py` (Windows: `py -3 process-result.py`). The script reads the saved CLI response; it makes no API call. Missing optional fields in JSON summaries are represented as `null`:\r\n\r\n```python\r\nimport json\r\nfrom pathlib import Path\r\n\r\nresponse = json.loads(Path(\"result.json\").read_text(encoding=\"utf-8\"))\r\nif not response.get(\"ok\"):\r\n    raise SystemExit(\"The request failed; inspect the response before retrying.\")\r\nresult = response[\"result\"]\r\nif \"job\" in result:\r\n    status = result[\"job\"][\"status\"]\r\n    if status != \"completed\":\r\n        raise SystemExit(f\"Job status: {status}. Inspect this job; do not resubmit.\")\r\n    result = result[\"output\"]\r\nif result.get(\"status\") not in (None, \"done\"):\r\n    raise SystemExit(\"No completed data yet. Read the existing job before processing.\")\r\nif not result.get(\"results\"):\r\n    raise SystemExit(\"No result record was returned.\")\r\ndata = result[\"results\"][0]\r\n\r\nimport math\r\n\r\nfor segment in data.get(\"segments\") or []:\r\n    url = (f\"https://www.youtube.com/watch?v={data['videoId']}\"\r\n           f\"&t={math.floor(segment['start'])}s\")\r\n    print(f\"[{segment['start']}–{segment['end']}s] {segment['text']} {url}\")\r\n```\r\n\r\nSelected fields from a **representative fixture**, not a live response or a guarantee that every field/result will be present. This is the content inside the CLI's `result` property:\r\n\r\n```json\r\n{\r\n  \"source\": \"youtube_transcript\",\r\n  \"status\": \"done\",\r\n  \"results\": [\r\n    {\r\n      \"videoId\": \"dQw4w9WgXcQ\",\r\n      \"languageCode\": \"en\",\r\n      \"isAutoGenerated\": true,\r\n      \"segments\": [\r\n        {\r\n          \"start\": 0,\r\n          \"end\": 3,\r\n          \"text\": \"Example transcript.\"\r\n        }\r\n      ]\r\n    }\r\n  ],\r\n  \"created_at\": \"2026-10-12T00:00:00Z\",\r\n  \"http_status\": 200,\r\n  \"request_id\": \"fixture-request\"\r\n}\r\n```\r\n\r\nauto=true selects existing automatically generated captions; it does not run speech recognition. Missing tracks do not fall back to uploader captions or another language.\r\n\r\n## Parameters\r\n\r\n| Parameter | Type | Required | Default and constraints |\r\n| --- | --- | --- | --- |\r\n| `video_id` | string | Yes | Pattern: `^[A-Za-z0-9_-]{11}$`. |\r\n| `language` | string or array | No | One exact code or 1–10 distinct codes. Omit to prefer en-orig, then en. |\r\n| `auto` | boolean | No | Default: `true`. true selects automatically generated captions; false selects manually provided captions. Does not fall back between the two. |\r\n| `mode` | string | No | Default: `\"realtime\"`. Allowed: `realtime`, `async`. |\r\n\r\nThe package includes `schema.json` with the complete nested schema and `examples/query.json`. The `tools` command also returns the current schemas permitted by your key. Fields supplied by the remote source may be missing; preserve original values and source links.\r\n\r\n## Jobs, errors and billing\r\n\r\nFor a longer-running query, set `mode` to `\"async\"`. Save the returned `result.id`, create `job.json` with that job ID, and read it without submitting again:\r\n\r\n```json\r\n{\"job_id\":\"job_REPLACE_WITH_RETURNED_ID\"}\r\n```\r\n\r\n```sh\r\nnpx --yes @flashdata-dev/youtube-transcript@0.3.0 call get_job --input job.json > result.json\r\n```\r\n\r\n`pending` or `processing` means wait and read the same job later; `completed` provides the original JSON under `result.output`. The package never polls or retries paid submissions automatically. A timeout or lost response may still represent charged work: check Jobs before another submission. Each submitted query is charged at this source’s current rate; the number of returned records is not the request count.\r\n\r\nCLI exit codes are 0 for a successful operation, 1 for an API/tool failure and 2 for invalid local input/configuration. Input is limited to 256 KiB and each API response to 4 MiB. CLI outputs complete JSON. Async JSON results have a 24-hour availability window.\r\n\r\n## Connect an MCP client\r\n\r\nThis same package starts a persistent stdio server with the `mcp` subcommand:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"youtube-transcript\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"--yes\",\r\n        \"@flashdata-dev/youtube-transcript@0.3.0\",\r\n        \"mcp\"\r\n      ],\r\n      \"env\": {\r\n        \"FLASHDATA_API_KEY\": \"YOUR_API_KEY\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nUse `npx.cmd` on Windows if your client requires it. Enter your own key through protected client settings. The four tools are `youtube_transcript`, `get_pricing`, `get_job` and `get_result`; the source is fixed, and job reads reject jobs belonging to other sources. API key permissions are rechecked on each operation.\r\n\r\nMCP responses longer than 16,000 UTF-16 code units use `result_id`, `chunk` and `next_offset`. Read the remaining chunks with `get_result` in the same running server, concatenate them in order, and parse only `encoding: \"json\"`. Other encodings are Markdown or plain-text documents. The process retains at most four results for ten minutes. The one-shot CLI has no `get_result` command because it returns the whole response.\r\n\r\nOptional environment settings are `FLASHDATA_REQUEST_TIMEOUT_MS` (1000–120000, default 65000), `FLASHDATA_DATA_API_URL` and `FLASHDATA_MANAGEMENT_API_URL`. Custom URLs must be trusted HTTPS origins; loopback HTTP is accepted for local tests. The package does not load `.env` files automatically.\r\n\r\nSupport: [support@flashdata.dev](mailto:support@flashdata.dev) · [Source and issue tracker](https://github.com/flashdatadev/flashdata-mcp) · [FlashData terms](https://flashdata.dev/legal/terms) · [Privacy](https://flashdata.dev/legal/privacy). This is an independent FlashData integration, not an official Google or YouTube package.\r\n\r\n## MCP presentation\r\n\r\nTask MCP 0.2.0 default to Markdown text while retaining original\r\nfields in `structuredContent`. Use `response_format: \"text\"` or `\"json\"` for another\r\npresentation; `get_result` inherits the original format. Earlier published\r\nversions return JSON and do not accept this argument: check the running tool\r\nschema before using it. CLI calls default to JSON; explicit text formats return\r\na document string in the JSON `result` field. Formatting never repeats the query.\r\n\r\n## Language lists\n\nUse `language: [\"en\", \"es\"]` to request several tracks. Omit language to prefer `en-orig`, then `en`, returning one track. A string selects exactly that language and keeps the single-track response. Lists, including one-element lists, return `tracks` and per-language `errors` inside each result. Keep successful tracks and inspect errors; when all fail, tracks is empty. The selected caption source applies to every language.\n","readmeFilename":"README.md"}