How to Use YouTube channel profile in Gemini CLI
Returns a channel's identity, public subscriber total, video and view totals, and linked websites or social accounts. Use it to assess a known creator or brand before researching its content.
Prompts to try with YouTube channel profile in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use YouTube channel profile for @NASA and add its name, public subscriber total, and published links to the channel directory in this project.
Use YouTube channel profile for @Google and @Microsoft, then populate a comparison table with their public subscriber, video, and view totals.
Scrape https://example.com/pricing with YouTube channel profile and turn it into a comparison table. Save the result in ./assets.
Crawl the docs at https://docs.example.com with YouTube channel profile and summarize each section.
Pull the latest posts from this blog with YouTube channel profile and list their titles and dates.
How to set up YouTube channel profile in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 channel profile
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-channel", "input": { "url": "https://www.youtube.com/@ThePatMcAfeeShow" } }'
Then paste one of the prompts above: Gemini CLI finds YouTube channel profile on Spiral, shows the price and runs it.
YouTube channel profile providers and prices
Spiral runs YouTube channel profile through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Cache max age | 1d, 3d, 7d, 14d, or 30d | If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details. |
Every API field of YouTube · Channel Details is on its tool page: open its card above.
What can you do with YouTube channel profile in Gemini CLI?
Build a YouTube research panel for public brands and creators. A coding agent can turn channel profiles or topic matches into structured project data and a readable view.
Creator partnership research
Compare public channel totals for a creator shortlist, then find each creator's content about the proposed campaign topic.
Competitor channel briefs
Pair competing brands' channel statistics with links to their content about a shared product category.
Public channel directory
Create directory entries from channel identities and published links, with selected topic matches to help readers choose what to watch.
Editorial source research
Identify the publishing channel behind a research source and collect its relevant videos, broadcasts, Shorts, and playlists for editorial review.
Weekly channel reports
Compare repeated channel snapshots and topic searches to report changes in public totals and newly encountered content links.
Learning resource selection
Compare educational channels using their public profiles, then assemble topic-specific viewing lists from matching content.
More on YouTube channel profile and Gemini CLI
YouTube channel profile in other agents
Questions about YouTube channel profile in Gemini CLI
Can Gemini CLI use YouTube channel profile?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run YouTube channel profile like any built-in tool.
How much does YouTube channel profile 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 channel profile in Gemini CLI?
No. Spiral runs YouTube channel profile 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 channel profile in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while YouTube channel profile runs?
YouTube channel profile runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
What information can these YouTube lookups access?
ScrapeCreators describes its source as publicly available information from third-party websites. These lookups cover public channel information and searchable content.
Does public channel research include private videos?
Private videos do not appear in YouTube search. Unlisted videos generally stay out of search too, although YouTube notes an exception when someone adds one to a public playlist.
Are public subscriber totals exact?
YouTube shortens public subscriber totals. A channel with 1 million to just under 10 million subscribers has a displayed total that changes in steps of 10,000.
What does a channel's country tell me?
The profile response can include one channel country, alongside its public links. That field describes the channel record; it does not establish where its viewers live.
Can keyword research cover more than standard videos?
YouTube channel content search can return four content types: videos, Shorts, live streams, and playlists. A topic brief should consider each returned collection.
Start using YouTube channel profile 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 https://spiral.ai/SKILL.md


