How do I install the Stophy CLI?

Use curl -fsSL https://stophy.dev/install.sh | bash on macOS and Linux, brew install stophydotdev/tap/stophy with Homebrew, npm install -g @stophy/cli or bun install -g @stophy/cli with a JS runtime, or winget install stophydotdev.stophy on Windows.

Do I need Node.js to use the CLI?

No, if you install the standalone binary via curl, Homebrew, or winget. The npm and bun installs require Node.js 18+ or Bun 1.0+ respectively.

How do I authenticate?

Run stophy login --browser to sign in through your browser, pass stophy login --api-key st_xxx with a key from the dashboard, or export STOPHY_API_KEY in your shell.

Can I run commands without installing globally?

Yes. Use npx -y @stophy/cli with npm or bunx @stophy/cli with Bun.

CLI

Stophy CLI

Install the Stophy CLI with curl, npm, bun, Homebrew, or winget. Search YouTube, fetch transcripts, and return structured JSON from the terminal.

Get an API key Read the docs

The Stophy CLI puts every YouTube data endpoint behind one terminal command. Search, pull transcripts, read comments, inspect channels, browse playlists, and get query suggestions. All structured JSON on stdout.

Install with curl, npm, bun, Homebrew, or winget. Log in through your browser or set an API key. Pipe output to jq, save it to a file, or feed it straight into an agent workflow.

Install

Pick your package manager. All methods install the same stophy command.

Standalone binary for macOS and Linux. No Node.js required.

curl

1curl -fsSL https://stophy.dev/install.sh | bash

Authenticate

1stophy login --browser

Or set STOPHY_API_KEY=st_xxx in your environment.

One-command agent setup: npx -y @stophy/cli init --all --browser. Full command reference in the CLI docs.

Example command

Every command returns JSON on stdout. Pipe it to jq, save it to a file, or feed it into an agent workflow.

Command

1stophy search --q "typescript tutorial" --type video --json

Output

1{
2  "data": {
3    "results": [
4      {
5        "id": "YkOSUVzOAA4",
6        "title": "T3 Stack Tutorial - FROM 0 TO PROD FOR $0",
7        "author": "Theo - t3.gg",
8        "viewCount": 537700,
9        "duration": "2:59:03"
10      }
11    ]
12  }
13}

credits

1stophy credits

What you get

Five install methods

curl and Homebrew ship a standalone binary with no Node.js. npm and bun install the @stophy/cli package. winget covers Windows.

JSON on stdout

Every command returns structured JSON on stdout. Status messages and prompts go to stderr so piping stays clean.

Browser or API key auth

Run stophy login --browser once, paste an API key directly, or set STOPHY_API_KEY in your environment.

Agent-ready output

Install agent skills for Claude Code, Cursor, and other tools. One init command sets up the CLI, skills, and auth.

Common use cases

Search YouTube from a terminal session and pipe titles into another tool
Pull a transcript and extract plain text with jq for an LLM prompt
Inspect a channel catalog before ingesting videos into a knowledge base
Script credit checks and usage reports in CI or local dev workflows

Frequently asked questions

How do I install the Stophy CLI?: Use curl -fsSL https://stophy.dev/install.sh | bash on macOS and Linux, brew install stophydotdev/tap/stophy with Homebrew, npm install -g @stophy/cli or bun install -g @stophy/cli with a JS runtime, or winget install stophydotdev.stophy on Windows.
Do I need Node.js to use the CLI?: No, if you install the standalone binary via curl, Homebrew, or winget. The npm and bun installs require Node.js 18+ or Bun 1.0+ respectively.
How do I authenticate?: Run stophy login --browser to sign in through your browser, pass stophy login --api-key st_xxx with a key from the dashboard, or export STOPHY_API_KEY in your shell.
Can I run commands without installing globally?: Yes. Use npx -y @stophy/cli <command> with npm or bunx @stophy/cli <command> with Bun.

Related surfaces

Stophy MCP Server

MCP

YouTube Search API

YouTube Transcript API

Transcripts

YouTube Video Details API

Video details

← All APIs