@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/xiaohongshu/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,SAAS,iBAAiB,CAAC,GAAY,EAAE,QAAQ,GAAG,EAAE;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,8DAA8D;IAC3E,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,qBAAqB;SACnC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,uCAAuC;SACrD;QACD;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;IAC5E,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAa,CAAC;QACxB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAEtC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;;;8BAGL,MAAM,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4D5C,CAAC,CAA4B,CAAC;QAE/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAWD,MAAM,GAAG,GAAkB,IAAI,CAAC,OAAwB,IAAI,EAAE,CAAC;QAE/D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAiB,EAAE,CAAC;YACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,IAAI,CAAC,CAAC,CAAC,QAAQ;oBAAE,QAAQ,EAAE,CAAC;gBAC5B,IAAI,QAAQ,GAAG,KAAK;oBAAE,MAAM;gBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/comments.ts"],"names":[],"mappings":"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"}

package/dist/adapters/xiaohongshu/download.js

@@ -5,15 +5,44 @@
  * __INITIAL_STATE__, then downloads them with cookie authentication.
  */
 import { cli, Strategy } from "../../registry.js";
-import { loadCookies, formatCookieHeader } from "../../engine/cookies.js";
+import { loadCookiesWithCDP, formatCookieHeader, } from "../../engine/cookies.js";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { USER_AGENT } from "../../constants.js";
 import { parseNoteId, buildNoteUrl } from "./note-helpers.js";
 /** Build authenticated headers for Xiaohongshu downloads. */
