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

Gemini CLI · Social Media

How to Use Twitch channel videos in Gemini CLI

Fetch a Twitch channel’s videos with titles, publication dates, durations, view counts, thumbnails, and game details. Use it to build a replay list or compare available broadcasts by topic, length, and views.

Prompts to try with Twitch channel videos in Gemini CLI

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

Use Twitch channel videos for riotgames to add a replay table to this project with title, publication date, game, duration in minutes, and view count.

Twitch channel videosGemini CLI
Try asking
  • Use Twitch channel videos for esl_cs to create a report in this project that totals returned video duration by game category.

  • Use Twitch channel videos for gamesdonequick to build a thumbnail gallery ordered by publication date, with titles and durations.

  • Use Twitch channel videos for ninja to add a comparison view showing the 10 most-viewed returned videos, their publication dates, and their durations.

  • Use Twitch channel videos for playhearthstone to build a title search in this project and show matching video IDs, dates, and view counts.

How to set up Twitch channel videos 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 Twitch channel videos

    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/twitch-user-videos",
        "input": {
          "handle": "ishowspeed"
        }
      }'

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

Twitch channel videos providers and prices

Spiral runs Twitch channel videos through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Twitch · User Videos
scrapecreators/twitch-user-videos

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Sort byTIME or VIEWS

Sort by

Filter byHIGHLIGHT, ARCHIVE, or UPLOAD

Filter by

Every API field of Twitch · User Videos is on its tool page: open its card above.

What can you do with Twitch channel videos in Gemini CLI?

Build a Twitch replay browser with game categories, durations, thumbnails, and view counts. Use video IDs to update existing entries and publication dates to organize the available catalog.

Replay index

Turn an esports channel’s returned videos into a replay index with titles, publication dates, durations, and thumbnails.

Weekly editorial shortlist

Find newly published videos from a public gaming channel and give an editor a shortlist organized by game and duration.

Video performance comparison

Compare view counts for videos published during the same period, keeping game categories and durations visible beside each result.

Game coverage report

Count returned videos by game and total their durations to describe a channel’s available coverage of each title.

Campaign title review

Search returned video titles for a campaign name and compile matching IDs, publication dates, and view counts for manual review.

New replay alerts

Compare successive video lists by ID and report newly seen replays with their titles, game categories, and durations.

Viewing shortlist

Select available videos that fit a viewer’s preferred game and maximum viewing time using game labels and video durations.

Questions about Twitch channel videos in Gemini CLI

Can Gemini CLI use Twitch channel videos?

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

How much does Twitch channel videos 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 channel videos in Gemini CLI?

No. Spiral runs Twitch channel videos 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 channel videos in Gemini CLI?

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

Does Gemini CLI wait while Twitch channel videos runs?

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

How many Twitch videos can a page contain?

ScrapeCreators documents up to 100 videos per page and pagination. A single page should not be described as a channel’s complete video history.

How far back can Twitch past broadcasts go?

Twitch retains past broadcasts for 60 days for Partners, Prime, and Turbo users, and 14 days for Affiliates. Available broadcast history therefore depends on Twitch’s retention window.

Do Highlights and Uploads have the same limits as past broadcasts?

Twitch gives Highlights and Uploads a combined 100-hour storage limit. Past broadcasts instead have retention periods based on the channel’s status.

How fresh is the video list?

ScrapeCreators says it fetches the latest available Twitch video information when a request is made. That describes request-time retrieval, rather than a daily or weekly dataset update.

What information can I compare across videos?

The provider documents titles, dates, durations, view counts, thumbnails, and broadcaster data. Its response example also includes game categories and measures video duration in seconds.

Get started

Start using Twitch channel videos 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