{"_id":"@flashdata-dev/youtube-cloud-storage","_rev":"6-549aa4cba4b1018ff827d4ac76fd4382","name":"@flashdata-dev/youtube-cloud-storage","dist-tags":{"latest":"0.2.1"},"versions":{"0.0.0-stage":{"name":"@flashdata-dev/youtube-cloud-storage","version":"0.0.0-stage","_id":"@flashdata-dev/youtube-cloud-storage@0.0.0-stage","stub":true,"maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"dist":{"shasum":"862ddac95d01f57f8c5d3017877dd5382c51c8c0","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-bYtYyXkG3ihNXfkat/c0R/dhmjj2IhiUkjYHt5cLWoVY4DgUjeFlQhex6A8TPbcXw4a7b22VuYNehpGTTJDiqQ==","signatures":[{"sig":"MEUCIFvT1R+9AP1xEdHW3GJrZTVzw+3K3Yle9MHhuyaj68I4AiEA2Mf9ykRNSrt0FUlVcPchBP6V6nL6OakRoRZU3lx9p2k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":358},"_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@flashdata-dev/youtube-cloud-storage","version":"0.1.0","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-cloud-storage@0.1.0","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","bugs":{"url":"https://github.com/flashdata-dev/flashdata-mcp/issues"},"bin":{"flashdata-youtube-cloud-storage":"bin/run.js"},"dist":{"shasum":"9a0274ca88e07d3c9284b755d60cf1cda737b24b","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.1.0.tgz","fileCount":24,"integrity":"sha512-mfgC77hrAksNLO+8ahpz3QvYFVI8aOzJ0RYKkeylKb6gPWsWQb6XXCFySYyEcoxpkBNqQ+2DVSD/QUR1K8X94g==","signatures":[{"sig":"MEYCIQC3CURzPvi0u46RzSO6S95Q88vBxyolgn0z4Jxk6oP4/QIhANbkshz3b3aNV1ueNXo9wjHQHxPlAaMjYO5aKi4QhsWe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICe0ciabF8VEv74wHfJXbS4iml5aYaLn2dUj45HAjK/gAiEA7YFI3PdJnpESVxNNcTVTiBTY6+MGAgZMYVmMVxCipu0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":81521},"type":"commonjs","_from":"file:/Users/rocosen/Documents/GitHub/flashdata-mcp/dist/npm-cloud-storage-review/flashdata-dev-youtube-cloud-storage-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-cloud-storage-review/flashdata-dev-youtube-cloud-storage-0.1.0.tgz","_integrity":"sha512-mfgC77hrAksNLO+8ahpz3QvYFVI8aOzJ0RYKkeylKb6gPWsWQb6XXCFySYyEcoxpkBNqQ+2DVSD/QUR1K8X94g==","repository":{"url":"git+https://github.com/flashdata-dev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"_npmVersion":"11.12.1","description":"Deliver YouTube video, audio or clips to your own S3 or other supported cloud storage. Track asynchronous delivery and its output manifest. 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-cloud-storage_0.1.0_1791991056531_0.1847434815597464","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@flashdata-dev/youtube-cloud-storage","version":"0.1.1","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-cloud-storage@0.1.1","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","bugs":{"url":"https://github.com/rocosen/flashdata-mcp/issues"},"bin":{"flashdata-youtube-cloud-storage":"bin/run.js"},"dist":{"shasum":"54a5881b80cff108716251112a7e9861ea11cf7e","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.1.1.tgz","fileCount":24,"integrity":"sha512-kX/ZnBPUdTNsUiu9lUepAdB9a+DMN1khpj+4ZBXm2+Rgs2fwXxxkDD4aOGbfVMIjL1YZRFMaIiwgIeGMKMVLHg==","signatures":[{"sig":"MEUCIQDjLaU7HQ44hrg/W+MsiKb4Z7+H6t0kOX0JsNsD73frzQIgIMaWcE/uJi/LXVnXkAGdQb8WWyFTVX2HfhCf1aK0MJg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIB3ADGJ5XG1C6L3Q+iPdV2L6cBXo2bYIJJKi6NyWRw9eAiB8a29HjEoNqS03SCxj56bR3WJJ5SN8XAjDFIeeVVndiQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82142},"type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/python-examples-20261019/npm-artifacts-0.1.1-verified/flashdata-dev-youtube-cloud-storage-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-cloud-storage-0.1.1.tgz","_integrity":"sha512-kX/ZnBPUdTNsUiu9lUepAdB9a+DMN1khpj+4ZBXm2+Rgs2fwXxxkDD4aOGbfVMIjL1YZRFMaIiwgIeGMKMVLHg==","repository":{"url":"git+https://github.com/rocosen/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"_npmVersion":"11.19.0","description":"Deliver YouTube video, audio or clips to your own S3 or other supported cloud storage. Track asynchronous delivery and its output manifest. 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-cloud-storage_0.1.1_1792397267346_0.5847269987039023","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@flashdata-dev/youtube-cloud-storage","version":"0.1.2","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-cloud-storage@0.1.2","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","bugs":{"url":"https://github.com/rocosen/flashdata-mcp/issues"},"bin":{"flashdata-youtube-cloud-storage":"bin/run.js"},"dist":{"shasum":"e502a0975dd8af5211125ea8868d059f980d1527","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.1.2.tgz","fileCount":25,"integrity":"sha512-bu1qAI3h2nPpx8YXnZRKIZA89SPjbQ9FUMnStRxNexMwCMcW/Z+2xVySaOzZG4Z3toFFpVwggy+/YCovM5DMsQ==","signatures":[{"sig":"MEUCIFjaWhLdJ5gSGCbvoSp8J/RWVMQUMTJ49XNnC0Ms3zQvAiEAm5r79A4qyYzg4TK5+9vp1dUZQfbJWkApnSQOxDYPKwo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC4xebK8eCnMYJMjnVxGlH31Wz4iFRow3YYXbYrODfYCwIhAPgxEA8kzMGVrGNVtfTT5PqjZCU/C9Tx8doPk2jMaMQD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":81410},"type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/npm-copy-20261104/artifacts/flashdata-dev-youtube-cloud-storage-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-cloud-storage-0.1.2.tgz","_integrity":"sha512-bu1qAI3h2nPpx8YXnZRKIZA89SPjbQ9FUMnStRxNexMwCMcW/Z+2xVySaOzZG4Z3toFFpVwggy+/YCovM5DMsQ==","repository":{"url":"git+https://github.com/rocosen/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"_npmVersion":"11.12.1","description":"Download YouTube video, audio or clips to your own S3 or other supported cloud storage. 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-cloud-storage_0.1.2_1793767835467_0.9086758519101377","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@flashdata-dev/youtube-cloud-storage","version":"0.2.0","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"author":{"name":"FlashData","email":"support@flashdata.dev"},"license":"MIT","_id":"@flashdata-dev/youtube-cloud-storage@0.2.0","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"homepage":"https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"bin":{"flashdata-youtube-cloud-storage":"bin/run.js"},"dist":{"shasum":"387c9a857d93b3ebd92f04c33120e14b8fc93fd4","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.2.0.tgz","fileCount":27,"integrity":"sha512-q8CDMfwoswFFu5O/qtWg30z+1cAoSJYCbZMmHimlbf1AEY/tzk9/HtVEQUN7NJ7/Y8Wk3k73MVHhZcG1mEXM6g==","signatures":[{"sig":"MEYCIQD2Z12/8+vqTlfyaEqfNjVJOCj+rgEBuuFJGt1+6q1FtwIhAIRVcDwxcUgJ2oMGeNuw1ycxQL1g6+n6fmR5+hnVQiCk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDFBRwJSpLyM2yw0kDeQen2Q1Ub8BDWJCyDGiQPsCX5DgIgGH3IYglhL9k09jS8pmQDoudtqKfOIbtwo6uhcds7UhU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102404},"type":"commonjs","_from":"file:/Users/rocosen/Documents/GitHub/datanity/outputs/registry-publish-20261105/npm/flashdata-dev-youtube-cloud-storage-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-cloud-storage-0.2.0.tgz","_integrity":"sha512-q8CDMfwoswFFu5O/qtWg30z+1cAoSJYCbZMmHimlbf1AEY/tzk9/HtVEQUN7NJ7/Y8Wk3k73MVHhZcG1mEXM6g==","repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"_npmVersion":"11.12.1","description":"Deliver YouTube video, audio or clips to your own S3 or other supported cloud storage. Track asynchronous delivery and its output manifest. 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-cloud-storage_0.2.0_1793896136748_0.026619434466306435","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"_id":"@flashdata-dev/youtube-cloud-storage@0.2.1","bin":{"flashdata-youtube-cloud-storage":"bin/run.js"},"bugs":{"url":"https://github.com/flashdatadev/flashdata-mcp/issues"},"dist":{"shasum":"f614a014d42cdb78f241a4f5afe5b5953fb52403","tarball":"https://registry.npmjs.org/@flashdata-dev/youtube-cloud-storage/-/youtube-cloud-storage-0.2.1.tgz","fileCount":27,"integrity":"sha512-dqSoLxG5Y8bAvUAEle/6GjHxvOzvWG7EftpgWzyZq7BkZujEZufj/LxoRzFAnwK1mbiagHjkddWUyvnQENg0qQ==","signatures":[{"sig":"MEYCIQDdQOiNXJMX8fVQw4/7a9+nMJ+F7GDiNx0GFRfxN815rwIhAIgD3aWAFxHmJqV9sRCd5GcjiBL9IHat057hh9FRDjXR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIC9InCGvJd3McDS/xSgB2W+Y3gorBKXSXde9JDVdC30LAiEA6PPNhix/whWo8uch/g6Oef0p9dwjBvltdFJog4E3nnI="}],"unpackedSize":101121},"name":"@flashdata-dev/youtube-cloud-storage","type":"commonjs","_from":"file:/Users/rocosen/Documents/FlashData/channels/github-npm-attribution-20261109/release/tasks/flashdata-dev-youtube-cloud-storage-0.2.1.tgz","author":{"name":"FlashData","email":"support@flashdata.dev"},"engines":{"node":">=22.18.0"},"exports":{"./package.json":"./package.json"},"license":"MIT","version":"0.2.1","_npmUser":{"name":"flashdata-dev","email":"rocosenyy@gmail.com"},"homepage":"https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"_resolved":"/Users/rocosen/Documents/FlashData/channels/github-npm-attribution-20261109/release/tasks/flashdata-dev-youtube-cloud-storage-0.2.1.tgz","_integrity":"sha512-dqSoLxG5Y8bAvUAEle/6GjHxvOzvWG7EftpgWzyZq7BkZujEZufj/LxoRzFAnwK1mbiagHjkddWUyvnQENg0qQ==","repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"_npmVersion":"11.12.1","description":"Deliver YouTube video, audio or clips to your own S3 or other supported cloud storage. Track asynchronous delivery and its output manifest. 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-cloud-storage_0.2.1_1794203447055_0.15834894280856382"}}},"time":{"created":"2026-10-14T15:14:58.855Z","modified":"2026-11-09T05:50:47.277Z","0.0.0-stage":"2026-10-14T15:14:58.855Z","0.1.0":"2026-10-14T15:17:36.619Z","0.1.1":"2026-10-19T08:07:47.420Z","0.1.2":"2026-11-04T04:50:35.555Z","0.2.0":"2026-11-05T16:28:56.853Z","0.2.1":"2026-11-09T05:50:47.131Z"},"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_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task","keywords":["youtube-download","youtube-to-s3","cli","mcp","model-context-protocol","flashdata"],"repository":{"url":"git+https://github.com/flashdatadev/flashdata-mcp.git","type":"git","directory":"npm/docs/youtube-cloud-storage"},"description":"Deliver YouTube video, audio or clips to your own S3 or other supported cloud storage. Track asynchronous delivery and its output manifest. CLI and MCP via the paid FlashData API.","maintainers":[{"name":"flashdata-dev","email":"rocosenyy@gmail.com"}],"readme":"# YouTube Download to Cloud Storage CLI and MCP — FlashData\n\nSubmit one video, audio or clip delivery to a storage destination you control. Save the returned job ID, read that job later, and inspect the delivery manifest after completion.\n\n`@flashdata-dev/youtube-cloud-storage` exposes **youtube_download** 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.\n\n[Inputs, outputs and source documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) · [Get an API key](https://flashdata.dev/signup?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) · [Current API pricing](https://flashdata.dev/pricing?utm_source=npm&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task)\n\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, and storage charges where applicable, are separate.\n\n## Run with npx\n\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:\n\n```sh\nnpx --yes @flashdata-dev/youtube-cloud-storage@0.2.1 --help\nnpx --yes @flashdata-dev/youtube-cloud-storage@0.2.1 tools\nnpx --yes @flashdata-dev/youtube-cloud-storage@0.2.1 call get_pricing\n```\n\nSave the following as `query.json`. It uses flat tool arguments; no REST `params` wrapper is needed.\n\n```json\n{\n  \"video_id\": \"jNQXAC9IVRw\",\n  \"mode\": \"async\",\n  \"download_type\": \"audio_video\",\n  \"video_quality\": \"<=720\",\n  \"output_format\": \"mp4\",\n  \"start_at\": \"00:00:00\",\n  \"end_at\": \"00:00:10\",\n  \"storage\": {\n    \"storage_type\": \"s3\",\n    \"storage_url\": \"your-media-bucket\",\n    \"access_key\": \"YOUR_ACCESS_KEY\",\n    \"secret_key\": \"YOUR_SECRET_KEY\",\n    \"region\": \"us-east-1\",\n    \"object_prefix\": \"flashdata-clips\"\n  }\n}\n```\n\nThe storage values above are nonfunctional placeholders. Replace them with your own writable destination and scoped credentials in a protected file or supply JSON through stdin. Storage credentials are sent to FlashData to deliver the media; MCP clients may retain tool arguments in history.\n\nThis command submits **one asynchronous download job**, billed by actual uploaded bytes, and writes the submission response to a file:\n\n```sh\nnpx --yes @flashdata-dev/youtube-cloud-storage@0.2.1 call youtube_download --input query.json > result.json\n```\n\nUse `--input -` to read JSON from stdin. For a local project installation, run `npm install @flashdata-dev/youtube-cloud-storage@0.2.1` and use `npx flashdata-youtube-cloud-storage` with the same arguments.\n\n## Deliver media to your own cloud storage\n\nThe submission response contains `result.id`. Put that actual ID into `job.json` as `{\"job_id\":\"job_REPLACE_WITH_RETURNED_ID\"}`, then use the job-read command below and save its response to `result.json` before processing the manifest.\n\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`:\n\n```python\nimport json\nfrom pathlib import Path\n\nresponse = json.loads(Path(\"result.json\").read_text(encoding=\"utf-8\"))\nif not response.get(\"ok\"):\n    raise SystemExit(\"The request failed; inspect the response before retrying.\")\nresult = response[\"result\"]\nif \"job\" in result:\n    status = result[\"job\"][\"status\"]\n    if status != \"completed\":\n        raise SystemExit(f\"Job status: {status}. Inspect this job; do not resubmit.\")\n    result = result[\"output\"]\nif result.get(\"status\") not in (None, \"done\"):\n    raise SystemExit(\"No completed data yet. Read the existing job before processing.\")\nif not result.get(\"results\"):\n    raise SystemExit(\"No result record was returned.\")\ndata = result[\"results\"][0]\n\nprint(json.dumps({\n    \"location\": data.get(\"file_url\"), \"bytes\": data.get(\"file_size\"),\n    \"format\": data.get(\"output_format\"),\n}, ensure_ascii=False, indent=2))\n```\n\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:\n\n```json\n{\n  \"job\": {\n    \"id\": \"job_EXAMPLE\",\n    \"source\": \"youtube_download\",\n    \"status\": \"completed\"\n  },\n  \"output\": {\n    \"results\": [\n      {\n        \"file_url\": \"s3://customer-bucket/clip.mp4\",\n        \"file_size\": 2048,\n        \"downloaded_bytes\": 2048,\n        \"md5\": \"fixture-checksum\",\n        \"output_format\": \"mp4\"\n      }\n    ],\n    \"usage\": {\n      \"credits\": 0.001\n    }\n  },\n  \"http_status\": 200,\n  \"request_id\": \"fixture-request\"\n}\n```\n\nOnly asynchronous delivery is supported. Supply your own destination and credentials; media access and retention follow your storage settings. Private object URLs are not public download links. Charges reserve Credits and settle by uploaded bytes.\n\n## Parameters\n\n| Parameter | Type | Required | Default and constraints |\n| --- | --- | --- | --- |\n| `video_id` | string | Yes | Pattern: `^[A-Za-z0-9_-]{11}$`. |\n| `download_type` | string | No | Default: `\"audio_video\"`. Allowed: `audio_video`, `video`, `audio`. |\n| `video_quality` | string | No | Default: `\"<=720\"`. Allowed: `best`, `worst`, `<=144`, `==144`, `>=144`, `<=360`, `==360`, `>=360`, `<=480`, `==480`, `>=480`, `<=720`, `==720`, `>=720`, `<=1080`, `==1080`, `>=1080`, `<=1440`, `==1440`, `>=1440`, `<=2160`, `==2160`, `>=2160`, `<=4320`, `==4320`, `>=4320`. |\n| `fps` | string | No | Pattern: `^(?:>=&#124;<=&#124;==)(?:[1-9]\\d?&#124;1\\d\\d&#124;2[0-3]\\d&#124;240)$`. |\n| `audio_language` | string | No | Default: `\"default\"`. Allowed: `default`, `original`. |\n| `audio_quality` | string | No | Default: `\"best\"`. Allowed: `best`, `320`, `256`, `192`, `128`. |\n| `yt_dlp_format` | string | No |  |\n| `upload_metadata` | boolean | No | Default: `false`. |\n| `output_format` | string | No | Allowed: `mp4`, `webm`, `mkv`, `m4a`, `mp3`, `opus`. Video defaults to mp4 (also webm/mkv); audio defaults to m4a (also mp3/opus). |\n| `start_at` | string | No | Pattern: `^\\d{1,2}:[0-5]\\d:[0-5]\\d$`. |\n| `end_at` | string | No | Pattern: `^\\d{1,2}:[0-5]\\d:[0-5]\\d$`. |\n| `storage` | object | Yes | Customer-owned destination, using the same fields as Download API params.storage. Supply credentials from your configured storage; do not invent values or display secrets. GCS uses service_account; Azure uses account_name and a container SAS with write permission; other providers use access_key/secret_key and provider endpoint/region as needed. Required destination and provider credentials; see the linked Download API reference. Never commit real values. |\n| `mode` | string | No | Default: `\"async\"`. Allowed: `async`. |\n\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.\n\n## Jobs, errors and billing\n\nDownloads are asynchronous. Save the returned `result.id`, create `job.json` with that job ID, and read it without submitting again:\n\n```json\n{\"job_id\":\"job_REPLACE_WITH_RETURNED_ID\"}\n```\n\n```sh\nnpx --yes @flashdata-dev/youtube-cloud-storage@0.2.1 call get_job --input job.json > result.json\n```\n\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. Download charges reserve Credits and settle by uploaded bytes, so a per-request quote is not a download-cost estimate.\n\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; customer media retention follows storage settings.\n\n## Connect an MCP client\n\nThis same package starts a persistent stdio server with the `mcp` subcommand:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-cloud-storage\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"--yes\",\n        \"@flashdata-dev/youtube-cloud-storage@0.2.1\",\n        \"mcp\"\n      ],\n      \"env\": {\n        \"FLASHDATA_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nUse `npx.cmd` on Windows if your client requires it. Enter your own key through protected client settings. The four tools are `youtube_download`, `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.\n\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.\n\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.\n\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.\n\n## MCP presentation\n\nTask MCP 0.2.0 default to Markdown text while retaining original\nfields in `structuredContent`. Use `response_format: \"text\"` or `\"json\"` for another\npresentation; `get_result` inherits the original format. Earlier published\nversions return JSON and do not accept this argument: check the running tool\nschema before using it. CLI calls default to JSON; explicit text formats return\na document string in the JSON `result` field. Formatting never repeats the query.\n","readmeFilename":"README.md"}