Package Exports
- @aitofy/youtube
Readme
@aitofy/youtube
đŦ Free YouTube utilities for Node.js - Get transcripts, channel videos, video info without API key
â ī¸ Disclaimer
This package accesses YouTube's internal APIs for educational and personal use. It may violate YouTube's Terms of Service. Use at your own risk. The authors are not responsible for any misuse or consequences.
⨠Features
- đ Get Transcripts - Fetch video captions/subtitles in multiple formats
- đē List Channel Videos - Get all videos from any YouTube channel
- đ Search Videos - Search YouTube programmatically
- âšī¸ Video Info - Get metadata, views, duration, thumbnails
- đ¤ MCP Integration - Use with Claude, ChatGPT, and other AI assistants
- đĢ No API Key Required - Works out of the box
- đĻ Zero Config - Just install and use
đĻ Installation
npm install @aitofy/youtubeyarn add @aitofy/youtubepnpm add @aitofy/youtubeđ Quick Start
Get Transcript
import { getTranscript, getTranscriptText } from '@aitofy/youtube';
// Get transcript as segments
const segments = await getTranscript('dQw4w9WgXcQ');
console.log(segments);
// [
// { start: 0.24, duration: 2.5, text: 'Never gonna give you up' },
// { start: 2.74, duration: 2.3, text: 'Never gonna let you down' },
// ...
// ]
// Get transcript as plain text
const text = await getTranscriptText('dQw4w9WgXcQ');
console.log(text);
// "Never gonna give you up\nNever gonna let you down\n..."Get Channel Videos
import { getChannelVideos } from '@aitofy/youtube';
// By channel ID
const videos = await getChannelVideos('UCsBjURrPoezykLs9EqgamOA');
// By handle
const videos = await getChannelVideos('@Fireship');
// With options
const videos = await getChannelVideos({
channel: '@Fireship',
limit: 50,
sortBy: 'popular', // 'newest' | 'oldest' | 'popular'
});
console.log(videos);
// [
// { videoId: 'abc123', title: 'Video Title', viewCount: 12345, ... },
// ...
// ]Search Videos
import { searchVideos } from '@aitofy/youtube';
const results = await searchVideos('nodejs tutorial');
// With options
const results = await searchVideos({
query: 'react hooks',
limit: 20,
sortBy: 'viewCount', // 'relevance' | 'date' | 'viewCount' | 'rating'
});Get Video Info
import { getVideoInfo } from '@aitofy/youtube';
const info = await getVideoInfo('dQw4w9WgXcQ');
console.log(info);
// {
// videoId: 'dQw4w9WgXcQ',
// title: 'Rick Astley - Never Gonna Give You Up',
// duration: '3:33',
// viewCount: 1500000000,
// channelTitle: 'Rick Astley',
// thumbnails: { ... },
// ...
// }đ API Reference
Transcript Functions
| Function | Description |
|---|---|
getTranscript(videoId, options?) |
Get transcript segments |
getTranscriptText(videoId, options?) |
Get transcript as plain text |
getTranscriptSRT(videoId, options?) |
Get transcript as SRT subtitles |
getTranscriptVTT(videoId, options?) |
Get transcript as WebVTT |
listTranscripts(videoId) |
List available transcript languages |
Channel Functions
| Function | Description |
|---|---|
getChannelVideos(options) |
Get videos from a channel |
getChannelInfo(channel) |
Get channel metadata |
Video Functions
| Function | Description |
|---|---|
getVideoInfo(videoId) |
Get detailed video info |
getBasicVideoInfo(videoId) |
Get basic video info (faster) |
searchVideos(query, options?) |
Search YouTube videos |
đ§ Options
Transcript Options
interface FetchTranscriptOptions {
languages?: string[]; // Preferred languages, e.g. ['en', 'vi']
preferGenerated?: boolean; // Prefer auto-generated over manual
}Channel Videos Options
interface GetChannelVideosOptions {
channel: string; // Channel ID, URL, or @handle
limit?: number; // Max videos (default: 15)
sortBy?: 'newest' | 'oldest' | 'popular';
contentType?: 'videos' | 'shorts' | 'streams';
}Search Options
interface SearchOptions {
query: string;
limit?: number;
sortBy?: 'relevance' | 'date' | 'viewCount' | 'rating';
}đ¯ Use Cases
- đ Content Analysis - Analyze video transcripts for SEO
- đ¤ AI/ML Training - Collect transcripts for datasets
- đą App Development - Build YouTube-related apps
- đ Research - Academic video content analysis
- âŋ Accessibility - Generate subtitles for accessibility
đ¤ MCP Integration (Claude, ChatGPT)
Use YouTube tools directly in AI assistants via Model Context Protocol.
Setup for Claude Desktop
- Install the package globally:
npm install -g @aitofy/youtube- Add to Claude's config (
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"youtube": {
"command": "youtube-mcp"
}
}
}- Restart Claude Desktop
Available MCP Tools
| Tool | Description |
|---|---|
get_youtube_transcript |
Get video transcript with timestamps |
get_youtube_transcript_text |
Get transcript as plain text |
list_youtube_transcripts |
List available languages |
get_youtube_video_info |
Get video metadata |
get_youtube_channel_videos |
List channel videos |
get_youtube_channel_info |
Get channel info |
search_youtube_videos |
Search YouTube |
Example Usage in Claude
You: Get the transcript for YouTube video dQw4w9WgXcQ
Claude: [Uses get_youtube_transcript tool]
Here's the transcript for "Never Gonna Give You Up"...⥠Rate Limiting
To avoid being blocked by YouTube:
// Add delays between requests
const sleep = (ms: number) => new Promise(r => setTimeout(r, ms));
for (const videoId of videoIds) {
const transcript = await getTranscript(videoId);
await sleep(1000); // Wait 1 second between requests
}đ¤ Contributing
Contributions are welcome! Please read our contributing guidelines.
đ License
MIT Š Aitofy
đ Credits
Inspired by:
- youtube-transcript-api (Python)
- youtubei.js