mcp-youtube-intelligence 0.2.3 → 0.2.5

package/README.md

@@ -60,7 +60,12 @@ Add to your Claude Desktop / MCP client config:
 **`analyze_channel`** — Extract intelligence from a YouTube channel
 
 ```
-channel_url: YouTube channel URL or @handle (e.g. @fireship, youtube.com/@fireship)
+channel_url: YouTube channel URL or @handle. Accepts:
+               - @handle (e.g. @fireship)
+               - full URL with handle (e.g. youtube.com/@fireship)
+               - /channel/UC... URL
+               - bare 24-character UC... channel ID
+               - legacy /c/name or /user/name URL
 max_videos:  Number of recent videos to analyze (default: 5, max: 50)
 ```
 

package/build/analyze_channel.js

@@ -130,7 +130,23 @@ export async function resolveChannel(input, apiKey) {
     else {
         // custom_url — fall back to search (costs 100 quota units); rare path
         const searchUrl = `${YT_API_BASE}/search?part=snippet&type=channel&q=${encodeURIComponent(parsed.value)}&maxResults=1&key=${apiKey}`;
-        const searchResp = await fetchWithTimeout(searchUrl, {}, "YouTube search API");
+        // Same one-shot tolerance as the channels-API lookup below: a thrown rejection
+        // is as transient as a 5xx, and this path previously had neither — leaving the
+        // most quota-expensive of the three call sites the least tolerant of a blip.
+        const fetchSearch = () => fetchWithTimeout(searchUrl, {}, "YouTube search API");
+        let searchResp;
+        try {
+            searchResp = await fetchSearch();
+        }
+        catch {
+            searchResp = undefined;
+        }
+        if (searchResp === undefined) {
+            searchResp = await fetchSearch();
+        }
+        else if (!searchResp.ok && searchResp.status >= 500) {
+            searchResp = await fetchSearch();
+        }
         if (!searchResp.ok)
             throw new Error(`YouTube search API error ${searchResp.status}: ${await searchResp.text()}`);
         const searchData = await parseJsonResponse(searchResp, "YouTube search API");
@@ -193,7 +209,25 @@ export async function getRecentVideoIds(uploadsPlaylistId, maxResults, apiKey) {
         `&playlistId=${encodeURIComponent(uploadsPlaylistId)}` +
         `&maxResults=${maxResults}` +
         `&key=${apiKey}`;
-    const resp = await fetchWithTimeout(apiUrl, {}, "YouTube playlistItems API");
+    // Same one-shot tolerance as resolveChannel's channels-API lookup and the Apify
+    // calls: a thrown rejection (connection reset, DNS blip) is as transient as a
+    // 5xx. This is the second external call every analyze_channel run makes, and
+    // previously it had no tolerance at all — a single blip failed the whole tool
+    // call immediately.
+    const fetchPlaylistItems = () => fetchWithTimeout(apiUrl, {}, "YouTube playlistItems API");
+    let resp;
+    try {
+        resp = await fetchPlaylistItems();
+    }
+    catch {
+        resp = undefined;
+    }
+    if (resp === undefined) {
+        resp = await fetchPlaylistItems();
+    }
+    else if (!resp.ok && resp.status >= 500) {
+        resp = await fetchPlaylistItems();
+    }
     if (!resp.ok)
         throw new Error(`YouTube playlistItems API error ${resp.status}: ${await resp.text()}`);
     const data = await parseJsonResponse(resp, "YouTube playlistItems API");
@@ -227,10 +261,10 @@ export async function runApifyTranscriptScraper(videoUrls, token) {
     if (runResp === undefined) {
         runResp = await startRun();
     }
-    else if (!runResp.ok && runResp.status >= 500) {
-        // Retry once on a transient 5xx — the same one-shot tolerance given above to a
-        // thrown network error; a 503 here previously failed the whole tool call
-        // immediately instead of getting that same retry.
+    else if (!runResp.ok && (runResp.status >= 500 || runResp.status === 429)) {
+        // Retry once on a transient 5xx, or a 429 — Apify returns 429 when the account's
+        // concurrent-actor-run limit is hit, which clears within seconds, unlike a bad
+        // token or malformed request. Same tolerance already given to Gemini below.
         runResp = await startRun();
     }
     if (!runResp.ok) {
@@ -255,11 +289,13 @@ export async function runApifyTranscriptScraper(videoUrls, token) {
             continue;
         }
         if (!statusResp.ok) {
-            // 4xx = permanent error (invalid run ID, bad token) — fail fast instead of polling to timeout
-            if (statusResp.status >= 400 && statusResp.status < 500) {
+            // Most 4xx are permanent (invalid run ID, bad token) — fail fast instead of
+            // polling to timeout. 429 is the exception: Apify's own rate limit, which the
+            // next scheduled poll (APIFY_POLL_INTERVAL_MS later) already backs off past.
+            if (statusResp.status >= 400 && statusResp.status < 500 && statusResp.status !== 429) {
                 throw new Error(`Apify poll error ${statusResp.status} for run ${runId}: ${await statusResp.text()}`);
             }
-            continue; // 5xx or network transient — keep polling
+            continue; // 5xx, 429, or network transient — keep polling
         }
         let statusBody;
         try {
@@ -295,7 +331,7 @@ export async function runApifyTranscriptScraper(videoUrls, token) {
     if (itemsResp === undefined) {
         itemsResp = await fetchItems();
     }
-    else if (!itemsResp.ok && itemsResp.status >= 500) {
+    else if (!itemsResp.ok && (itemsResp.status >= 500 || itemsResp.status === 429)) {
         itemsResp = await fetchItems();
     }
     if (!itemsResp.ok)
@@ -454,7 +490,12 @@ ${truncated}`;
                 parsed = JSON.parse(text);
             }
             catch {
-                console.warn(`[analyze_channel] Gemini returned unparseable JSON for video ${videoId}, skipping`);
+                // Counts toward the same "every attempted video produced nothing usable"
+                // check below as an HTTP-level failure — an all-malformed-JSON response is
+                // just as much a Gemini outage as an all-5xx one, and previously only the
+                // latter was surfaced as a thrown error instead of a silent empty success.
+                lastRequestError = `Gemini returned unparseable JSON for video ${videoId}`;
+                console.warn(`[analyze_channel] ${lastRequestError}, skipping`);
                 continue;
             }
             results.push({
@@ -471,9 +512,9 @@ ${truncated}`;
             console.warn(`[analyze_channel] Gemini request failed for video ${videoId}, skipping: ${lastRequestError}`);
         }
     }
-    // Every attempted video failed at the HTTP level — surface it as a total
-    // failure so analyzeChannel's note reports a Gemini outage instead of
-    // silently claiming success with zero structured topics.
+    // Every attempted video failed, whether at the HTTP level or via unparseable
+    // JSON — surface it as a total failure so analyzeChannel's note reports a
+    // Gemini outage instead of silently claiming success with zero structured topics.
     if (attempted > 0 && results.length === 0 && lastRequestError) {
         throw new Error(lastRequestError);
     }

package/build/index.js

@@ -13,6 +13,10 @@ import { z } from "zod";
 import { analyzeChannel } from "./analyze_channel.js";
 const require = createRequire(import.meta.url);
 const { version: packageVersion } = require("../package.json");
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+    console.log(packageVersion);
+    process.exit(0);
+}
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
     console.log(`mcp-youtube-intelligence v${packageVersion} — MCP server for YouTube channel intelligence
 
@@ -20,7 +24,8 @@ Usage:
   mcp-youtube-intelligence [options]
 
 Options:
-  --help, -h   Show this help message
+  --help, -h      Show this help message
+  --version, -v   Print the installed version
 
 Tools provided:
   analyze_channel   Extract transcripts, topics, and competitive signals from a YouTube channel`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-youtube-intelligence",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "MCP server for extracting structured intelligence from YouTube channels and videos — transcripts, topics, competitive signals",
   "mcpName": "io.github.dmitriusan/mcp-youtube-intelligence",
   "main": "build/index.js",