mcp-video-analyzer 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guilherme
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,245 @@
+# mcp-video-analyzer
+
+MCP server for video analysis — extracts transcripts, key frames, and metadata from video URLs. Supports Loom, direct video files (.mp4, .webm), and more.
+
+No existing video MCP combines **transcripts + visual frames + metadata** in one tool. This one does.
+
+## Quick Start
+
+```bash
+# One-command install for Claude Code
+claude mcp add video-analyzer npx mcp-video-analyzer@latest
+```
+
+Or manually add to your MCP config (Claude Desktop, Cursor, VS Code):
+
+```json
+{
+  "mcpServers": {
+    "video-analyzer": {
+      "command": "npx",
+      "args": ["mcp-video-analyzer@latest"]
+    }
+  }
+}
+```
+
+## Tools
+
+### `analyze_video` — Full video analysis
+
+Extracts everything from a video URL in one call:
+
+```
+> Analyze this video: https://www.loom.com/share/abc123...
+```
+
+Returns:
+- **Transcript** with timestamps and speakers
+- **Key frames** extracted via scene-change detection (automatically deduplicated)
+- **OCR text** extracted from frames (code, error messages, UI text visible on screen)
+- **Annotated timeline** merging transcript + frames + OCR into a unified "what happened when" view
+- **Metadata** (title, duration, platform)
+- **Comments** from viewers
+- **Chapters** and **AI summary** (when available)
+
+The AI will **automatically** call this tool when it sees a video URL — no need to ask.
+
+Options:
+- `detail` — analysis depth: `"brief"` (metadata + truncated transcript, no frames), `"standard"` (default), `"detailed"` (dense sampling, more frames)
+- `fields` — array of specific fields to return, e.g. `["metadata", "transcript"]`. Available: `metadata`, `transcript`, `frames`, `comments`, `chapters`, `ocrResults`, `timeline`, `aiSummary`
+- `maxFrames` (1-60, default depends on detail level) — cap on extracted frames
+- `threshold` (0.0-1.0, default 0.1) — scene-change sensitivity
+- `forceRefresh` — bypass cache and re-analyze
+- `skipFrames` — skip frame extraction for transcript-only analysis
+
+### `get_transcript` — Transcript only
+
+```
+> Get the transcript from this video
+```
+
+Quick transcript extraction. Falls back to Whisper transcription when no native transcript is available.
+
+### `get_metadata` — Metadata only
+
+```
+> What's this video about?
+```
+
+Returns metadata, comments, chapters, and AI summary without downloading the video.
+
+### `get_frames` — Frames only
+
+```
+> Extract frames from this video with dense sampling
+```
+
+Two modes:
+- **Scene-change detection** (default) — captures visual transitions
+- **Dense sampling** (`dense: true`) — 1 frame/sec for full coverage
+
+### `analyze_moment` — Deep-dive on a time range
+
+```
+> Analyze what happens between 1:30 and 2:00 in this video
+```
+
+Combines burst frame extraction + filtered transcript + OCR + annotated timeline for a focused segment. Use when you need to understand exactly what happens at a specific moment.
+
+### `get_frame_at` — Single frame at a timestamp
+
+```
+> Show me the frame at 1:23 in this video
+```
+
+The AI reads the transcript, spots a critical moment, and requests the exact frame to see what's on screen.
+
+### `get_frame_burst` — N frames in a time range
+
+```
+> Show me 10 frames between 0:15 and 0:17 of this video
+```
+
+For motion, vibration, animations, or fast scrolling — burst mode captures N frames in a narrow window so the AI can see frame-by-frame changes.
+
+## Detail Levels
+
+| Level | Frames | Transcript | OCR | Timeline | Use case |
+|-------|--------|-----------|-----|----------|----------|
+| `brief` | None | First 10 entries | No | No | Quick check — what's this video about? |
+| `standard` | Up to 20 (scene-change) | Full | Yes | Yes | Default — full analysis |
+| `detailed` | Up to 60 (1fps dense) | Full | Yes | Yes | Deep analysis — every second captured |
+
+## Caching
+
+Results are cached in memory for 10 minutes. Subsequent calls with the same URL and options return instantly. Use `forceRefresh: true` to bypass the cache.
+
+## Supported Platforms
+
+| Platform | Transcript | Metadata | Comments | Frames | Auth |
+|----------|:----------:|:--------:|:--------:|:------:|:----:|
+| **Loom** | Yes | Yes | Yes | Yes | None |
+| **Direct URL** (.mp4, .webm) | No | Duration only | No | Yes | None |
+
+### Frame Extraction Strategies
+
+Frame extraction uses a two-strategy fallback chain — no single dependency is required:
+
+| Strategy | How it works | Speed | Requirements |
+|----------|-------------|-------|-------------|
+| **yt-dlp + ffmpeg** (primary) | Downloads video, extracts frames via scene detection | Fast, precise | [yt-dlp](https://github.com/yt-dlp/yt-dlp) (`pip install yt-dlp`) |
+| **Browser** (fallback) | Opens video in headless Chrome, seeks to timestamps, takes screenshots | Slower, no download needed | Chrome or Chromium installed |
+
+The fallback is automatic — if yt-dlp is not available, the server tries browser-based extraction via `puppeteer-core`. If neither is available, analysis still returns transcript + metadata + comments, just no frames.
+
+### Post-Processing Pipeline
+
+After frame extraction, the pipeline automatically applies:
+
+| Step | What it does | Why |
+|------|-------------|-----|
+| **Frame deduplication** | Removes near-identical consecutive frames using perceptual hashing (dHash + Hamming distance) | Screencasts often have long static moments — dedup removes redundant frames, saving tokens |
+| **OCR** | Extracts text visible on screen from each frame (via tesseract.js) | Captures code, error messages, terminal output, UI text that the transcript doesn't cover |
+| **Annotated timeline** | Merges transcript timestamps + frame timestamps + OCR text into a single chronological view | Gives the AI a unified "what was said, what changed visually, and what text appeared" at each moment |
+
+The OCR step requires `tesseract.js` (included as a dependency). If it fails to load, analysis continues without OCR — no frames or transcript are lost.
+
+## Complementary Tools
+
+### Chrome DevTools MCP
+
+For **live web debugging** alongside video analysis, pair this server with the [Chrome DevTools MCP](https://github.com/anthropics/anthropic-quickstarts/tree/main/mcp-devtools):
+
+```bash
+claude mcp add chrome-devtools npx @anthropic-ai/mcp-devtools@latest
+```
+
+**When to use each:**
+
+| Scenario | Tool |
+|----------|------|
+| Bug report recorded as a Loom video | `mcp-video-analyzer` — extract transcript, frames, and error text from the recording |
+| Live debugging a web page | Chrome DevTools MCP — inspect DOM, console, network, take screenshots |
+| Video shows UI issue, need to reproduce it | Use both: analyze the video first, then open the page in Chrome DevTools to reproduce |
+
+The two MCPs complement each other: video analyzer understands **recorded** content, DevTools interacts with **live** pages.
+
+## Example Output
+
+The [`examples/loom-demo/`](examples/loom-demo/) folder contains **real outputs** from analyzing a public Loom video ([Boost In-App Demo Video](https://www.loom.com/share/bdebdfe44b294225ac718bad241a94fe), 2:55).
+
+| File | What it shows |
+|------|--------------|
+| [`metadata.json`](examples/loom-demo/metadata.json) | Title, duration, platform |
+| [`transcript.json`](examples/loom-demo/transcript.json) | 42 timestamped entries with speaker IDs |
+| [`timeline.json`](examples/loom-demo/timeline.json) | Unified chronological view (transcript + frames merged) |
+| [`moment-transcript-0m30s-0m45s.json`](examples/loom-demo/moment-transcript-0m30s-0m45s.json) | Filtered transcript for `analyze_moment` (0:30–0:45) |
+| [`full-analysis.json`](examples/loom-demo/full-analysis.json) | Complete `analyze_video` output |
+
+**Frame images** (19 total in [`examples/loom-demo/frames/`](examples/loom-demo/frames/)):
+- `scene_*.jpg` — scene-change detection (key visual transitions)
+- `dense_*.jpg` — 1fps dense sampling (every 10th frame saved as sample)
+- `burst_*.jpg` — burst extraction for moment analysis (0:30–0:45)
+
+> **Regenerate after changes:** `npx tsx examples/generate.ts` — requires yt-dlp + network access.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run all checks (format, lint, typecheck, knip, tests)
+npm run check
+
+# Build
+npm run build
+
+# Run E2E tests (requires network)
+npm run test:e2e
+
+# Open MCP Inspector for manual testing
+npm run inspect
+```
+
+## Architecture
+
+```
+src/
+├── index.ts                    # Entry point (shebang + stdio)
+├── server.ts                   # FastMCP server + tool registration
+├── tools/                      # MCP tool definitions (7 tools)
+│   ├── analyze-video.ts        # Full analysis with detail levels + caching
+│   ├── analyze-moment.ts       # Deep-dive on a time range
+│   ├── get-transcript.ts       # Transcript-only with Whisper fallback
+│   ├── get-metadata.ts         # Metadata + comments + chapters
+│   ├── get-frames.ts           # Frames-only (scene-change or dense)
+│   ├── get-frame-at.ts         # Single frame at timestamp
+│   └── get-frame-burst.ts      # N frames in a time range
+├── adapters/                   # Platform-specific logic
+│   ├── adapter.interface.ts    # IVideoAdapter interface + registry
+│   ├── loom.adapter.ts         # Loom: authless GraphQL
+│   └── direct.adapter.ts       # Direct URL: any mp4/webm link
+├── processors/                 # Shared processing
+│   ├── frame-extractor.ts      # ffmpeg scene detection + dense + burst extraction
+│   ├── browser-frame-extractor.ts # Headless Chrome fallback for frames
+│   ├── audio-transcriber.ts    # Whisper fallback (HF transformers → CLI → OpenAI)
+│   ├── image-optimizer.ts      # sharp resize/compress
+│   ├── frame-dedup.ts          # Perceptual dedup (dHash + Hamming distance)
+│   ├── frame-ocr.ts            # OCR text extraction (tesseract.js)
+│   └── annotated-timeline.ts   # Unified timeline (transcript + frames + OCR)
+├── config/
+│   └── detail-levels.ts        # brief / standard / detailed config
+├── utils/
+│   ├── cache.ts                # In-memory TTL cache with LRU eviction
+│   ├── field-filter.ts         # Selective field filtering for responses
+│   ├── url-detector.ts         # Platform detection from URL
+│   ├── vtt-parser.ts           # WebVTT → transcript entries
+│   └── temp-files.ts           # Temp directory management
+└── types.ts                    # Shared TypeScript interfaces
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,15 @@
+import type { ITranscriptEntry, IVideoMetadata, IVideoComment, IChapter, IAdapterCapabilities } from '../types.js';
+export interface IVideoAdapter {
+    readonly name: string;
+    readonly capabilities: IAdapterCapabilities;
+    canHandle(url: string): boolean;
+    getMetadata(url: string): Promise<IVideoMetadata>;
+    getTranscript(url: string): Promise<ITranscriptEntry[]>;
+    getComments(url: string): Promise<IVideoComment[]>;
+    getChapters(url: string): Promise<IChapter[]>;
+    getAiSummary(url: string): Promise<string | null>;
+    downloadVideo(url: string, destDir: string): Promise<string | null>;
+}
+export declare function registerAdapter(adapter: IVideoAdapter): void;
+export declare function getAdapter(url: string): IVideoAdapter;
+export declare function clearAdapters(): void;

package/dist/adapters/adapter.interface.js

@@ -0,0 +1,17 @@
+import { UserError } from 'fastmcp';
+const adapters = [];
+export function registerAdapter(adapter) {
+    adapters.push(adapter);
+}
+export function getAdapter(url) {
+    for (const adapter of adapters) {
+        if (adapter.canHandle(url)) {
+            return adapter;
+        }
+    }
+    throw new UserError(`Unsupported video URL: "${url}". Supported platforms: Loom (loom.com/share/...), direct video files (.mp4, .webm, .mov).`);
+}
+export function clearAdapters() {
+    adapters.length = 0;
+}
+//# sourceMappingURL=adapter.interface.js.map

package/dist/adapters/adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.interface.js","sourceRoot":"","sources":["../../src/adapters/adapter.interface.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAepC,MAAM,QAAQ,GAAoB,EAAE,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,2BAA2B,GAAG,4FAA4F,CAC3H,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { ITranscriptEntry, IVideoMetadata, IVideoComment, IChapter, IAdapterCapabilities } from '../types.js';
+import type { IVideoAdapter } from './adapter.interface.js';
+export declare class DirectAdapter implements IVideoAdapter {
+    readonly name = "direct";
+    readonly capabilities: IAdapterCapabilities;
+    canHandle(url: string): boolean;
+    getMetadata(url: string): Promise<IVideoMetadata>;
+    getTranscript(_url: string): Promise<ITranscriptEntry[]>;
+    getComments(_url: string): Promise<IVideoComment[]>;
+    getChapters(_url: string): Promise<IChapter[]>;
+    getAiSummary(_url: string): Promise<string | null>;
+    downloadVideo(url: string, destDir: string): Promise<string | null>;
+}

package/dist/adapters/direct.adapter.js

@@ -0,0 +1,67 @@
+import { createWriteStream } from 'node:fs';
+import { join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { detectPlatform } from '../utils/url-detector.js';
+function getFilenameFromUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const segments = parsed.pathname.split('/');
+        const lastSegment = segments[segments.length - 1];
+        if (lastSegment && lastSegment.includes('.')) {
+            return lastSegment;
+        }
+    }
+    catch {
+        // ignore parse errors
+    }
+    return 'video.mp4';
+}
+export class DirectAdapter {
+    name = 'direct';
+    capabilities = {
+        transcript: false,
+        metadata: false,
+        comments: false,
+        chapters: false,
+        aiSummary: false,
+        videoDownload: true,
+    };
+    canHandle(url) {
+        return detectPlatform(url) === 'direct';
+    }
+    async getMetadata(url) {
+        const filename = getFilenameFromUrl(url);
+        return {
+            platform: 'direct',
+            title: filename,
+            duration: 0,
+            durationFormatted: '0:00',
+            url,
+        };
+    }
+    async getTranscript(_url) {
+        return [];
+    }
+    async getComments(_url) {
+        return [];
+    }
+    async getChapters(_url) {
+        return [];
+    }
+    async getAiSummary(_url) {
+        return null;
+    }
+    async downloadVideo(url, destDir) {
+        const filename = getFilenameFromUrl(url);
+        const destPath = join(destDir, filename);
+        const response = await fetch(url);
+        if (!response.ok || !response.body) {
+            return null;
+        }
+        const nodeStream = Readable.fromWeb(response.body);
+        await pipeline(nodeStream, createWriteStream(destPath));
+        return destPath;
+    }
+}
+//# sourceMappingURL=direct.adapter.js.map

package/dist/adapters/direct.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct.adapter.js","sourceRoot":"","sources":["../../src/adapters/direct.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASvC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAChB,YAAY,GAAyB;QAC5C,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF,SAAS,CAAC,GAAW;QACnB,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,CAAC;YACX,iBAAiB,EAAE,MAAM;YACzB,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,OAAe;QAC9C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAA8C,CAAC,CAAC;QAC7F,MAAM,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAExD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import type { ITranscriptEntry, IVideoMetadata, IVideoComment, IChapter, IAdapterCapabilities } from '../types.js';
+import type { IVideoAdapter } from './adapter.interface.js';
+export declare class LoomAdapter implements IVideoAdapter {
+    readonly name = "loom";
+    readonly capabilities: IAdapterCapabilities;
+    canHandle(url: string): boolean;
+    getMetadata(url: string): Promise<IVideoMetadata>;
+    getTranscript(url: string): Promise<ITranscriptEntry[]>;
+    getComments(url: string): Promise<IVideoComment[]>;
+    getChapters(_url: string): Promise<IChapter[]>;
+    getAiSummary(_url: string): Promise<string | null>;
+    downloadVideo(url: string, destDir: string): Promise<string | null>;
+}

package/dist/adapters/loom.adapter.js

@@ -0,0 +1,183 @@
+import { execFile as execFileCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { detectPlatform, extractLoomId } from '../utils/url-detector.js';
+import { parseVtt } from '../utils/vtt-parser.js';
+const execFile = promisify(execFileCb);
+const LOOM_GRAPHQL_URL = 'https://www.loom.com/graphql';
+const GRAPHQL_HEADERS = {
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+    'User-Agent': 'mcp-video-analyzer/0.1.0',
+};
+async function loomGraphQL(query, variables) {
+    const response = await fetch(LOOM_GRAPHQL_URL, {
+        method: 'POST',
+        headers: GRAPHQL_HEADERS,
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!response.ok) {
+        return null;
+    }
+    const json = (await response.json());
+    if (json.errors?.length) {
+        return null;
+    }
+    return json.data ?? null;
+}
+function formatDuration(seconds) {
+    const hrs = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    const secs = Math.floor(seconds % 60);
+    if (hrs > 0) {
+        return `${hrs}:${String(mins).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
+    }
+    return `${mins}:${String(secs).padStart(2, '0')}`;
+}
+function timestampFromMs(ms) {
+    return formatDuration(ms / 1000);
+}
+export class LoomAdapter {
+    name = 'loom';
+    capabilities = {
+        transcript: true,
+        metadata: true,
+        comments: true,
+        chapters: false,
+        aiSummary: false,
+        videoDownload: true,
+    };
+    canHandle(url) {
+        return detectPlatform(url) === 'loom';
+    }
+    async getMetadata(url) {
+        const videoId = extractLoomId(url);
+        const data = await loomGraphQL(`query GetVideo($videoId: ID!, $password: String) {
+        getVideo(id: $videoId, password: $password) {
+          ... on RegularUserVideo {
+            __typename id name description playable_duration
+            owner { display_name }
+            createdAt
+          }
+          ... on PrivateVideo {
+            __typename id
+          }
+        }
+      }`, { videoId, password: null });
+        const video = data?.getVideo;
+        return {
+            platform: 'loom',
+            title: video?.name ?? 'Untitled Loom Video',
+            description: video?.description ?? undefined,
+            duration: video?.playable_duration ?? 0,
+            durationFormatted: formatDuration(video?.playable_duration ?? 0),
+            url,
+        };
+    }
+    async getTranscript(url) {
+        const videoId = extractLoomId(url);
+        const data = await loomGraphQL(`query FetchVideoTranscript($videoId: ID!, $password: String) {
+        fetchVideoTranscript(videoId: $videoId, password: $password) {
+          ... on VideoTranscriptDetails {
+            captions_source_url
+            source_url
+            transcription_status
+            language
+          }
+        }
+      }`, { videoId, password: null });
+        const captionsUrl = data?.fetchVideoTranscript?.captions_source_url;
+        if (!captionsUrl) {
+            return [];
+        }
+        const vttResponse = await fetch(captionsUrl);
+        if (!vttResponse.ok) {
+            return [];
+        }
+        const vttContent = await vttResponse.text();
+        return parseVtt(vttContent);
+    }
+    async getComments(url) {
+        const videoId = extractLoomId(url);
+        const data = await loomGraphQL(`query FetchVideoComments($videoId: ID!, $password: String) {
+        getVideo(id: $videoId, password: $password) {
+          ... on RegularUserVideo {
+            comments {
+              id plain_content time_stamp user_name createdAt
+              children_comments {
+                id plain_content time_stamp user_name createdAt
+              }
+            }
+          }
+        }
+      }`, { videoId, password: null });
+        const comments = data?.getVideo?.comments ?? [];
+        return flattenComments(comments);
+    }
+    async getChapters(_url) {
+        return [];
+    }
+    async getAiSummary(_url) {
+        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`);
+        try {
+            await execFile(ytDlp.bin, [...ytDlp.prefix, '-o', outputPath, '--no-warnings', '-q', url], {
+                timeout: 120000,
+            });
+            return existsSync(outputPath) ? outputPath : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function flattenComments(comments) {
+    const result = [];
+    for (const comment of comments) {
+        result.push({
+            author: comment.user_name ?? 'Unknown',
+            text: comment.plain_content,
+            time: comment.time_stamp != null ? timestampFromMs(comment.time_stamp) : undefined,
+            createdAt: comment.createdAt,
+        });
+        if (comment.children_comments?.length) {
+            for (const child of comment.children_comments) {
+                result.push({
+                    author: child.user_name ?? 'Unknown',
+                    text: child.plain_content,
+                    time: child.time_stamp != null ? timestampFromMs(child.time_stamp) : undefined,
+                    createdAt: child.createdAt,
+                });
+            }
+        }
+    }
+    return result;
+}
+async function findYtDlp() {
+    for (const bin of ['yt-dlp', 'yt-dlp.exe']) {
+        try {
+            await execFile(bin, ['--version'], { timeout: 5000 });
+            return { bin, prefix: [] };
+        }
+        catch {
+            // not found, try next
+        }
+    }
+    // Try python module
+    try {
+        await execFile('python', ['-m', 'yt_dlp', '--version'], { timeout: 5000 });
+        return { bin: 'python', prefix: ['-m', 'yt_dlp'] };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=loom.adapter.js.map

package/dist/adapters/loom.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loom.adapter.js","sourceRoot":"","sources":["../../src/adapters/loom.adapter.ts"],"names":[],"mappings":"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"}

package/dist/config/detail-levels.d.ts

@@ -0,0 +1,18 @@
+export type DetailLevel = 'brief' | 'standard' | 'detailed';
+interface DetailConfig {
+    /** Maximum frames to extract (0 = skip frames entirely) */
+    maxFrames: number;
+    /** Maximum transcript entries to return (null = unlimited) */
+    transcriptMaxEntries: number | null;
+    /** Whether to run OCR on extracted frames */
+    includeOcr: boolean;
+    /** Whether to build the annotated timeline */
+    includeTimeline: boolean;
+    /** Whether to extract frames at all */
+    includeFrames: boolean;
+    /** Whether to use dense sampling (1 fps) instead of scene detection */
+    denseSampling: boolean;
+}
+export declare const DETAIL_CONFIGS: Record<DetailLevel, DetailConfig>;
+export declare function getDetailConfig(level: DetailLevel): DetailConfig;
+export {};

package/dist/config/detail-levels.js

@@ -0,0 +1,30 @@
+export const DETAIL_CONFIGS = {
+    brief: {
+        maxFrames: 0,
+        transcriptMaxEntries: 10,
+        includeOcr: false,
+        includeTimeline: false,
+        includeFrames: false,
+        denseSampling: false,
+    },
+    standard: {
+        maxFrames: 20,
+        transcriptMaxEntries: null,
+        includeOcr: true,
+        includeTimeline: true,
+        includeFrames: true,
+        denseSampling: false,
+    },
+    detailed: {
+        maxFrames: 60,
+        transcriptMaxEntries: null,
+        includeOcr: true,
+        includeTimeline: true,
+        includeFrames: true,
+        denseSampling: true,
+    },
+};
+export function getDetailConfig(level) {
+    return DETAIL_CONFIGS[level];
+}
+//# sourceMappingURL=detail-levels.js.map

package/dist/config/detail-levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-levels.js","sourceRoot":"","sources":["../../src/config/detail-levels.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC/D,KAAK,EAAE;QACL,SAAS,EAAE,CAAC;QACZ,oBAAoB,EAAE,EAAE;QACxB,UAAU,EAAE,KAAK;QACjB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,KAAK;KACrB;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,IAAI;QAC1B,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK;KACrB;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,IAAI;QAC1B,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createServer } from './server.js';
+const server = createServer();
+server.start({ transportType: 'stdio' });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC"}