-function buildCookieHeader() {
-    const cookies = loadCookies("xiaohongshu");
+async function buildCookieHeader() {
+    const cookies = await loadCookiesWithCDP("xiaohongshu", "www.xiaohongshu.com");
     if (cookies)
         return formatCookieHeader(cookies);
     return "";
 }
+function extensionForMedia(type, url) {
+    try {
+        const pathname = new URL(url).pathname;
+        const match = /\.[a-zA-Z0-9]{2,5}$/.exec(pathname);
+        if (match)
+            return match[0].toLowerCase();
+    }
+    catch {
+        return type === "video" ? ".mp4" : ".jpg";
+    }
+    return type === "video" ? ".mp4" : ".jpg";
+}
+async function downloadMedia(url, path, cookieHeader) {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Referer: "https://www.xiaohongshu.com/",
+    };
+    if (cookieHeader)
+        headers.Cookie = cookieHeader;
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`Xiaohongshu media download failed: HTTP ${response.status}`);
+    }
+    const bytes = Buffer.from(await response.arrayBuffer());
+    await writeFile(path, bytes);
+}
 cli({
     site: "xiaohongshu",
     name: "download",
@@ -34,11 +63,12 @@ cli({
             description: "Output directory",
         },
     ],
-    columns: ["index", "type", "url"],
+    columns: ["index", "type", "path", "url"],
     func: async (page, kwargs) => {
         const p = page;
         const rawInput = String(kwargs["note-id"]);
         const noteId = parseNoteId(rawInput);
+        const outputDir = String(kwargs.output ?? "./xiaohongshu-downloads");
         await p.goto(buildNoteUrl(rawInput));
         await p.wait(3);
         const data = (await p.evaluate(`
@@ -148,13 +178,21 @@ cli({
         if (!data || !data.media || data.media.length === 0) {
             return [{ index: 0, type: "-", url: "No media found" }];
         }
-        // Cookie header available for authenticated downloads when media pipeline is wired
-        void buildCookieHeader();
-        return data.media.map((m, idx) => ({
-            index: idx + 1,
-            type: m.type,
-            url: m.url,
-        }));
+        await mkdir(outputDir, { recursive: true });
+        const cookieHeader = await buildCookieHeader();
+        const rows = [];
+        for (const [idx, media] of data.media.entries()) {
+            const ext = extensionForMedia(media.type, media.url);
+            const path = join(outputDir, `${noteId}-${idx + 1}${ext}`);
+            await downloadMedia(media.url, path, cookieHeader);
+            rows.push({
+                index: idx + 1,
+                type: media.type,
+                path,
+                url: media.url,
+            });
+        }
+        return rows;
     },
 });
 //# sourceMappingURL=download.js.map

package/dist/adapters/xiaohongshu/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/download.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,6DAA6D;AAC7D,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,OAAO;QAAE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kCAAkC;SAChD;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yBAAyB;YAClC,WAAW,EAAE,kBAAkB;SAChC;KACF;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAa,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAErC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;;;qBAGd,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoGtB,CAAC,CAGM,CAAC;QAET,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,mFAAmF;QACnF,KAAK,iBAAiB,EAAE,CAAC;QAEzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAgC,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC;YACxE,KAAK,EAAE,GAAG,GAAG,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/download.ts"],"names":[],"mappings":"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"}

package/dist/adapters/xiaohongshu/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}

package/dist/adapters/xiaohongshu/search.js

@@ -5,6 +5,8 @@
  * DOM elements.  Uses MutationObserver to wait for content or login wall.
  */
 import { cli, Strategy } from "../../registry.js";
+import { socialAuthError, socialEmptyError, } from "../../social/browser-errors.js";
+import { assertXhsReadable } from "./browser-state.js";
 /**
  * Wait for search results or login wall using MutationObserver (max 5 s).
  */
@@ -47,6 +49,7 @@ cli({
     domain: "www.xiaohongshu.com",
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: "user",
     args: [
         {
             name: "query",
@@ -65,12 +68,13 @@ cli({
     func: async (page, kwargs) => {
         const p = page;
         const keyword = encodeURIComponent(String(kwargs.query));
-        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`, { settleMs: 2500 });
         const waitResult = await p.evaluate(WAIT_FOR_CONTENT_JS);
+        await assertXhsReadable(p, "search");
         if (waitResult === "login_wall") {
-            throw new Error("Xiaohongshu search results are blocked behind a login wall");
+            throw socialAuthError("xiaohongshu", "search");
         }
-        // Scroll a couple of times to load more results
         await p.autoScroll({ maxScrolls: 2, delay: 1500 });
         const payload = await p.evaluate(`
       (() => {
@@ -107,11 +111,10 @@ cli({
         return results;
       })()
     `);
-        const limit = Number(kwargs.limit) || 20;
         const data = Array.isArray(payload)
             ? payload
             : [];
-        return data
+        const rows = data
             .filter((item) => item.title)
             .slice(0, limit)
             .map((item, i) => ({
@@ -119,6 +122,9 @@ cli({
             ...item,
             published_at: noteIdToDate(String(item.url ?? "")),
         }));
+        if (rows.length > 0)
+            return rows;
+        throw socialEmptyError("xiaohongshu", "search", `Xiaohongshu search loaded no parseable notes for "${String(kwargs.query)}".`);
     },
 });
 //# sourceMappingURL=search.js.map

package/dist/adapters/xiaohongshu/search.js.map

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

package/dist/adapters/xiaohongshu/trending.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+export {};
+//# sourceMappingURL=trending.d.ts.map

package/dist/adapters/xiaohongshu/trending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.d.ts","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/trending.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/xiaohongshu/trending.js

@@ -0,0 +1,94 @@
+/**
+ * @owner   Xiaohongshu trend extraction.
+ * @does    Reads trending searches, falling back to visible hot notes in Chrome.
+ * @needs   A logged-in Xiaohongshu browser session or valid local cookies.
+ * @feeds   Agents needing current XHS trend context without brittle API-only failure.
+ * @breaks  XHS endpoint and DOM drift can reduce rows; command returns only observed public UI data.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { socialEmptyError } from "../../social/browser-errors.js";
+import { assertXhsReadable, fetchXhsFeedItems } from "./browser-state.js";
+async function fetchHotList(page, limit) {
+    const raw = await page.evaluate(`
+    (async () => {
+      const limit = ${limit};
+      const resp = await fetch('/api/sns/v1/search/hot_list', {
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json' }
+      });
+      if (!resp.ok) return { ok: false, status: resp.status };
+      const data = await resp.json();
+      const items = data?.data?.items || data?.data || [];
+      return {
+        ok: true,
+        rows: items.slice(0, limit).map((item, i) => {
+          const keyword = item.title || item.name || item.word || '';
+          return {
+            rank: i + 1,
+            keyword,
+            score: String(item.score || item.hot_value || ''),
+            url: 'https://www.xiaohongshu.com/search_result?keyword=' + encodeURIComponent(keyword),
+          };
+        }).filter((item) => item.keyword)
+      };
+    })()
+  `);
+    const result = raw;
+    return result.ok && Array.isArray(result.rows) ? result.rows : [];
+}
+async function fetchHotFeed(page, limit) {
+    const items = await fetchXhsFeedItems(page);
+    const rows = items
+        .map((item) => item)
+        .map((item) => {
+        const note = item.note_card;
+        const interact = note?.interact_info;
+        return {
+            title: String(note?.display_title ?? ""),
+            likes: String(interact?.liked_count ?? ""),
+            id: String(item.id ?? ""),
+        };
+    })
+        .filter((item) => item.title && item.id)
+        .sort((a, b) => Number(b.likes || 0) - Number(a.likes || 0))
+        .slice(0, limit);
+    return rows.map((item, i) => ({
+        rank: i + 1,
+        keyword: item.title,
+        score: item.likes,
+        url: `https://www.xiaohongshu.com/explore/${item.id}`,
+    }));
+}
+cli({
+    site: "xiaohongshu",
+    name: "trending",
+    description: "Xiaohongshu trending searches and visible hot notes",
+    domain: "www.xiaohongshu.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    browserSession: "user",
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of trending topics",
+        },
+    ],
+    columns: ["rank", "keyword", "score", "url"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const limit = Number(kwargs.limit) || 20;
+        await p.goto("https://www.xiaohongshu.com/explore", { settleMs: 2500 });
+        await p.wait(2);
+        await assertXhsReadable(p, "trending");
+        const hotList = await fetchHotList(p, limit);
+        if (hotList.length > 0)
+            return hotList;
+        const hotFeed = await fetchHotFeed(p, limit);
+        if (hotFeed.length > 0)
+            return hotFeed;
+        throw socialEmptyError("xiaohongshu", "trending", "Xiaohongshu explore loaded no parseable hot-search or hot-note rows.");
+    },
+});
+//# sourceMappingURL=trending.js.map

package/dist/adapters/xiaohongshu/trending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.js","sourceRoot":"","sources":["../../../src/adapters/xiaohongshu/trending.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAS1E,KAAK,UAAU,YAAY,CAAC,IAAW,EAAE,KAAa;IACpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;sBAEZ,KAAK;;;;;;;;;;;;;;;;;;;;;GAqBxB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,GAA0C,CAAC;IAC1D,OAAO,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAW,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAA+B,CAAC;SAC9C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,SAAgD,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,EAAE,aAEV,CAAC;QACd,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,IAAI,EAAE,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC;YAC1C,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;SAC3D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,CAAC;QACX,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,uCAAuC,IAAI,CAAC,EAAE,EAAE;KACtD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,qDAAqD;IAClE,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,MAAM;IACtB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,2BAA2B;SACzC;KACF;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC;IAC5C,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAa,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,CAAC,IAAI,CAAC,qCAAqC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,iBAAiB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QAEvC,MAAM,gBAAgB,CACpB,aAAa,EACb,UAAU,EACV,sEAAsE,CACvE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/youtube/comments.d.ts

@@ -4,5 +4,85 @@
  * Uses InnerTube "next" endpoint which returns engagement panels
  * including the comment section.
  */
+interface CommentRenderer {
+    commentRenderer?: {
+        commentId?: string;
+        authorText?: {
+            simpleText?: string;
+        };
+        contentText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+        };
+        voteCount?: {
+            simpleText?: string;
+        };
+        replyCount?: number;
+        publishedTimeText?: {
+            runs?: Array<{
+                text: string;
+            }>;
+            simpleText?: string;
+        };
+    };
+}
+interface ReplyContinuationItem {
+    commentRenderer?: CommentRenderer["commentRenderer"];
+    continuationItemRenderer?: {
+        continuationEndpoint?: {
+            continuationCommand?: {
+                token?: string;
+            };
+        };
+    };
+}
+interface CommentSection {
+    itemSectionRenderer?: {
+        contents?: Array<{
+            commentThreadRenderer?: {
+                comment?: CommentRenderer;
+                replies?: {
+                    commentRepliesRenderer?: {
+                        contents?: ReplyContinuationItem[];
+                    };
+                };
+            };
+        }>;
+    };
+}
+interface NextEndpoint {
+    reloadContinuationItemsCommand?: {
+        continuationItems?: CommentSection[];
+    };
+    appendContinuationItemsAction?: {
+        continuationItems?: CommentSection[];
+    };
+}
+interface NextResponse {
+    onResponseReceivedEndpoints?: NextEndpoint[];
+    microformat?: {
+        microformatDataRenderer?: {
+            videoDetails?: {
+                comments?: Array<{
+                    text?: string;
+                    dateCreated?: string;
+                    upvoteCount?: string | number;
+                    author?: {
+                        name?: string;
+                        alternateName?: string;
+                    };
+                }>;
+            };
+        };
+    };
+}
+export declare function extractYouTubeCommentRows(data: NextResponse): {
+    rows: Array<Record<string, unknown>>;
+    replyContinuationTokens: Array<{
+        parentId: string;
+        token: string;
+    }>;
+};
 export {};
 //# sourceMappingURL=comments.d.ts.map

package/dist/adapters/youtube/comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,eAAe;IACvB,eAAe,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,WAAW,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACjD,SAAS,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7E,CAAC;CACH;AAED,UAAU,qBAAqB;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACrD,wBAAwB,CAAC,EAAE;QACzB,oBAAoB,CAAC,EAAE;YACrB,mBAAmB,CAAC,EAAE;gBACpB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,UAAU,cAAc;IACtB,mBAAmB,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,qBAAqB,CAAC,EAAE;gBACtB,OAAO,CAAC,EAAE,eAAe,CAAC;gBAC1B,OAAO,CAAC,EAAE;oBACR,sBAAsB,CAAC,EAAE;wBACvB,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;qBACpC,CAAC;iBACH,CAAC;aACH,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;CACH;AAED,UAAU,YAAY;IACpB,8BAA8B,CAAC,EAAE;QAC/B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;IACF,6BAA6B,CAAC,EAAE;QAC9B,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;KACtC,CAAC;CACH;AAED,UAAU,YAAY;IACpB,2BAA2B,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QACZ,uBAAuB,CAAC,EAAE;YACxB,YAAY,CAAC,EAAE;gBACb,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,IAAI,CAAC,EAAE,MAAM,CAAC;oBACd,WAAW,CAAC,EAAE,MAAM,CAAC;oBACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;oBAC9B,MAAM,CAAC,EAAE;wBACP,IAAI,CAAC,EAAE,MAAM,CAAC;wBACd,aAAa,CAAC,EAAE,MAAM,CAAC;qBACxB,CAAC;iBACH,CAAC,CAAC;aACJ,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAyCD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG;IAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,uBAAuB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAmDA"}

package/dist/adapters/youtube/comments.js

@@ -5,10 +5,39 @@
  * including the comment section.
  */
 import { cli, Strategy } from "../../registry.js";
+import { normalizeCommentRows } from "../../social/comments.js";
 import { innertubeFetch } from "./innertube.js";
-function extractComments(data) {
+function rowFromComment(c, parentId = "") {
+    return {
+        id: c.commentId ?? "",
+        parent_id: parentId,
+        author: c.authorText?.simpleText ?? "",
+        text: c.contentText?.runs?.map((r) => r.text).join("") ?? "",
+        likes: c.voteCount?.simpleText ?? "0",
+        replies: c.replyCount ?? 0,
+        created: c.publishedTimeText?.simpleText ??
+            c.publishedTimeText?.runs?.map((r) => r.text).join("") ??
+            "",
+    };
+}
+function extractReplyRows(items, parentId) {
+    const rows = [];
+    const continuationTokens = [];
+    for (const item of items) {
+        if (item.commentRenderer) {
+            rows.push(rowFromComment(item.commentRenderer, parentId));
+        }
+        const token = item.continuationItemRenderer?.continuationEndpoint?.continuationCommand
+            ?.token;
+        if (token)
+            continuationTokens.push(token);
+    }
+    return { rows, continuationTokens };
+}
+export function extractYouTubeCommentRows(data) {
     const endpoints = data.onResponseReceivedEndpoints ?? [];
-    const results = [];
+    const rows = [];
+    const replyContinuationTokens = [];
     for (const ep of endpoints) {
         const items = ep.reloadContinuationItemsCommand?.continuationItems ??
             ep.appendContinuationItemsAction?.continuationItems ??
@@ -16,19 +45,54 @@ function extractComments(data) {
         for (const section of items) {
             const contents = section.itemSectionRenderer?.contents ?? [];
             for (const thread of contents) {
-                const c = thread.commentThreadRenderer?.comment?.commentRenderer;
+                const renderer = thread.commentThreadRenderer;
+                const c = renderer?.comment?.commentRenderer;
                 if (!c)
                     continue;
-                results.push({
-                    author: c.authorText?.simpleText ?? "",
-                    text: c.contentText?.runs?.map((r) => r.text).join("") ?? "",
-                    likes: c.voteCount?.simpleText ?? "0",
-                    replies: c.replyCount ?? 0,
-                });
+                const rootRow = rowFromComment(c);
+                const parentId = String(rootRow.id ?? "");
+                rows.push(rootRow);
+                const replies = renderer?.replies?.commentRepliesRenderer?.contents;
+                if (!replies || !parentId)
+                    continue;
+                const extracted = extractReplyRows(replies, parentId);
+                rows.push(...extracted.rows);
+                for (const token of extracted.continuationTokens) {
+                    replyContinuationTokens.push({ parentId, token });
+                }
             }
         }
     }
-    return results;
+    if (rows.length === 0) {
+        const comments = data.microformat?.microformatDataRenderer?.videoDetails?.comments ?? [];
+        for (const [index, comment] of comments.entries()) {
+            rows.push({
+                id: `microformat:${index + 1}`,
+                author: comment.author?.alternateName ?? comment.author?.name ?? "",
+                text: comment.text ?? "",
+                likes: typeof comment.upvoteCount === "number"
+                    ? comment.upvoteCount
+                    : Number(comment.upvoteCount ?? 0),
+                replies: 0,
+                created: comment.dateCreated ?? "",
+            });
+        }
+    }
+    return { rows, replyContinuationTokens };
+}
+function extractContinuationReplyRows(data, parentId) {
+    const rows = [];
+    for (const ep of data.onResponseReceivedEndpoints ?? []) {
+        const items = ep.reloadContinuationItemsCommand?.continuationItems ??
+            ep.appendContinuationItemsAction?.continuationItems ??
+            [];
+        for (const item of items) {
+            const renderer = item.commentRenderer;
+            if (renderer)
+                rows.push(rowFromComment(renderer, parentId));
+        }
+    }
+    return rows;
 }
 cli({
     site: "youtube",
@@ -50,13 +114,45 @@ cli({
             default: 20,
             description: "Max comments to return",
         },
+        {
+            name: "with-replies",
+            type: "bool",
+            default: false,
+            description: "Fetch available nested replies",
+        },
+    ],
+    columns: [
+        "platform",
+        "content_id",
+        "comment_id",
+        "parent_id",
+        "depth",
+        "path",
+        "author",
+        "text",
+        "likes",
+        "replies",
+        "created",
     ],
-    columns: ["author", "text", "likes", "replies"],
     async func(_page, kwargs) {
         const videoId = kwargs.videoId;
         const limit = kwargs.limit ?? 20;
+        const withReplies = Boolean(kwargs["with-replies"]);
         const data = (await innertubeFetch("next", { videoId }));
-        return extractComments(data).slice(0, limit);
+        const extracted = extractYouTubeCommentRows(data);
+        const rows = extracted.rows.slice(0, limit);
+        if (withReplies) {
+            for (const continuation of extracted.replyContinuationTokens) {
+                const replyData = (await innertubeFetch("next", {
+                    continuation: continuation.token,
+                }));
+                rows.push(...extractContinuationReplyRows(replyData, continuation.parentId));
+            }
+        }
+        return normalizeCommentRows(rows, {
+            platform: "youtube",
+            contentId: videoId,
+        });
     },
 });
 //# sourceMappingURL=comments.js.map

package/dist/adapters/youtube/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkChD,SAAS,eAAe,CAAC,IAAkB;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,2BAA2B,IAAI,EAAE,CAAC;IACzD,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,EAAE,CAAC,8BAA8B,EAAE,iBAAiB;YACpD,EAAE,CAAC,6BAA6B,EAAE,iBAAiB;YACnD,EAAE,CAAC;QAEL,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,EAAE,OAAO,EAAE,eAAe,CAAC;gBACjE,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE;oBACtC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;oBAC5D,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;oBACrC,OAAO,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;SAChC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QACzC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;QAE7C,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAiB,CAAC;QAEzE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../../src/adapters/youtube/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAmEhD,SAAS,cAAc,CACrB,CAAkD,EAClD,QAAQ,GAAG,EAAE;IAEb,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QACrB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE;QACtC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;QAC5D,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;QACrC,OAAO,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;QAC1B,OAAO,EACL,CAAC,CAAC,iBAAiB,EAAE,UAAU;YAC/B,CAAC,CAAC,iBAAiB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,EAAE;KACL,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAA8B,EAC9B,QAAgB;IAKhB,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,KAAK,GACT,IAAI,CAAC,wBAAwB,EAAE,oBAAoB,EAAE,mBAAmB;YACtE,EAAE,KAAK,CAAC;QACZ,IAAI,KAAK;YAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAkB;IAI1D,MAAM,SAAS,GAAG,IAAI,CAAC,2BAA2B,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,MAAM,uBAAuB,GAC3B,EAAE,CAAC;IAEL,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,EAAE,CAAC,8BAA8B,EAAE,iBAAiB;YACpD,EAAE,CAAC,6BAA6B,EAAE,iBAAiB;YACnD,EAAE,CAAC;QAEL,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC;gBAC9C,MAAM,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC;gBAC7C,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,CAAC;gBACpE,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACtD,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC7B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,kBAAkB,EAAE,CAAC;oBACjD,uBAAuB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GACZ,IAAI,CAAC,WAAW,EAAE,uBAAuB,EAAE,YAAY,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE,EAAE,eAAe,KAAK,GAAG,CAAC,EAAE;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE;gBACnE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBACxB,KAAK,EACH,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;oBACrC,CAAC,CAAC,OAAO,CAAC,WAAW;oBACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;gBACtC,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,4BAA4B,CACnC,IAAkB,EAClB,QAAgB;IAEhB,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,2BAA2B,IAAI,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GACT,EAAE,CAAC,8BAA8B,EAAE,iBAAiB;YACpD,EAAE,CAAC,6BAA6B,EAAE,iBAAiB;YACnD,EAAE,CAAC;QACL,KAAK,MAAM,IAAI,IAAI,KAAkB,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAI,IAA8B,CAAC,eAAe,CAAC;YACjE,IAAI,QAAQ;gBAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,4BAA4B;IACzC,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,kBAAkB;SAChC;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,wBAAwB;SACtC;QACD;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,gCAAgC;SAC9C;KACF;IACD,OAAO,EAAE;QACP,UAAU;QACV,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,OAAO;QACP,MAAM;QACN,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;KACV;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QACzC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAiB,CAAC;QACzE,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAE5C,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,YAAY,IAAI,SAAS,CAAC,uBAAuB,EAAE,CAAC;gBAC7D,MAAM,SAAS,GAAG,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE;oBAC9C,YAAY,EAAE,YAAY,CAAC,KAAK;iBACjC,CAAC,CAAiB,CAAC;gBACpB,IAAI,CAAC,IAAI,CACP,GAAG,4BAA4B,CAAC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,CAClE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,oBAAoB,CAAC,IAAI,EAAE;YAChC,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/youtube/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   YouTube subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public YouTube video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Search-to-transcript social video analysis workflows.
+ * @breaks  Upstream yt-dlp extractor changes can alter subtitle availability.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/youtube/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/youtube/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/youtube/subtitles.js

@@ -0,0 +1,42 @@
+/**
+ * @owner   YouTube subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public YouTube video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Search-to-transcript social video analysis workflows.
+ * @breaks  Upstream yt-dlp extractor changes can alter subtitle availability.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { runVideoSubtitleExtraction } from "../../social/video-text.js";
+cli({
+    site: "youtube",
+    name: "subtitles",
+    description: "Extract LLM-readable subtitles from a YouTube video URL with optional browser-cookie reuse",
+    domain: "www.youtube.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "url",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "YouTube video URL",
+            format: "uri",
+        },
+        {
+            name: "languages",
+            type: "str",
+            default: "zh-Hans,zh,en",
+            description: "Comma-separated subtitle languages",
+        },
+        {
+            name: "cookies-from-browser",
+            type: "str",
+            description: "Browser name for yt-dlp --cookies-from-browser",
+        },
+    ],
+    columns: ["language", "text", "path"],
+    socialCapabilities: ["read", "media", "subtitles"],
+    defaultFormat: "json",
+    func: async (_page, kwargs) => runVideoSubtitleExtraction(kwargs),
+});
+//# sourceMappingURL=subtitles.js.map

package/dist/adapters/youtube/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../../src/adapters/youtube/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,4FAA4F;IAC9F,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,mBAAmB;YAChC,MAAM,EAAE,KAAK;SACd;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,eAAe;YACxB,WAAW,EAAE,oCAAoC;SAClD;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,gDAAgD;SAC9D;KACF;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;IACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IAClD,aAAa,EAAE,MAAM;IACrB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;CAClE,CAAC,CAAC"}