pi-youtube-tools

Native Pi extension for YouTube Data API search, video details, and transcripts without an MCP daemon.

Packages

Package details

extension

Install pi-youtube-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-youtube-tools
Package
pi-youtube-tools
Version
0.1.1
Published
Jun 1, 2026
Downloads
not available
Author
eiei114
License
MIT
Types
extension
Size
43.1 KB
Dependencies
1 dependency · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi YouTube Tools

CI Publish npm version npm downloads License: MIT Pi package Trusted Publishing

Native Pi tools for YouTube search, video metadata, and transcripts — no MCP daemon required.

What this is

pi-youtube-tools adds YouTube Data API tools directly to Pi via registerTool(). Install with pi install, run /youtube:login, and search or inspect videos without running a separate MCP server process.

Use it when you want @kirbah/mcp-youtube-style capabilities inside Pi packages and skills, especially for game research and transcript workflows.

Features

  • youtube_search — search videos by query
  • youtube_video_details — title, channel, stats, optional description
  • youtube_transcript — fetch captions/transcript text (hook/outro or full)
  • /youtube:login — enter and store API key via Pi UI
  • /youtube:status — secret-safe API key configuration check
  • /youtube:logout — remove stored API key
  • LLM-friendly formatters with output size guards (planned)
  • Optional bundled skill for gameplay video research (planned)

Install

pi install npm:pi-youtube-tools

Or install from GitHub:

pi install git:github.com/eiei114/pi-youtube-tools

Configure your API key (pick one):

/youtube:login

Or set an environment variable:

$env:YOUTUBE_API_KEY="your_google_api_key"

Quick start

Try this package locally:

pi -e .

Then run:

/youtube:login
/youtube:status

Package contents

Path Purpose
extensions/ Pi TypeScript extension entrypoints
lib/ YouTube API client, config, formatters
skills/ Agent Skills (gameplay research, etc.)
prompts/ Prompt templates
docs/ Setup and release docs

Development

npm install
npm run ci

Release

This package is set up for npm Trusted Publishing, so no NPM_TOKEN is required.

npm version patch
git push --follow-tags

See docs/release.md for setup details.

Template checklist

After creating a repository from this template, follow docs/template-checklist.md.

More docs:

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

Never commit or log YOUTUBE_API_KEY. /youtube:login stores keys in ~/.pi/agent/pi-youtube-tools-auth.json (mode 600). /youtube:status reports configured/missing only.

For vulnerability reporting, see SECURITY.md.

Links

License

MIT