---
slug: "pi-youtube-transcript"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/jonjonrankin/pi-youtube-transcript@main/README.md"
repo: "https://github.com/jonjonrankin/pi-youtube-transcript"
source_file: "README.md"
branch: "main"
---
# pi-youtube-transcript

A [pi](https://pi.dev) extension that fetches YouTube video transcripts via the [`youtube-transcript`](https://github.com/Kakulukian/youtube-transcript) library.

## Install

```bash
pi install npm:pi-youtube-transcript
```

## Usage

The extension registers a `youtube_transcript` tool that pi agents can call automatically when you ask about a YouTube video's content.

**Example prompt:**

> Use youtube_transcript to summarize https://youtube.com/watch?v=dQw4w9WgXcQ

### Supported URL formats

- `https://youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO_ID`
- `https://youtube.com/shorts/VIDEO_ID`
- `https://www.youtube.com/live/VIDEO_ID`
- Bare 11-character video IDs

### Language

By default the tool returns the first available transcript. To request a specific language, the agent will pass a `lang` parameter (ISO language code like `"en"`, `"es"`, `"fr"`).

## License

MIT