https://github.com/stophydotdev/cli
The CLI to search YouTube, get transcripts, read comments, and inspect channels
https://github.com/stophydotdev/cli
cli llm search stophy youtube youtube-api youtube-transcript
Last synced: 19 days ago
JSON representation
The CLI to search YouTube, get transcripts, read comments, and inspect channels
- Host: GitHub
- URL: https://github.com/stophydotdev/cli
- Owner: stophydotdev
- Created: 2026-05-22T14:23:22.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-30T19:36:34.000Z (19 days ago)
- Last Synced: 2026-06-30T20:24:20.208Z (19 days ago)
- Topics: cli, llm, search, stophy, youtube, youtube-api, youtube-transcript
- Language: TypeScript
- Homepage: https://stophy.dev
- Size: 141 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# @stophy/cli
YouTube context for AI agents. Search, transcripts, comments, channels, playlists — structured JSON from the terminal.
## Quick start
Install the CLI globally, add every Stophy skill to all supported AI agents, and authenticate in your browser:
```bash
npx -y @stophy/cli@latest init --all --browser
```
## Install
```bash
npm install -g @stophy/cli
```
Or install a standalone binary (no Node.js required):
```bash
# macOS / Linux
curl -fsSL https://stophy.dev/install.sh | bash
# Windows (PowerShell)
irm https://stophy.dev/install.ps1 | iex
# Homebrew
brew install stophydotdev/tap/stophy
```
The npm package requires Node.js 18 or later. Get an API key at [stophy.dev](https://stophy.dev/dashboard).
## Auth
```bash
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
```bash
stophy search --q "typescript tutorial" --type video --sortBy viewCount
stophy search --q "next.js" --uploadDate week --duration long
```
### video details
```bash
stophy video details --url "https://youtube.com/watch?v=QRvfjPltvmE"
```
```json
{
"video": {
"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"
},
"related": [
{ "id": "h6ukrWyqOm4", "title": "...", "author": "...", "viewCount": 12000 }
]
}
```
### video transcript
```bash
stophy video transcript --url "https://youtube.com/watch?v=..."
```
```json
{
"videoId": "QRvfjPltvmE",
"language": { "code": "en", "name": "English", "isAutoGenerated": true },
"segments": [
{ "text": "what is up everybody", "start": 0.0, "duration": 1.96 },
{ "text": "welcome back to the channel", "start": 1.96, "duration": 2.0 }
],
"text": "what is up everybody welcome back to the channel"
}
```
### video comments
```bash
stophy video comments --url "https://youtube.com/watch?v=QRvfjPltvmE" --sortBy top
```
```json
{
"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": "..."
}
```
### video livechat
```bash
stophy video livechat --url "https://youtube.com/watch?v=..." --chat-type top
```
```json
{
"status": "live",
"concurrentViewers": 1234,
"pollIntervalMs": 10000,
"messages": [
{ "text": "first!", "author": "@viewer1", "isModerator": false, "superChatAmount": null }
],
"continuationToken": "..."
}
```
### channel
```bash
stophy channel --url "https://youtube.com/@t3dotgg" --tab video --sortBy popular
```
```json
{
"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
```bash
stophy playlist --url "https://youtube.com/playlist?list=PLxxxx"
```
### usage and logs
```bash
stophy usage --days 7
stophy logs --days 30 --endpoint /v1/video
```
## All commands
| Command | What it does |
|---------|-------------|
| `stophy init --all --browser` | Install the CLI, all agent skills, and authenticate |
| `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 video livechat` | Livestream chat messages and status |
| `stophy channel` | Channel videos, Shorts, playlists, or about page |
| `stophy playlist` | Playlist videos and metadata |
| `stophy credits` | Remaining credit balance |
| `stophy usage` | API usage for your key |
| `stophy logs` | Request logs for your key |
| `stophy status` | Version, auth status, and credit balance |
| `stophy doctor` | Diagnose install, auth, and API connectivity |
| `stophy version` | CLI version and auth status |
| `stophy view-config` | Config and auth status |
| `stophy logout` | Clear saved credentials |
The CLI checks npm for a newer version in the background and prints a one-line
notice when an update is available. Set `STOPHY_NO_UPDATE_CHECK=1` to disable it.
Each command supports `--help`. Full docs at [docs.stophy.dev](https://docs.stophy.dev).
## Also see
- [@stophy/mcp](https://www.npmjs.com/package/@stophy/mcp) — MCP server for AI agents
- [stophydotdev/skills](https://github.com/stophydotdev/skills) — agent skills for the CLI (`npx skills add stophydotdev/skills`)
- [stophy.dev](https://stophy.dev) — dashboard and API keys
## License
MIT