mcp-video-analyzer 0.2.1 → 0.2.2

package/dist/adapters/adapter.interface.js

@@ -14,4 +14,3 @@ export function getAdapter(url) {
 export function clearAdapters() {
     adapters.length = 0;
 }
-//# sourceMappingURL=adapter.interface.js.map

package/dist/adapters/direct.adapter.js

@@ -64,4 +64,3 @@ export class DirectAdapter {
         return destPath;
     }
 }
-//# sourceMappingURL=direct.adapter.js.map

package/dist/adapters/loom.adapter.d.ts

@@ -10,4 +10,5 @@ export declare class LoomAdapter implements IVideoAdapter {
     getChapters(_url: string): Promise<IChapter[]>;
     getAiSummary(_url: string): Promise<string | null>;
     downloadVideo(url: string, destDir: string): Promise<string | null>;
+    private fetchVideoUrl;
 }

package/dist/adapters/loom.adapter.js

@@ -1,7 +1,9 @@
 import { execFile as execFileCb } from 'node:child_process';
 import { promisify } from 'node:util';
 import { join } from 'node:path';
-import { existsSync } from 'node:fs';
+import { existsSync, createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
 import { detectPlatform, extractLoomId } from '../utils/url-detector.js';
 import { parseVtt } from '../utils/vtt-parser.js';
 const execFile = promisify(execFileCb);
@@ -122,21 +124,68 @@ export class LoomAdapter {
         return null;
     }
     async downloadVideo(url, destDir) {
-        // Try yt-dlp for Loom video download (works without auth for public videos)
-        const ytDlp = await findYtDlp();
-        if (!ytDlp)
-            return null;
         const videoId = extractLoomId(url);
         const outputPath = join(destDir, `${videoId ?? 'loom_video'}.mp4`);
+        // Strategy 1: yt-dlp (best quality, handles edge cases)
+        const ytDlp = await findYtDlp();
+        if (ytDlp) {
+            try {
+                await execFile(ytDlp.bin, [...ytDlp.prefix, '-o', outputPath, '--no-warnings', '-q', url], {
+                    timeout: 120000,
+                });
+                if (existsSync(outputPath))
+                    return outputPath;
+            }
+            catch {
+                // Fall through to direct download
+            }
+        }
+        // Strategy 2: Direct HTTP download via Loom CDN URL
+        if (!videoId)
+            return null;
+        const videoUrl = await this.fetchVideoUrl(videoId);
+        if (videoUrl) {
+            try {
+                const response = await fetch(videoUrl);
+                if (response.ok && response.body) {
+                    const nodeStream = Readable.fromWeb(response.body);
+                    await pipeline(nodeStream, createWriteStream(outputPath));
+                    if (existsSync(outputPath))
+                        return outputPath;
+                }
+            }
+            catch {
+                // Download failed
+            }
+        }
+        return null;
+    }
+    async fetchVideoUrl(videoId) {
+        // Loom exposes video URLs through their fetch endpoint
         try {
-            await execFile(ytDlp.bin, [...ytDlp.prefix, '-o', outputPath, '--no-warnings', '-q', url], {
-                timeout: 120000,
+            const response = await fetch(`https://www.loom.com/api/campaigns/sessions/${videoId}/transcoded-url`, {
+                method: 'POST',
+                headers: GRAPHQL_HEADERS,
+                body: JSON.stringify({}),
             });
-            return existsSync(outputPath) ? outputPath : null;
+            if (response.ok) {
+                const data = (await response.json());
+                if (data.url)
+                    return data.url;
+            }
         }
         catch {
-            return null;
+            // Try alternative approach
+        }
+        // Fallback: query the GraphQL API for video source URL
+        const data = await loomGraphQL(`query GetVideoUrl($videoId: ID!, $password: String) {
+        getVideo(id: $videoId, password: $password) {
+          ... on RegularUserVideo {
+            source_url
+          }
         }
+      }`, { videoId, password: null });
+        return data?.getVideo?.source_url ?? null;
     }
 }
 function flattenComments(comments) {
@@ -180,4 +229,3 @@ async function findYtDlp() {
         return null;
     }
 }
-//# sourceMappingURL=loom.adapter.js.map

package/dist/config/detail-levels.js

@@ -27,4 +27,3 @@ export const DETAIL_CONFIGS = {
 export function getDetailConfig(level) {
     return DETAIL_CONFIGS[level];
 }
-//# sourceMappingURL=detail-levels.js.map

package/dist/index.js

@@ -2,4 +2,3 @@
 import { createServer } from './server.js';
 const server = createServer();
 server.start({ transportType: 'stdio' });
-//# sourceMappingURL=index.js.map

package/dist/processors/annotated-timeline.js

@@ -80,4 +80,3 @@ export function parseTimeToSeconds(time) {
     }
     return 0;
 }
-//# sourceMappingURL=annotated-timeline.js.map

package/dist/processors/audio-transcriber.js

@@ -188,4 +188,3 @@ async function loadTransformers() {
         return null;
     }
 }
-//# sourceMappingURL=audio-transcriber.js.map

package/dist/processors/browser-frame-extractor.js

@@ -129,4 +129,3 @@ async function loadPuppeteer() {
         return null;
     }
 }
