@aitofy/youtube 0.1.0

package/dist/mcp.mjs

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import {
+  getChannelInfo,
+  getChannelVideos,
+  getTranscript,
+  getTranscriptText,
+  getVideoInfo,
+  listTranscripts,
+  searchVideos
+} from "./chunk-A6HJFYPT.mjs";
+
+// src/mcp.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var server = new Server(
+  {
+    name: "youtube-tools",
+    version: "0.1.0"
+  },
+  {
+    capabilities: {
+      tools: {}
+    }
+  }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "get_youtube_transcript",
+      description: "Get the transcript/subtitles of a YouTube video. Returns timestamped segments.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          video_id: {
+            type: "string",
+            description: "YouTube video ID or URL (e.g., dQw4w9WgXcQ)"
+          },
+          language: {
+            type: "string",
+            description: "Preferred language code (e.g., en, vi). Default: en"
+          }
+        },
+        required: ["video_id"]
+      }
+    },
+    {
+      name: "get_youtube_transcript_text",
+      description: "Get the transcript of a YouTube video as plain text (no timestamps).",
+      inputSchema: {
+        type: "object",
+        properties: {
+          video_id: {
+            type: "string",
+            description: "YouTube video ID or URL"
+          }
+        },
+        required: ["video_id"]
+      }
+    },
+    {
+      name: "list_youtube_transcripts",
+      description: "List available transcript languages for a YouTube video.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          video_id: {
+            type: "string",
+            description: "YouTube video ID or URL"
+          }
+        },
+        required: ["video_id"]
+      }
+    },
+    {
+      name: "get_youtube_video_info",
+      description: "Get detailed information about a YouTube video (title, views, duration, etc).",
+      inputSchema: {
+        type: "object",
+        properties: {
+          video_id: {
+            type: "string",
+            description: "YouTube video ID or URL"
+          }
+        },
+        required: ["video_id"]
+      }
+    },
+    {
+      name: "get_youtube_channel_videos",
+      description: "Get a list of videos from a YouTube channel.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          channel: {
+            type: "string",
+            description: "Channel ID, URL, or @handle (e.g., @Fireship)"
+          },
+          limit: {
+            type: "number",
+            description: "Maximum number of videos to return. Default: 15"
+          }
+        },
+        required: ["channel"]
+      }
+    },
+    {
+      name: "get_youtube_channel_info",
+      description: "Get information about a YouTube channel.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          channel: {
+            type: "string",
+            description: "Channel ID, URL, or @handle"
+          }
+        },
+        required: ["channel"]
+      }
+    },
+    {
+      name: "search_youtube_videos",
+      description: "Search for YouTube videos.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "Search query"
+          },
+          limit: {
+            type: "number",
+            description: "Maximum number of results. Default: 10"
+          }
+        },
+        required: ["query"]
+      }
+    }
+  ]
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  try {
+    switch (name) {
+      case "get_youtube_transcript": {
+        const videoId = args?.video_id;
+        const language = args?.language || "en";
+        const segments = await getTranscript(videoId, { languages: [language] });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(segments, null, 2)
+            }
+          ]
+        };
+      }
+      case "get_youtube_transcript_text": {
+        const videoId = args?.video_id;
+        const text = await getTranscriptText(videoId);
+        return {
+          content: [{ type: "text", text }]
+        };
+      }
+      case "list_youtube_transcripts": {
+        const videoId = args?.video_id;
+        const tracks = await listTranscripts(videoId);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(tracks, null, 2)
+            }
+          ]
+        };
+      }
+      case "get_youtube_video_info": {
+        const videoId = args?.video_id;
+        const info = await getVideoInfo(videoId);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(info, null, 2)
+            }
+          ]
+        };
+      }
+      case "get_youtube_channel_videos": {
+        const channel = args?.channel;
+        const limit = args?.limit || 15;
+        const videos = await getChannelVideos({ channel, limit });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(videos, null, 2)
+            }
+          ]
+        };
+      }
+      case "get_youtube_channel_info": {
+        const channel = args?.channel;
+        const info = await getChannelInfo(channel);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(info, null, 2)
+            }
+          ]
+        };
+      }
+      case "search_youtube_videos": {
+        const query = args?.query;
+        const limit = args?.limit || 10;
+        const results = await searchVideos({ query, limit });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(results, null, 2)
+            }
+          ]
+        };
+      }
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${message}`
+        }
+      ],
+      isError: true
+    };
+  }
+});
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("YouTube Tools MCP Server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@aitofy/youtube",
+  "version": "0.1.0",
+  "description": "Free YouTube utilities - get transcripts, channel videos, and more without API key",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "youtube-mcp": "./dist/mcp.js"
+  },
+  "scripts": {
+    "dev": "tsup src/index.ts src/mcp.ts --watch",
+    "build": "tsup src/index.ts src/mcp.ts --format cjs,esm --dts --clean",
+    "test": "npx tsx tests/test-typescript.ts",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "youtube",
+    "transcript",
+    "subtitles",
+    "captions",
+    "channel",
+    "videos",
+    "scraper",
+    "api",
+    "no-api-key",
+    "youtube-transcript",
+    "youtube-captions",
+    "youtube-subtitles",
+    "video-transcript",
+    "typescript",
+    "nodejs",
+    "mcp",
+    "claude",
+    "chatgpt",
+    "ai"
+  ],
+  "author": "Aitofy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aitofy-dev/youtube"
+  },
+  "homepage": "https://aitofy.dev",
+  "bugs": {
+    "url": "https://github.com/aitofy-dev/youtube/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "fast-xml-parser": "^4.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0"
+  }
+}