How to Use YouTube transcript in Windsurf
Fetch a public YouTube video's or Short's captions as timed segments and plain text. Use it to summarize spoken content, find passages, or build searchable notes when YouTube exposes a matching caption track.
Prompts to try with YouTube transcript in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=WUvTyaaNkzM. Add a searchable reference page to this project with matching passages and timestamps.
Use YouTube video transcript for freeCodeCamp's https://www.youtube.com/watch?v=rfscVS0vtbw. Create a JSON fixture containing the returned timed segments and plain text, preserving the source wording.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=3b_qM4o5nWo. Write a Markdown study guide in this repository with definitions and supporting timestamps.
Use YouTube video transcript for freeCodeCamp's https://www.youtube.com/watch?v=rfscVS0vtbw. Build a small transcript viewer in this project that filters caption segments by a search phrase.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=WUvTyaaNkzM. Add transcript-based question answering to this project and show the supporting passage and timestamp with each answer.
How to set up YouTube transcript in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run YouTube 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": "scrapecreators", "model": "scrapecreators/youtube-transcript", "input": { "url": "https://www.youtube.com/watch?v=bjVIDXPP7Uk" } }'
Then paste one of the prompts above: Windsurf finds YouTube transcript on Spiral, shows the price and runs it.
YouTube transcript providers and prices
Spiral runs YouTube transcript through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Cache max age | 1d, 3d, 7d, 14d, or 30d | Return ScrapeCreators' cached answer when it is at most this old (0 credits, with | |
| Original audio | on or off | Return captions only in the original spoken language YouTube identified. Takes precedence over |
Every API field of YouTube transcript is on its tool page: open its card above.
What can you do with YouTube transcript in Windsurf?
Build a searchable reference for public YouTube lectures and tutorials, with each result tied to a caption timestamp. A coding agent can turn transcript responses into project fixtures, search records, and documentation.
Lecture notes with timestamps
Turn a public lecture's caption segments into an outline, definitions, and review questions. Attach timestamps so readers can return to the relevant explanation.
Searchable video references
Index transcript text from selected public videos and return matching passages with their segment times.
Product announcement briefs
Extract product names, stated features, and commitments from a company's public announcement video, with a timestamp for each supporting passage.
Tutorial checklists
Convert a tutorial's spoken instructions into an ordered checklist. Link each step to the caption passage that explains it.
Caption revision review
Compare successive transcript responses for a selected video and flag changed wording or timing for review.
Creator content planning
Use a creator's own captioned videos to draft chapter suggestions, newsletter outlines, and short clip candidates grounded in spoken passages.
YouTube transcript success rate and speed on Spiral
Success and speed over the last 24 hours, across every run of these tools on Spiral.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| YouTube transcript | 100.0% | 5.9s | 32 |
More on YouTube transcript and Windsurf
YouTube transcript in other agents
Questions about YouTube transcript in Windsurf
Can Windsurf use YouTube transcript?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run YouTube transcript like any built-in tool.
How much does YouTube transcript cost in Windsurf?
Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need a ScrapeCreators account to use YouTube transcript in Windsurf?
No. Spiral runs YouTube transcript on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up YouTube transcript in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while YouTube transcript runs?
YouTube transcript runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.
Does every public YouTube video have a transcript?
No. The endpoint retrieves public caption tracks from videos and Shorts, and a missing matching track produces a null transcript. It has no AI transcription fallback.
Can it retrieve captions from an hour-long lecture?
Yes, if YouTube exposes public captions. ScrapeCreators documents support for videos of any length, so an hour-long lecture is within its stated coverage.
Are captions available immediately after upload?
Not always. YouTube says automatic captions may still be processing when a video is uploaded, with timing dependent on audio complexity. Creators can also revise caption text and timing later.
How accurate are YouTube's automatic captions?
YouTube identifies pronunciation, accents, dialects, and background noise as causes of transcription errors. Check important quotations against the audio before using them as exact statements.
Does YouTube automatically caption every language track?
No. YouTube says automatic captions are in the video's default language only. The transcript endpoint returns null when the requested language has no matching captions.
Start using YouTube transcript in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


