Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Social Media

How to Use YouTube video transcript in Gemini CLI

Fetch a video's spoken content from its available YouTube captions. Use it to summarize a talk, find a passage, or compare explanations without relying on the video's title and description.

Prompts to try with YouTube video transcript in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use YouTube video transcript for https://www.youtube.com/watch?v=rfscVS0vtbw. Compare the tutorial's spoken Python instructions with this project's README and list discrepancies, citing the relevant transcript passages.

YouTube video transcriptGemini CLI
Try asking
  • Use YouTube video transcript for https://www.youtube.com/watch?v=8mAITcNt710. Create a study guide in docs/cs50-notes.md with concepts, definitions, and review questions supported by the returned text.

  • Use YouTube video transcript for https://www.youtube.com/watch?v=iG9CE55wbtY. Build a small local search page for the returned caption text, retaining the video link and any timing information returned.

  • Use YouTube video transcript for https://www.youtube.com/watch?v=qp0HIF3SfI4. Compare its main argument with our positioning.md and suggest specific edits without attributing our claims to the speaker.

  • Use YouTube video transcript for https://www.youtube.com/watch?v=arj7oStGLkU. Create a local quiz with five questions and answers grounded in the returned text, and include the video URL as the source.

How to set up YouTube video transcript in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run YouTube video transcript

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "youtube-com/videos/video_transcript",
        "input": {
          "video_id": "<video_id>"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds YouTube video transcript on Spiral, shows the price and runs it.

YouTube video transcript providers and prices

Spiral runs YouTube video transcript through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSocial Media
YouTube · Video transcript
youtube-com/videos/video_transcript

What can you do with YouTube video transcript in Gemini CLI?

Turn a captioned YouTube tutorial into a checklist tied to your project's code and documentation. A coding agent can compare the spoken instructions with local files and flag differences for review.

Brief a long talk

Turn a captioned public talk into a concise brief covering its main argument, examples, and conclusions, with links back to the video.

Find passages for audio review

Search caption text for a topic or phrase and collect candidate passages to verify against the speaker's audio before quoting.

Compare public explanations

Compare how two educational videos explain the same concept. Identify shared points, different examples, and claims that need further checking.

Create study questions

Build a glossary, review questions, and an answer key from a captioned lecture, keeping each answer tied to the lecture's wording.

Check documentation against a tutorial

Compare a public software tutorial's spoken instructions with project documentation and flag differences for a developer to investigate.

Review caption revisions

Compare caption text from repeated retrievals of a selected public video and report changes to wording that affect an existing summary.

Prepare discussion notes

Extract a talk's central claims and supporting examples, then draft discussion questions that distinguish the speaker's statements from your analysis.

Questions about YouTube video transcript in Gemini CLI

Can Gemini CLI use YouTube video transcript?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run YouTube video transcript like any built-in tool.

How much does YouTube video transcript cost in Gemini CLI?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need an Alexandria account to use YouTube video transcript in Gemini CLI?

No. Spiral runs YouTube video transcript on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up YouTube video transcript in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while YouTube video transcript runs?

YouTube video transcript runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Does every YouTube video have a transcript?

No. YouTube makes its full transcript available for videos that have captions, so a watchable video does not by itself establish transcript availability.

Are automatic captions available as soon as a video is uploaded?

Not always. YouTube says automatic captions may not be ready at upload, and processing time depends on the complexity of the video's audio.

How accurate are YouTube's automatic captions?

YouTube warns that mispronunciations, accents, dialects, and background noise can cause captions to misrepresent speech. Check the audio before treating a caption passage as an exact quotation.

Does YouTube automatically caption a video in every language?

No. YouTube says automatic captions are in the video's default language only; do not assume a separate caption track exists for every language.

Can a video's transcript change after publication?

Yes. Creators can edit caption text and timestamps or delete captions completely, so the same video can later have revised text or lose its captions.

Get started

Start using YouTube video transcript in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options