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

Gemini CLI · Social Media

How to Use YouTube trending Shorts in Gemini CLI

Fetch about 48 YouTube Shorts with titles, links, channel details, publish dates, durations, and public engagement counts. Use it to discover content ideas across channels; repeat calls can return new Shorts.

Prompts to try with YouTube trending Shorts in Gemini CLI

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

Use YouTube trending Shorts to populate a review table in this project with titles, channel names, links, durations, and views. Highlight basketball examples for a Nike content brief.

YouTube trending ShortsGemini CLI
Try asking
  • Use YouTube trending Shorts three times and add a deduplicated report to this project. Select cooking examples for a Tasty editorial review and include their public counts.

  • Use YouTube trending Shorts to build a duration comparison report for science-related results relevant to NASA. Show titles, links, publish dates, and views.

  • Use YouTube trending Shorts and add a title-format summary to this project's reporting page. Focus on soccer results for an adidas brief and link every example.

  • Use YouTube trending Shorts to create a channel shortlist for a LEGO partnership review. Select relevant returned videos and show their titles, links, likes, and views.

How to set up YouTube trending Shorts 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 trending Shorts

    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-shorts-trending",
        "input": {}
      }'

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

YouTube trending Shorts providers and prices

Spiral runs YouTube trending Shorts through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
YouTube · Trending Shorts
scrapecreators/youtube-shorts-trending

What can you do with YouTube trending Shorts in Gemini CLI?

Build an editorial review table from YouTube Shorts titles, links, durations, and public counts. Your coding agent can add deduplication and topic comparisons to the project's reporting tools.

Prepare a content planning brief

Collect Shorts relevant to basketball, cooking, or science from the returned results. Give editors example titles, links, durations, and public counts to inform original ideas.

Build a creator discovery shortlist

Group relevant Shorts by public channel and shortlist creators for a partnership review. Include the videos that explain each choice.

Compare video lengths

Compare durations and public engagement across Shorts about the same topic. Use the results to propose length tests for your next production cycle.

Review title patterns

Sort returned titles into questions, challenges, demonstrations, and other editorial formats. Attach example links and counts so an editor can inspect the evidence.

Maintain a discovery digest

Collect results on a schedule and remove previously seen video IDs. Summarize newly encountered Shorts for a public brand or creator's editorial team.

Compare engagement within a batch

Calculate likes and comments per thousand views for returned Shorts with the required counts. Rank comparable topics to choose examples for a manual review.

Questions about YouTube trending Shorts in Gemini CLI

Can Gemini CLI use YouTube trending Shorts?

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

How much does YouTube trending Shorts 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 YouTube trending Shorts in Gemini CLI?

No. Spiral runs YouTube trending Shorts 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 trending Shorts in Gemini CLI?

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

Does Gemini CLI wait while YouTube trending Shorts runs?

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

How many Shorts does one call return?

ScrapeCreators documents about 48 Shorts per request. Repeat calls can return new Shorts, so use that number as an approximate batch size.

How fresh are the results?

ScrapeCreators says it fetches the latest available YouTube information when requested. Its documentation also says repeat requests can return new Shorts.

Does this include private creator analytics?

The data covers public Shorts metadata and engagement counts. Private Studio measurements such as retention and viewed-versus-swiped-away are outside its scope.

What does a Shorts view count measure?

YouTube counts a view when a Short starts playing. A public view count therefore does not establish that viewers watched the whole video.

Why might engagement counts stop changing?

YouTube checks engagement for legitimacy and may temporarily slow, freeze, or revise counts. A fresh retrieval can still contain a counter that YouTube is validating.

Get started

Start using YouTube trending Shorts 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