stophy login --browser           # opens browser
stophy login --api-key st_xxx    # paste key directly
export STOPHY_API_KEY="st_..."   # env var also works

Commands

search

stophy search --q "typescript tutorial" --type video --sortBy viewCount
stophy search --q "next.js" --uploadDate week --duration long

video details

stophy video details --url "https://youtube.com/watch?v=QRvfjPltvmE"

{
  "id": "QRvfjPltvmE",
  "title": "TraRags Reacts To Kendrick Lamar - GNX",
  "author": "TRA RAGS STREAMS",
  "viewCount": 204828,
  "likeCount": 9170,
  "durationText": "2 hours 42 minutes 27 seconds",
  "publishedAt": "2024-11-23T08:22:36.000Z"
}

video transcript

stophy video transcript --url "https://youtube.com/watch?v=..."

{
  "language": "en",
  "segments": [
    { "text": "what is up everybody", "start": 0.0, "duration": 1.96 },
    { "text": "welcome back to the channel", "start": 1.96, "duration": 2.0 }
  ]
}

video comments

stophy video comments --url "https://youtube.com/watch?v=QRvfjPltvmE" --sortBy top

{
  "items": [
    { "text": "\"Nah, that's not enough\" 😂", "author": "@terribletimes902", "likeCount": 2100 },
    { "text": "53:15 BRO CREAMED HIMSELF LIVE 😭😭😭😭", "author": "@Aunos1", "likeCount": 593 },
    { "text": "WHO ELSE BACK TO THIS AFTER THE ICEMAN REACTION?? 🙌🏾✊🏾", "author": "@colouredhearts", "likeCount": 134 }
  ],
  "continuationToken": "..."
}

channel

stophy channel --url "https://youtube.com/@t3dotgg" --tab video --sortBy popular

{
  "channel": {
    "name": "Theo - t3.gg",
    "handle": "@t3dotgg",
    "subscriberCount": "539K subscribers",
    "videoCount": "1K videos",
    "isVerified": true
  },
  "items": [
    { "title": "PirateSoftware is right, this needs to stop", "viewCount": 1000000, "duration": "15:14" }
  ]
}

playlist

stophy playlist --url "https://youtube.com/playlist?list=PLxxxx"

usage and logs

stophy usage --days 7
stophy logs --days 30 --endpoint /v1/video

All commands

Command	Description
`stophy login`	Authenticate with API key or browser
`stophy search`	Search YouTube by keyword
`stophy suggest`	Search autocomplete suggestions
`stophy video details`	Video metadata
`stophy video transcript`	Timestamped transcript
`stophy video comments`	Paginated comments
`stophy video replies`	Comment replies
`stophy channel`	Channel videos, shorts, playlists, or about
`stophy playlist`	All videos in a playlist
`stophy credits`	Remaining credit balance
`stophy usage`	API usage for your key
`stophy logs`	Request logs for your key
`stophy view-config`	Config and auth status
`stophy logout`	Clear saved credentials

Each command supports --help. Full docs at docs.stophy.dev.

Skills

Five agent skills included. Works with Claude Code, OpenCode, and any agent that supports skills.

npx skills add stophydotdev/cli

Skill	Description
`stophy-cli`	Full CLI reference
`stophy-search`	Search YouTube by keyword
`stophy-video`	Transcripts, comments, and metadata
`stophy-channel`	Browse channel catalogs
`stophy-playlist`	Fetch playlist contents