lucianfialho/gmp-cli/gmp-yt

Claude Code and agent skill by lucianfialho/gmp-cli

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

YouTube Data API v3: channel stats, video performance, and public video search.

Install

npx vskill@latest install lucianfialho/gmp-cli/gmp-yt

SKILL.md

yt (YouTube Data API v3)

PREREQUISITE: Read ../gmp-shared/SKILL.md for auth, global flags, and output formats.
bash
gmp yt <command> [flags]

Commands

CommandDescription
`videos`List channel videos with views, likes and comments
channelChannel overview: subscribers, total views, video count
videoStats for one or more videos by ID
searchSearch public videos (100 quota units per call)

Credentials

gmp yt accepts either an API key or the standard OAuth login. Prefer the API key: these are public metrics and the key never expires.

bash
export YOUTUBE_API_KEY=AIza...       # APIs & Services > Credentials
export YOUTUBE_CHANNEL_ID=@handle    # optional default channel

Requires YouTube Data API v3 to be enabled in the Google Cloud project. Without YOUTUBE_API_KEY, the CLI falls back to the gmp auth login token (scope youtube.readonly), and omitting --channel then resolves to the authenticated user's own channel.

Channel References

--channel accepts either form:

FormExample
Channel IDUCBJycsmduvYEL83R_U4JriQ
Handle@mkbhd

Quick Reference

Channel overview
bash
gmp yt channel -c @mkbhd
gmp yt channel -c UCBJycsmduvYEL83R_U4JriQ -f json

Columns: channelId, title, handle, subscribers, totalViews, videoCount, publishedAt.

Video stats by ID
bash
gmp yt video -i dQw4w9WgXcQ
gmp yt video -i dQw4w9WgXcQ,9bZkp7q19f0 -f table
Search public videos
bash
gmp yt search -q "product analytics" -n 20
gmp yt search -q "tutorial" -c UCBJycsmduvYEL83R_U4JriQ -o viewCount
FlagDefaultDescription
-q, --query <q>--Search query (required)
-c, --channel <id>--Restrict to a channel ID (UC... only)
-n, --limit <n>10Max results (1-50)
-o, --order <order>relevancerelevance, date, viewCount, rating

Quota

Default allowance is 10,000 units per day.

CommandCost
yt channel1 unit
yt videos~2 units per 50 videos
yt video1 unit per 50 IDs
yt search101 units

Avoid yt search in loops. To enumerate a channel, yt videos walks the uploads playlist and costs about 50x less.

Scope

Public metrics only. Watch time, audience retention, impression CTR, traffic sources and demographics belong to the YouTube Analytics API, which is a different API and is not implemented in this CLI.

See Also

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
32
Repository forks
3
7-day trend score
22

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/lucianfialho/gmp-cli/gmp-yt/badge)](https://verified-skill.com/skills/lucianfialho/gmp-cli/gmp-yt)

Something wrong with this skill or its page? Tell us.