mcp-headless-youtube-transcript 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.1] - 2025-01-24
+
+### Fixed
+- **Binary Execution**: Fixed npx execution issue by explicitly defining files array in package.json
+- **File Permissions**: Ensured binary file maintains proper execute permissions when published
+
 ## [0.6.0] - 2025-01-24
 
 ### Added

package/build/index.js

@@ -3,7 +3,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 // @ts-ignore - Types are defined in global.d.ts
-import { getSubtitles, getChannelVideos, searchChannelVideos, getVideoComments, searchYouTubeGlobal } from 'headless-youtube-captions';
+import { getSubtitles, getChannelVideos, searchChannelVideos, getVideoComments, searchYouTubeGlobal, getVideoMetadata } from 'headless-youtube-captions';
 import { extractVideoId, extractChannelIdentifier, formatChannelUrl, truncateText, isValidYouTubeUrl, getSearchCacheKey } from './utils.js';
 // In-memory caches
 const transcriptCache = new Map();
@@ -205,6 +205,25 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ['query'],
                 },
             },
+            {
+                name: 'get_video_metadata',
+                description: 'Extract comprehensive video metadata including description, upload date, like count',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        videoId: {
+                            type: 'string',
+                            description: 'YouTube video ID or full URL',
+                        },
+                        expandDescription: {
+                            type: 'boolean',
+                            description: 'Whether to expand truncated descriptions. Defaults to true',
+                            default: true,
+                        },
+                    },
+                    required: ['videoId'],
+                },
+            },
             {
                 name: 'navigate_search_result',
                 description: 'Navigate to a video or channel page from search results',
@@ -541,6 +560,65 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             cleanupExpiredCache();
         }
     }
+    if (name === 'get_video_metadata') {
+        try {
+            const { videoId, expandDescription = true } = args;
+            // Extract video ID from URL if needed
+            const extractedVideoId = extractVideoId(videoId);
+            if (!extractedVideoId) {
+                throw new Error('Invalid YouTube video ID or URL');
+            }
+            // Check cache first - reuse the same cache key pattern
+            let cachedMetadata = getCachedTranscript(extractedVideoId, `metadata_${expandDescription}`);
+            if (cachedMetadata) {
+                try {
+                    const parsedMetadata = JSON.parse(cachedMetadata);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(parsedMetadata, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (e) {
+                    // Invalid cached data, proceed with fresh extraction
+                }
+            }
+            // Get video metadata using headless-youtube-captions
+            const metadata = await getVideoMetadata({
+                videoID: extractedVideoId,
+                expandDescription: expandDescription,
+            });
+            // Cache the result (using the transcript cache infrastructure)
+            setCachedTranscript(extractedVideoId, `metadata_${expandDescription}`, JSON.stringify(metadata));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(metadata, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting video metadata: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            // Cleanup expired cache entries after each request
+            cleanupExpiredCache();
+        }
+    }
     if (name === 'navigate_search_result') {
         try {
             const { resultUrl, resultType } = args;

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "mcp-headless-youtube-transcript",
-  "version": "0.6.0",
-  "description": "MCP server for extracting YouTube video transcripts using headless-youtube-captions",
+  "version": "0.7.0",
+  "description": "MCP server for extracting YouTube video transcripts, metadata, and comprehensive video information using headless-youtube-captions",
   "main": "build/index.js",
   "bin": {
     "mcp-headless-youtube-transcript": "build/index.js"
   },
   "type": "module",
+  "files": [
+    "build/index.js",
+    "build/index.d.ts",
+    "build/utils.js",
+    "build/utils.d.ts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
@@ -21,6 +30,8 @@
     "youtube",
     "transcript",
     "captions",
+    "metadata",
+    "description",
     "search",
     "automation"
   ],
@@ -36,7 +47,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "headless-youtube-captions": "^1.3.0"
+    "headless-youtube-captions": "^1.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",