[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Twitch clip transcript](https://spiral.ai/integrations/gemini-cli/twitch-clip-transcript)

# How to Use Twitch clip transcript in Gemini CLI

Returns a Twitch clip's transcript from native captions, with optional AI transcription when captions are unavailable. Use it to summarize a specific clip, extract quoted passages, or search spoken content.

|  |  |
| --- | --- |
| Model | Twitch clip transcript |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Twitch clip transcript in Gemini CLI

- Use Twitch clip transcript for https://www.twitch.tv/mish/clip/WrongMagnificentTomatoCorgiDerp-C720OEMqocSPbrqA and add the returned text to a small searchable demo in this project.
- Use Twitch clip transcript on the public NASA clip URLs already listed in this project's editorial queue, then generate a searchable text index with a source link for each entry.
- Use Twitch clip transcript for the public Riot Games clip links in this project's recap data and draft one factual summary per returned transcript.
- Use Twitch clip transcript for the public GamesDoneQuick clip URLs in this project's review queue and add a phrase search that shows matching passages with clip links.
- Use Twitch clip transcript for the public ESLCS clip links in this project's tournament notes and generate a quote shortlist for editorial review.

## How to set up Twitch clip 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:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Twitch clip transcript**: One request; the result comes back by polling or a webhook.

```bash
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/twitch-clip-transcript",
    "input": {
      "url": "https://clips.twitch.tv/WrongMagnificentTomatoCorgiDerp-C720OEMqocSPbrqA"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Twitch clip transcript tools and prices

- [Twitch · Clip Transcript](https://spiral.ai/tools/scrapecreators/scrapecreators/twitch-clip-transcript) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| use_ai_as_fallback |  | — | Use paid AI only when native captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. |

## What can you do with Twitch clip transcript in Gemini CLI?

Build a searchable transcript index for selected public Twitch clips in your project. Keep each returned transcript attached to its clip link so editors can open the source from search results.

### Search a clip collection by spoken phrase

Transcribe selected public Twitch clips and index their text so an editor can find a passage by its wording.

### Prepare an esports recap

Summarize commentary from selected tournament clips and attach each summary to its clip link for editorial review.

### Review spoken sponsor mentions

Check selected campaign clips for a sponsor name or required phrase, returning the matching transcript passages for review.

### Draft social captions

Turn a creator's clip transcript into several caption drafts grounded in the words returned, ready for the creator to review.

### Build an editorial quote shortlist

Extract candidate quotations from selected public broadcast clips and pair them with their source links for verification.

### Compare announcement wording

Compare transcripts from selected public announcement clips to identify repeated claims and differences in phrasing.

### Prepare translation drafts

Translate returned clip text into another language for review before using it in a creator's localized content.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Twitch clip transcript in other agents

- [Amp](https://spiral.ai/integrations/amp/twitch-clip-transcript)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/twitch-clip-transcript)
- [Claude](https://spiral.ai/integrations/claude-desktop/twitch-clip-transcript)
- [Claude Code](https://spiral.ai/integrations/claude-code/twitch-clip-transcript)
- [Cline](https://spiral.ai/integrations/cline/twitch-clip-transcript)
- [Codex](https://spiral.ai/integrations/codex/twitch-clip-transcript)
- [Cursor](https://spiral.ai/integrations/cursor/twitch-clip-transcript)
- [Devin](https://spiral.ai/integrations/devin/twitch-clip-transcript)
- [dots](https://spiral.ai/integrations/dots/twitch-clip-transcript)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/twitch-clip-transcript)
- [Gemini](https://spiral.ai/integrations/gemini/twitch-clip-transcript)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/twitch-clip-transcript)
- [goose](https://spiral.ai/integrations/goose/twitch-clip-transcript)
- [Grok](https://spiral.ai/integrations/grok/twitch-clip-transcript)
- [Grok Build](https://spiral.ai/integrations/grok-build/twitch-clip-transcript)
- [Hermes](https://spiral.ai/integrations/hermes/twitch-clip-transcript)
- [Instinct](https://spiral.ai/integrations/instinct/twitch-clip-transcript)
- [Manus](https://spiral.ai/integrations/manus/twitch-clip-transcript)
- [Muse](https://spiral.ai/integrations/muse/twitch-clip-transcript)
- [Muse Code](https://spiral.ai/integrations/muse-code/twitch-clip-transcript)
- [n8n](https://spiral.ai/integrations/n8n/twitch-clip-transcript)
- [Notion](https://spiral.ai/integrations/notion/twitch-clip-transcript)
- [OpenClaw](https://spiral.ai/integrations/openclaw/twitch-clip-transcript)
- [opencode](https://spiral.ai/integrations/opencode/twitch-clip-transcript)
- [Perplexity](https://spiral.ai/integrations/perplexity/twitch-clip-transcript)
- [Raycast](https://spiral.ai/integrations/raycast/twitch-clip-transcript)
- [VS Code](https://spiral.ai/integrations/vscode/twitch-clip-transcript)
- [Windsurf](https://spiral.ai/integrations/windsurf/twitch-clip-transcript)
- [Zapier](https://spiral.ai/integrations/zapier/twitch-clip-transcript)

## More Gemini CLI guides

- [Twitch clip details and video](https://spiral.ai/integrations/gemini-cli/twitch-clip-details-and-video)
- [Twitch creator connected accounts](https://spiral.ai/integrations/gemini-cli/twitch-creator-connected-accounts)
- [Twitch channel videos](https://spiral.ai/integrations/gemini-cli/twitch-channel-videos)
- [Twitch creator profile](https://spiral.ai/integrations/gemini-cli/twitch-creator-profile)
- [Twitch channel schedule](https://spiral.ai/integrations/gemini-cli/twitch-channel-schedule)
- [Twitch creator search](https://spiral.ai/integrations/gemini-cli/twitch-creator-search)

## Questions about Twitch clip transcript in Gemini CLI

**Can Gemini CLI use Twitch clip transcript?**

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

**How much does Twitch clip transcript cost in Gemini CLI?**

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 Gemini CLI plan is separate.

**Do I need a ScrapeCreators account to use Twitch clip transcript in Gemini CLI?**

No. Spiral runs Twitch clip 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 Twitch clip transcript in Gemini CLI?**

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

**Does Gemini CLI wait while Twitch clip transcript runs?**

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

**Where does the transcript come from?**

The endpoint retrieves native captions from a Twitch clip. AI transcription is available as a fallback when those captions are unavailable.

**Does the response include timed subtitles?**

The documented response example contains a plain-text transcript and identifies native captions as its source. That example does not contain timed subtitle segments.

**Can a clip's captions change after publication?**

Yes. Twitch allows caption changes during the first 30 days after clip creation; after that, captions can no longer be changed.

**Does this cover an entire Twitch broadcast?**

The endpoint targets a Twitch clip. Twitch's clip creator supports clips up to 60 seconds long, so a clip transcript covers a short excerpt of a broadcast.

**Can old clip links stop working?**

Yes. Twitch allows clips to be deleted permanently, and says deletion cannot be undone.