-//# sourceMappingURL=browser-frame-extractor.js.map

package/dist/processors/frame-dedup.d.ts

@@ -1,4 +1,17 @@
 import type { IFrameResult } from '../types.js';
+/**
+ * Check if a frame is effectively black/blank.
+ * Computes the mean brightness of the image — if below threshold, it's black.
+ */
+export declare function isBlackFrame(filePath: string, threshold?: number): Promise<boolean>;
+/**
+ * Filter out black/blank frames from the array.
+ * Returns the filtered frames and count of removed frames.
+ */
+export declare function filterBlackFrames(frames: IFrameResult[], threshold?: number): Promise<{
+    frames: IFrameResult[];
+    removedCount: number;
+}>;
 /**
  * Compute a difference hash (dHash) for an image.
  * Resize to 9x8 grayscale, then compare each pixel to its right neighbor.

package/dist/processors/frame-dedup.js

@@ -1,6 +1,38 @@
 import sharp from 'sharp';
 const HASH_WIDTH = 9;
 const HASH_HEIGHT = 8;
+/**
+ * Check if a frame is effectively black/blank.
+ * Computes the mean brightness of the image — if below threshold, it's black.
+ */
+export async function isBlackFrame(filePath, threshold = 10) {
+    try {
+        const { channels } = await sharp(filePath).stats();
+        // Average the mean of all channels (R, G, B)
+        const meanBrightness = channels.reduce((sum, ch) => sum + ch.mean, 0) / channels.length;
+        return meanBrightness < threshold;
+    }
+    catch {
+        return false; // If we can't analyze, keep the frame
+    }
+}
+/**
+ * Filter out black/blank frames from the array.
+ * Returns the filtered frames and count of removed frames.
+ */
+export async function filterBlackFrames(frames, threshold = 10) {
+    if (frames.length === 0)
+        return { frames, removedCount: 0 };
+    const results = await Promise.all(frames.map(async (frame) => ({
+        frame,
+        isBlack: await isBlackFrame(frame.filePath, threshold),
+    })));
+    const filtered = results.filter((r) => !r.isBlack).map((r) => r.frame);
+    return {
+        frames: filtered,
+        removedCount: frames.length - filtered.length,
+    };
+}
 /**
  * Compute a difference hash (dHash) for an image.
  * Resize to 9x8 grayscale, then compare each pixel to its right neighbor.
@@ -73,4 +105,3 @@ export async function deduplicateFrames(frames, maxDistance = 5) {
     }
     return result;
 }
-//# sourceMappingURL=frame-dedup.js.map

package/dist/processors/frame-extractor.js

@@ -198,4 +198,3 @@ async function listFrameFiles(dir, prefix) {
     const files = await readdir(dir);
     return files.filter((f) => f.startsWith(prefix) && f.endsWith('.jpg')).sort();
 }
-//# sourceMappingURL=frame-extractor.js.map

package/dist/processors/frame-ocr.js

@@ -42,4 +42,3 @@ async function loadTesseract() {
         return null;
     }
 }
-//# sourceMappingURL=frame-ocr.js.map

package/dist/processors/image-optimizer.js

@@ -18,4 +18,3 @@ export async function optimizeFrames(inputPaths, outputDir, options = {}) {
     }
     return results;
 }
-//# sourceMappingURL=image-optimizer.js.map

package/dist/server.js

@@ -12,7 +12,7 @@ import { registerAnalyzeMoment } from './tools/analyze-moment.js';
 export function createServer() {
     const server = new FastMCP({
         name: 'mcp-video-analyzer',
-        version: '0.2.0',
+        version: '0.2.2',
         instructions: `Video analysis MCP server. Extracts transcripts, key frames, metadata, comments, OCR text, and annotated timelines from video URLs.
 
 AUTOMATIC BEHAVIOR — Do NOT wait for the user to ask:
@@ -64,4 +64,3 @@ Decision flow:
     registerAnalyzeMoment(server);
     return server;
 }
-//# sourceMappingURL=server.js.map

package/dist/tools/analyze-moment.js

@@ -142,4 +142,3 @@ function parseTimestampLoose(ts) {
         return isNaN(n) ? null : n;
     }
 }
-//# sourceMappingURL=analyze-moment.js.map

package/dist/tools/analyze-video.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { getAdapter } from '../adapters/adapter.interface.js';
 import { extractSceneFrames, extractDenseFrames, probeVideoDuration, formatTimestamp, } from '../processors/frame-extractor.js';
 import { extractBrowserFrames, generateTimestamps } from '../processors/browser-frame-extractor.js';
-import { deduplicateFrames } from '../processors/frame-dedup.js';
+import { deduplicateFrames, filterBlackFrames } from '../processors/frame-dedup.js';
 import { extractTextFromFrames } from '../processors/frame-ocr.js';
 import { buildAnnotatedTimeline } from '../processors/annotated-timeline.js';
 import { optimizeFrames } from '../processors/image-optimizer.js';
@@ -244,7 +244,17 @@ Use options.forceRefresh to bypass the cache.`,
                     if (!framesExtracted) {
                         warnings.push('Frame extraction not available — returning transcript and metadata only. Install yt-dlp or Chrome/Chromium for frame extraction.');
                     }
-                    // Post-processing: dedup, OCR, timeline
+                    // Post-processing: filter black frames, dedup, OCR, timeline
+                    if (result.frames.length > 0) {
+                        const blackResult = await filterBlackFrames(result.frames).catch(() => ({
+                            frames: result.frames,
+                            removedCount: 0,
+                        }));
+                        if (blackResult.removedCount > 0) {
+                            warnings.push(`Removed ${blackResult.removedCount} black/blank frame(s) — video may be DRM-protected`);
+                        }
+                        result.frames = blackResult.frames;
+                    }
                     if (result.frames.length > 0) {
                         const beforeDedup = result.frames.length;
                         result.frames = await deduplicateFrames(result.frames).catch((e) => {
@@ -317,4 +327,3 @@ Use options.forceRefresh to bypass the cache.`,
         },
     });
 }
-//# sourceMappingURL=analyze-video.js.map

package/dist/tools/get-frame-at.js

@@ -85,4 +85,3 @@ Returns: A single image of the video frame at the specified timestamp.`,
         },
     });
 }
-//# sourceMappingURL=get-frame-at.js.map

package/dist/tools/get-frame-burst.js

@@ -103,4 +103,3 @@ Returns: N images evenly distributed between the from and to timestamps.`,
         },
     });
 }
-//# sourceMappingURL=get-frame-burst.js.map

package/dist/tools/get-frames.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { getAdapter } from '../adapters/adapter.interface.js';
 import { extractSceneFrames, extractDenseFrames, probeVideoDuration, formatTimestamp, } from '../processors/frame-extractor.js';
 import { extractBrowserFrames, generateTimestamps } from '../processors/browser-frame-extractor.js';
-import { deduplicateFrames } from '../processors/frame-dedup.js';
+import { deduplicateFrames, filterBlackFrames } from '../processors/frame-dedup.js';
 import { optimizeFrames } from '../processors/image-optimizer.js';
 import { createTempDir } from '../utils/temp-files.js';
 const GetFramesSchema = z.object({
@@ -115,6 +115,17 @@ Supports: Loom (loom.com/share/...) and direct video URLs (.mp4, .webm, .mov).`,
                     return [];
                 });
             }
+            // Filter black/blank frames
+            if (frames.length > 0) {
+                const blackResult = await filterBlackFrames(frames).catch(() => ({
+                    frames,
+                    removedCount: 0,
+                }));
+                if (blackResult.removedCount > 0) {
+                    warnings.push(`Removed ${blackResult.removedCount} black/blank frame(s) — video may be DRM-protected`);
+                }
+                frames = blackResult.frames;
+            }
             // Dedup
             if (frames.length > 0) {
                 const before = frames.length;
@@ -140,4 +151,3 @@ Supports: Loom (loom.com/share/...) and direct video URLs (.mp4, .webm, .mov).`,
         },
     });
 }
-//# sourceMappingURL=get-frames.js.map

package/dist/tools/get-metadata.js

@@ -62,4 +62,3 @@ Supports: Loom (loom.com/share/...) and direct video URLs (.mp4, .webm, .mov).`,
         },
     });
 }
-//# sourceMappingURL=get-metadata.js.map

package/dist/tools/get-transcript.js

@@ -79,4 +79,3 @@ Supports: Loom (loom.com/share/...) and direct video URLs (.mp4, .webm, .mov).`,
         },
     });
 }
-//# sourceMappingURL=get-transcript.js.map

package/dist/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/utils/cache.js

@@ -84,4 +84,3 @@ function sortKeys(obj) {
     }
     return sorted;
 }
-//# sourceMappingURL=cache.js.map

package/dist/utils/field-filter.js

@@ -29,4 +29,3 @@ export function filterAnalysisResult(result, fields) {
     }
     return filtered;
 }
-//# sourceMappingURL=field-filter.js.map

package/dist/utils/temp-files.js

@@ -25,4 +25,3 @@ function cleanupAllTempDirs() {
     activeTempDirs.clear();
 }
 process.on('exit', cleanupAllTempDirs);
-//# sourceMappingURL=temp-files.js.map

package/dist/utils/url-detector.js

@@ -30,4 +30,3 @@ function getExtension(pathname) {
         return null;
     return pathname.slice(lastDot).toLowerCase();
 }
-//# sourceMappingURL=url-detector.js.map

package/dist/utils/vtt-parser.js

@@ -82,4 +82,3 @@ function formatTimestamp(vttTimestamp) {
     }
     return `${minutes}:${String(seconds).padStart(2, '0')}`;
 }
-//# sourceMappingURL=vtt-parser.js.map

package/package.json

@@ -1,78 +1,81 @@
-{
-  "name": "mcp-video-analyzer",
-  "version": "0.2.1",
-  "description": "MCP server for video analysis — extracts transcripts, key frames, OCR text, and metadata from video URLs. Supports Loom and direct video files.",
-  "author": "guimatheus92",
-  "license": "MIT",
-  "homepage": "https://github.com/guimatheus92/mcp-video-analyzer#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/guimatheus92/mcp-video-analyzer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/guimatheus92/mcp-video-analyzer/issues"
-  },
-  "bin": {
-    "mcp-video-analyzer": "./dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "type": "module",
-  "scripts": {
-    "build": "tsc",
-    "prepare": "npm run build",
-    "dev": "npx fastmcp dev src/index.ts",
-    "inspect": "npx fastmcp inspect src/index.ts",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"*.config.*\" \"*.json\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"*.config.*\"",
-    "typecheck": "tsc --noEmit",
-    "knip": "knip",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "vitest run --config vitest.e2e.config.ts",
-    "check": "npm run format:check && npm run lint && npm run typecheck && npm run knip && npm run test",
-    "prepublishOnly": "npm run check && npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "video",
-    "video-analysis",
-    "loom",
-    "transcript",
-    "frames",
-    "ocr",
-    "screen-recording",
-    "claude",
-    "ai"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "cheerio": "^1.2.0",
-    "fastmcp": "^3.34.0",
-    "ffmpeg-static": "^5.3.0",
-    "puppeteer-core": "^24.39.0",
-    "sharp": "^0.34.5",
-    "tesseract.js": "^7.0.0",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@types/node": "^25.4.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^10.0.3",
-    "knip": "^5.86.0",
-    "prettier": "^3.8.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "mcp-video-analyzer",
+  "version": "0.2.2",
+  "description": "MCP server for video analysis — extracts transcripts, key frames, OCR text, and metadata from video URLs. Supports Loom and direct video files.",
+  "author": "guimatheus92",
+  "license": "MIT",
+  "homepage": "https://github.com/guimatheus92/mcp-video-analyzer#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guimatheus92/mcp-video-analyzer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/guimatheus92/mcp-video-analyzer/issues"
+  },
+  "bin": {
+    "mcp-video-analyzer": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "dev": "npx fastmcp dev src/index.ts",
+    "inspect": "npx fastmcp inspect src/index.ts",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"*.config.*\" \"*.json\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"*.config.*\"",
+    "typecheck": "tsc --noEmit",
+    "knip": "knip",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run knip && npm run test",
+    "test:smoke": "npm run build && npx tsx scripts/smoke-test.ts",
+    "verify-package": "npm run build && npx tsx scripts/verify-package.ts",
+    "prepublishOnly": "npm run check && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "video",
+    "video-analysis",
+    "loom",
+    "transcript",
+    "frames",
+    "ocr",
+    "screen-recording",
+    "claude",
+    "ai"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "cheerio": "^1.2.0",
+    "fastmcp": "^3.34.0",
+    "ffmpeg-static": "^5.3.0",
+    "puppeteer-core": "^24.39.0",
+    "sharp": "^0.34.5",
+    "tesseract.js": "^7.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.4.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.3",
+    "knip": "^5.86.0",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.0",
+    "vitest": "^4.0.18"
+  }
+}