tt-help-cli-ycl 1.4.30 → 1.4.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-help-cli-ycl",
-  "version": "1.4.30",
+  "version": "1.4.32",
   "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
   "type": "module",
   "bin": {

package/src/cli/attach.js

@@ -1,6 +1,11 @@
 import { TikTokScraper } from "../lib/tiktok-scraper.mjs";
 import { CDNBlockedError } from "../lib/parse-ssr.mjs";
-import { proxy as configuredProxy } from "../lib/constants.js";
+import {
+  proxy as configuredProxy,
+  userId as configuredUserId,
+  saveUserId,
+} from "../lib/constants.js";
+import { getMacOrUuid } from "../lib/mac-or-uuid.js";
 import { createApiClient } from "../lib/api-client.js";
 import v8 from "node:v8";
 
@@ -110,6 +115,15 @@ export async function handleAttach(options) {
     `[Attach] 并行数: ${attachParallel}, 空闲间隔: ${attachInterval}秒, 服务端: ${serverUrl}${countryStr}`,
   );
 
+  // ── 设备标识 ──
+  let userId = configuredUserId;
+  if (!userId) {
+    userId = await getMacOrUuid();
+    saveUserId(userId);
+    attachLog(`[Attach] 未检测到本地用户编号，已生成并使用: ${userId}`);
+  }
+  attachLog(`[Attach] 用户编号: ${userId}`);
+
   const { apiGet, apiPost } = createApiClient({ log: false });
 
   const scraper = new TikTokScraper({
@@ -174,7 +188,7 @@ export async function handleAttach(options) {
           ? `&countries=${encodeURIComponent(attachCountries.join(","))}`
           : "";
       const { total, tasks } = await apiGet(
-        `${serverUrl}/api/user-update-tasks?limit=${attachParallel}${countryParam}`,
+        `${serverUrl}/api/user-update-tasks?limit=${attachParallel}&userId=${encodeURIComponent(userId)}${countryParam}`,
       );
 
       if (!tasks || tasks.length === 0) {

package/src/cli/comments.js

@@ -683,8 +683,8 @@ async function runAutoMode(options) {
         let tasks;
         try {
           const apiUrl = jobLocations
-            ? `${serverUrl}/api/comment-tasks?limit=${actualParallel}&locations=${encodeURIComponent(jobLocations)}`
-            : `${serverUrl}/api/comment-tasks?limit=${actualParallel}`;
+            ? `${serverUrl}/api/comment-tasks?limit=${actualParallel}&locations=${encodeURIComponent(jobLocations)}&userId=${encodeURIComponent(userId)}`
+            : `${serverUrl}/api/comment-tasks?limit=${actualParallel}&userId=${encodeURIComponent(userId)}`;
           const resp = await apiGet(apiUrl);
           tasks = resp.tasks || [];
         } catch (err) {
@@ -736,15 +736,13 @@ async function runAutoMode(options) {
             try {
               const modals = await detectModals(session.page);
               const loginModal = modals.find(
-                (m) =>
-                  m.type === "login-modal" || m.type === "modal-container",
+                (m) => m.type === "login-modal" || m.type === "modal-container",
               );
               if (loginModal) {
                 console.error(`        🔔 检测到登录弹窗，正在关闭...`);
-                const { closed, failed } = await closeAllModals(
-                  session.page,
-                  { waitMs: 300 },
-                );
+                const { closed, failed } = await closeAllModals(session.page, {
+                  waitMs: 300,
+                });
                 console.error(
                   `        🔔 弹窗关闭: closed=${JSON.stringify(closed)} failed=${JSON.stringify(failed)}`,
                 );

package/src/cli/explore.js

@@ -168,6 +168,9 @@ export async function handleExplore(options) {
 
     const page = await getOrCreatePage(browser);
 
+    // 创建专用商品页（后台复用，避免重复打开/关闭闪屏）
+    const shopPage = await browser.contexts()[0].newPage();
+
     // 先导航到 TikTok 页面，再检测登录状态
     await withRetry("启动页面导航", async () => {
       await page.goto(STARTUP_TIKTOK_URL, {
@@ -397,6 +400,7 @@ export async function handleExplore(options) {
               location: exploreLocation,
               proxyServer: cdpOptions.proxyServer || null,
               browser,
+              shopPage,
             },
             console.error,
           );
@@ -435,6 +439,7 @@ export async function handleExplore(options) {
                 location: exploreLocation,
                 proxyServer: cdpOptions.proxyServer || null,
                 browser,
+                shopPage,
               },
               console.error,
             );
@@ -521,6 +526,9 @@ export async function handleExplore(options) {
 
         const payload = {
           userInfo: result.userInfo || {},
+          recentEcVideos: result.recentEcVideos || null,
+          topRecentVideo: result.topRecentVideo || null,
+          productDetail: result.productDetail || null,
           discoveredFollowing: (result.discoveredFollowing || []).map((f) => ({
             handle: Array.isArray(f) ? f[0] : f,
             displayName: Array.isArray(f) ? f[1] : null,

package/src/cli/recheck.js

@@ -8,7 +8,12 @@
 
 import { TikTokScraper } from "../lib/tiktok-scraper.mjs";
 import { CDNBlockedError } from "../lib/parse-ssr.mjs";
-import { proxy as configuredProxy } from "../lib/constants.js";
+import {
+  proxy as configuredProxy,
+  userId as configuredUserId,
+  saveUserId,
+} from "../lib/constants.js";
+import { getMacOrUuid } from "../lib/mac-or-uuid.js";
 import { createApiClient } from "../lib/api-client.js";
 import v8 from "node:v8";
 
@@ -120,6 +125,15 @@ export async function handleRecheck(options) {
     `[Recheck] 并行数: ${attachParallel}, 空闲间隔: ${attachInterval}秒, 服务端: ${serverUrl}${countryStr}`,
   );
 
+  // ── 设备标识 ──
+  let userId = configuredUserId;
+  if (!userId) {
+    userId = await getMacOrUuid();
+    saveUserId(userId);
+    recheckLog(`[Recheck] 未检测到本地用户编号，已生成并使用: ${userId}`);
+  }
+  recheckLog(`[Recheck] 用户编号: ${userId}`);
+
   const { apiGet, apiPost } = createApiClient({ log: false });
 
   const scraper = new TikTokScraper({
@@ -189,7 +203,7 @@ export async function handleRecheck(options) {
           ? `&countries=${encodeURIComponent(attachCountries.join(","))}`
           : "";
       const { total, tasks } = await apiGet(
-        `${serverUrl}/api/recheck-jobs?limit=${attachParallel}${countryParam}`,
+        `${serverUrl}/api/recheck-jobs?limit=${attachParallel}&userId=${encodeURIComponent(userId)}${countryParam}`,
       );
 
       if (!tasks || tasks.length === 0) {

package/src/cli/refresh.js

@@ -170,6 +170,9 @@ export async function handleRefresh(options) {
 
     const page = await getOrCreatePage(browser);
 
+    // 创建专用商品页（后台复用，避免重复打开/关闭闪屏）
+    const shopPage = await browser.contexts()[0].newPage();
+
     // 导航到 TikTok 页面
     await withRetry("启动页面导航", async () => {
       await page.goto(STARTUP_TIKTOK_URL, {
@@ -381,6 +384,7 @@ export async function handleRefresh(options) {
           location: exploreLocation,
           locationMode: "refresh",
           browser,
+          shopPage,
           proxyServer: cdpOptions.proxyServer || null,
         },
         console.error,
@@ -407,6 +411,7 @@ export async function handleRefresh(options) {
             location: exploreLocation,
             locationMode: "refresh",
             browser,
+            shopPage,
             proxyServer: cdpOptions.proxyServer || null,
           },
           console.error,
@@ -446,6 +451,7 @@ export async function handleRefresh(options) {
               location: exploreLocation,
               locationMode: "refresh",
               browser,
+              shopPage,
               proxyServer: cdpOptions.proxyServer || null,
             },
             console.error,
@@ -542,6 +548,8 @@ export async function handleRefresh(options) {
       const payload = {
         userInfo: refreshUserInfo,
         recentEcVideos: result.recentEcVideos || null,
+        topRecentVideo: result.topRecentVideo || null,
+        productDetail: result.productDetail || null,
         discoveredFollowing: (result.discoveredFollowing || []).map((f) => ({
           handle: Array.isArray(f) ? f[0] : f,
           displayName: Array.isArray(f) ? f[1] : null,

package/src/cli/search.js

@@ -43,7 +43,10 @@ import { HealthChecker } from "../lib/browser/health-checker.js";
 import {
   server as cfgServer,
   proxy as configuredProxy,
+  userId as configuredUserId,
+  saveUserId,
 } from "../lib/constants.js";
+import { getMacOrUuid } from "../lib/mac-or-uuid.js";
 
 const DEFAULT_SERVER = cfgServer || "http://127.0.0.1:3000";
 const STARTUP_TIKTOK_URL = "https://www.tiktok.com/@ycl5007";
@@ -71,6 +74,7 @@ export async function handleSearch(parsed) {
     serverUrl,
     basePort = 3333,
     portCount = 10,
+    parallel = 1,
     proxy: cliProxy,
   } = searchOpts || {};
 
@@ -128,6 +132,15 @@ export async function handleSearch(parsed) {
     meta: { port: cdpOptions.port, type: "tag-search" },
   });
 
+  // ── 设备标识 ──
+  let userId = configuredUserId;
+  if (!userId) {
+    userId = await getMacOrUuid();
+    saveUserId(userId);
+    log(`[Search] 未检测到本地用户编号，已生成并使用: ${userId}`);
+  }
+  log(`[Search] 用户编号: ${userId}`);
+
   setDelayConfig("normal");
 
   try {
@@ -196,7 +209,9 @@ export async function handleSearch(parsed) {
       try {
         return await p.evaluate(async () => {
           try {
-            const res = await fetch("https://www.tiktok.com/passport/web/account/info/");
+            const res = await fetch(
+              "https://www.tiktok.com/passport/web/account/info/",
+            );
             const data = await res.json();
             return data?.data?.unique_id || null;
           } catch {}
@@ -366,9 +381,12 @@ export async function handleSearch(parsed) {
         await delay(switchMax, switchMax * 3);
 
         // ── 1. 获取搜索任务 ──
-        const taskRes = await fetch(`${baseUrl}/api/tags/search-task`, {
-          headers: headers(),
-        });
+        const taskRes = await fetch(
+          `${baseUrl}/api/tags/search-task?userId=${encodeURIComponent(userId)}`,
+          {
+            headers: headers(),
+          },
+        );
         const task = await taskRes.json();
 
         if (!task.tag) {
@@ -393,11 +411,14 @@ export async function handleSearch(parsed) {
         );
 
         // ── 2. 锁定标签 ──
-        const claimRes = await fetch(`${baseUrl}/api/tags/search-claim`, {
-          method: "POST",
-          headers: headers({ "Content-Type": "application/json" }),
-          body: JSON.stringify({ tag }),
-        });
+        const claimRes = await fetch(
+          `${baseUrl}/api/tags/search-claim?userId=${encodeURIComponent(userId)}`,
+          {
+            method: "POST",
+            headers: headers({ "Content-Type": "application/json" }),
+            body: JSON.stringify({ tag }),
+          },
+        );
         const claimData = await claimRes.json();
         if (!claimData.ok) {
           log(`  ⏭️ ${claimData.error}，跳过`);
@@ -410,6 +431,7 @@ export async function handleSearch(parsed) {
         let searchError = null;
         try {
           ids = await collectSearchAuthors(browser, tag, {
+            parallel,
             log,
             exclude: myUsername ? [myUsername] : [],
           });
@@ -432,6 +454,7 @@ export async function handleSearch(parsed) {
           // 重试搜索
           try {
             ids = await collectSearchAuthors(browser, tag, {
+              parallel,
               log,
               exclude: myUsername ? [myUsername] : [],
             });
@@ -457,6 +480,7 @@ export async function handleSearch(parsed) {
             await new Promise((r) => setTimeout(r, 5000));
             try {
               ids = await collectSearchAuthors(browser, tag, {
+                parallel,
                 log,
                 exclude: myUsername ? [myUsername] : [],
               });
@@ -485,11 +509,14 @@ export async function handleSearch(parsed) {
           ).catch(() => {});
 
           // 仍提交空结果，释放标签锁定
-          await fetch(`${baseUrl}/api/tags/search-result`, {
-            method: "POST",
-            headers: headers({ "Content-Type": "application/json" }),
-            body: JSON.stringify({ tag, authors: [], country }),
-          }).catch(() => {});
+          await fetch(
+            `${baseUrl}/api/tags/search-result?userId=${encodeURIComponent(userId)}`,
+            {
+              method: "POST",
+              headers: headers({ "Content-Type": "application/json" }),
+              body: JSON.stringify({ tag, authors: [], country }),
+            },
+          ).catch(() => {});
           log(`  提交: 0 个作者（搜索异常）`);
           totalSearched++;
           continue;
@@ -525,20 +552,26 @@ export async function handleSearch(parsed) {
         // ── 4. 提交结果 ──
         let pushed = 0;
         if (ids.length > 0) {
-          const resultRes = await fetch(`${baseUrl}/api/tags/search-result`, {
-            method: "POST",
-            headers: headers({ "Content-Type": "application/json" }),
-            body: JSON.stringify({ tag, authors: ids, country }),
-          });
+          const resultRes = await fetch(
+            `${baseUrl}/api/tags/search-result?userId=${encodeURIComponent(userId)}`,
+            {
+              method: "POST",
+              headers: headers({ "Content-Type": "application/json" }),
+              body: JSON.stringify({ tag, authors: ids, country }),
+            },
+          );
           const result = await resultRes.json();
           pushed = result.pushed || 0;
           log(`  提交: 新增 ${pushed} 个, 跳过 ${result.skipped} 个`);
         } else {
-          await fetch(`${baseUrl}/api/tags/search-result`, {
-            method: "POST",
-            headers: headers({ "Content-Type": "application/json" }),
-            body: JSON.stringify({ tag, authors: [], country }),
-          });
+          await fetch(
+            `${baseUrl}/api/tags/search-result?userId=${encodeURIComponent(userId)}`,
+            {
+              method: "POST",
+              headers: headers({ "Content-Type": "application/json" }),
+              body: JSON.stringify({ tag, authors: [], country }),
+            },
+          );
           log(`  提交: 0 个作者`);
         }
 

package/src/cli/tag.js

@@ -724,9 +724,10 @@ export async function handleScore(parsed) {
   log("");
 }
 
-async function reportToServer(baseUrl, result, clientId, meta) {
+async function reportToServer(baseUrl, result, clientId, meta, userId = "") {
   try {
-    const res = await fetch(`${baseUrl}/api/tags/score-result`, {
+    const userIdParam = userId ? `?userId=${encodeURIComponent(userId)}` : "";
+    const res = await fetch(`${baseUrl}/api/tags/score-result${userIdParam}`, {
       method: "POST",
       headers: buildClientHeaders(clientId, meta, {
         "Content-Type": "application/json",
@@ -972,9 +973,12 @@ export async function handleScoreAll(parsed) {
     while (true) {
       try {
         // 从服务端取下一个 new 标签（同时查剩余数量）
-        const tagsRes = await fetch(`${baseUrl}/api/tags?status=new&limit=1`, {
-          headers: buildClientHeaders(clientId, clientMeta),
-        });
+        const tagsRes = await fetch(
+          `${baseUrl}/api/tags?status=new&limit=1&userId=${encodeURIComponent(userId)}`,
+          {
+            headers: buildClientHeaders(clientId, clientMeta),
+          },
+        );
         const tagsData = await tagsRes.json();
 
         if (!tagsData.tags || tagsData.tags.length === 0) {
@@ -1018,13 +1022,16 @@ export async function handleScoreAll(parsed) {
         };
 
         // 锁定 tag（meta 中不放入 tag，避免非 ASCII 字符导致 header ByteString 报错）
-        const claimRes = await fetch(`${baseUrl}/api/tags/claim`, {
-          method: "POST",
-          headers: buildClientHeaders(clientId, clientMeta, {
-            "Content-Type": "application/json",
-          }),
-          body: JSON.stringify({ tag }),
-        });
+        const claimRes = await fetch(
+          `${baseUrl}/api/tags/claim?userId=${encodeURIComponent(userId)}`,
+          {
+            method: "POST",
+            headers: buildClientHeaders(clientId, clientMeta, {
+              "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({ tag }),
+          },
+        );
         const claimData = await claimRes.json();
         if (!claimData.ok) {
           // already claimed: 其他机器抢先了，跳过不标 dead
@@ -1036,7 +1043,7 @@ export async function handleScoreAll(parsed) {
           log(`  ⚠️ 无法锁定 (${claimData.error})，标记为 dead 并跳过`);
           result.error = claimData.error;
           result.status = "dead";
-          await reportToServer(baseUrl, result, clientId, clientMeta);
+          await reportToServer(baseUrl, result, clientId, clientMeta, userId);
           totalScored++;
           await recyclePage();
           continue;
@@ -1068,7 +1075,7 @@ export async function handleScoreAll(parsed) {
             log(`  ⚠️ 标签不存在 (${deadSec}s)，标记 dead`);
             result.status = "dead";
             result.error = "tag_not_found";
-            await reportToServer(baseUrl, result, clientId, clientMeta);
+            await reportToServer(baseUrl, result, clientId, clientMeta, userId);
             totalScored++;
             await randomDelay(0, 5000);
             await recyclePage();
@@ -1128,7 +1135,7 @@ export async function handleScoreAll(parsed) {
         }
 
         // 上报结果
-        await reportToServer(baseUrl, result, clientId, clientMeta);
+        await reportToServer(baseUrl, result, clientId, clientMeta, userId);
 
         totalScored++;
         const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
@@ -1622,9 +1629,12 @@ export async function handleTagRefresh(parsed) {
     while (true) {
       try {
         // 从服务端获取下一个 productive 标签
-        const taskRes = await fetch(`${baseUrl}/api/tags/refresh-task`, {
-          headers: buildClientHeaders(clientId, clientMeta),
-        });
+        const taskRes = await fetch(
+          `${baseUrl}/api/tags/refresh-task?userId=${encodeURIComponent(userId)}`,
+          {
+            headers: buildClientHeaders(clientId, clientMeta),
+          },
+        );
         const taskData = await taskRes.json();
 
         if (!taskData.tag) {
@@ -1661,13 +1671,16 @@ export async function handleTagRefresh(parsed) {
         };
 
         // 锁定标签
-        const claimRes = await fetch(`${baseUrl}/api/tags/refresh-claim`, {
-          method: "POST",
-          headers: buildClientHeaders(clientId, clientMeta, {
-            "Content-Type": "application/json",
-          }),
-          body: JSON.stringify({ tag }),
-        });
+        const claimRes = await fetch(
+          `${baseUrl}/api/tags/refresh-claim?userId=${encodeURIComponent(userId)}`,
+          {
+            method: "POST",
+            headers: buildClientHeaders(clientId, clientMeta, {
+              "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({ tag }),
+          },
+        );
         const claimData = await claimRes.json();
         if (!claimData.ok) {
           if (
@@ -1705,13 +1718,20 @@ export async function handleTagRefresh(parsed) {
           const deadSec = ((Date.now() - fetchStart) / 1000).toFixed(1);
           log(`  ⚠️ 无视频 (${deadSec}s)，保留 productive 状态，等待下次刷新`);
           result.error = "no videos found";
-          await fetch(`${baseUrl}/api/tags/refresh-result`, {
-            method: "POST",
-            headers: buildClientHeaders(clientId, clientMeta, {
-              "Content-Type": "application/json",
-            }),
-            body: JSON.stringify({ tag, pushedUsers: 0, error: result.error }),
-          }).catch(() => {});
+          await fetch(
+            `${baseUrl}/api/tags/refresh-result?userId=${encodeURIComponent(userId)}`,
+            {
+              method: "POST",
+              headers: buildClientHeaders(clientId, clientMeta, {
+                "Content-Type": "application/json",
+              }),
+              body: JSON.stringify({
+                tag,
+                pushedUsers: 0,
+                error: result.error,
+              }),
+            },
+          ).catch(() => {});
           totalRefreshed++;
           await randomDelay(0, 5000);
           await recyclePage();
@@ -1775,17 +1795,20 @@ export async function handleTagRefresh(parsed) {
         }
 
         // 上报刷新结果（只更新 pushed_users，不改变 score/status）
-        await fetch(`${baseUrl}/api/tags/refresh-result`, {
-          method: "POST",
-          headers: buildClientHeaders(clientId, clientMeta, {
-            "Content-Type": "application/json",
-          }),
-          body: JSON.stringify({
-            tag,
-            pushedUsers: result.pushedUsers,
-            error: result.error,
-          }),
-        }).catch(() => {});
+        await fetch(
+          `${baseUrl}/api/tags/refresh-result?userId=${encodeURIComponent(userId)}`,
+          {
+            method: "POST",
+            headers: buildClientHeaders(clientId, clientMeta, {
+              "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({
+              tag,
+              pushedUsers: result.pushedUsers,
+              error: result.error,
+            }),
+          },
+        ).catch(() => {});
 
         totalRefreshed++;
         const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);

package/src/lib/api-interceptor.js

@@ -5,6 +5,65 @@ import {
   detectPageErrorWithWait,
 } from "./page-error-detector.js";
 
+/**
+ * 从 item.anchors 中提取 TikTok Shop 商品信息
+ * anchors[].extra 是两层 JSON 字符串：
+ *   第1层 parse → [{id, keyword, component_key, extra: "...", ...}]
+ *   第2层 parse → {product_id, title, seo_url, skus, seller_id, ...}
+ *
+ * 注意：product_id / seller_id 为 19 位数字，超出 JS Number.MAX_SAFE_INTEGER，
+ * 必须用正则从原始字符串中提取，避免 JSON.parse 精度丢失。
+ */
+function extractProductInfo(item) {
+  if (!item.anchors || !Array.isArray(item.anchors)) return null;
+  for (const anchor of item.anchors) {
+    try {
+      const extraArr = JSON.parse(anchor.extra || "[]");
+      if (!Array.isArray(extraArr)) continue;
+      for (const e of extraArr) {
+        if (!e.extra || !e.extra.includes("product_id")) continue;
+
+        // 从原始 JSON 字符串中用正则提取，绕过 JS 大整数精度问题
+        const raw = e.extra;
+        const pidMatch = raw.match(/"product_id":(\d+)/);
+        const sidMatch = raw.match(/"seller_id":"?(\d+)"?/);
+        const seoMatch = raw.match(/"seo_url":"((?:[^"\\]|\\.)*)"/);
+        const titleMatch = raw.match(/"title":"((?:[^"\\]|\\.)*)"/);
+
+        return {
+          productId: pidMatch ? pidMatch[1] : "",
+          productTitle: titleMatch ? titleMatch[1] : e.keyword || "",
+          seoUrl: seoMatch ? seoMatch[1] : "",
+          sellerId: sidMatch ? sidMatch[1] : "",
+        };
+      }
+    } catch {
+      // 解析失败则跳过该 anchor
+    }
+  }
+  return null;
+}
+
+/**
+ * 构建统一的视频对象
+ */
+function buildVideoObject(item, username) {
+  const href = `https://www.tiktok.com/@${username}/video/${item.id}`;
+  const productInfo = extractProductInfo(item);
+  return {
+    id: item.id,
+    href,
+    createTime: item.createTime || null,
+    playCount: item.stats?.playCount || 0,
+    isECVideo: item.isECVideo ? 1 : 0,
+    isAd: item.isAd ? 1 : 0,
+    productId: productInfo?.productId || null,
+    productTitle: productInfo?.productTitle || null,
+    seoUrl: productInfo?.seoUrl || null,
+    sellerId: productInfo?.sellerId || null,
+  };
+}
+
 async function processAPIResponse(
   data,
   username,
@@ -17,15 +76,7 @@ async function processAPIResponse(
   const firstPageItems = data.itemList || [];
   for (const item of firstPageItems) {
     if (items.length >= maxVideos) break;
-    const href = `https://www.tiktok.com/@${username}/video/${item.id}`;
-    items.push({
-      id: item.id,
-      href,
-      createTime: item.createTime || null,
-      playCount: item.stats?.playCount || 0,
-      isECVideo: item.isECVideo ? 1 : 0,
-      isAd: item.isAd ? 1 : 0,
-    });
+    items.push(buildVideoObject(item, username));
   }
 
   let cursor = data.cursor;
@@ -68,15 +119,7 @@ async function processAPIResponse(
       if (pageData && pageData.itemList) {
         for (const item of pageData.itemList) {
           if (items.length >= maxVideos) break;
-          const href = `https://www.tiktok.com/@${username}/video/${item.id}`;
-          items.push({
-            id: item.id,
-            href,
-            createTime: item.createTime || null,
-            playCount: item.stats?.playCount || 0,
-            isECVideo: item.isECVideo ? 1 : 0,
-            isAd: item.isAd ? 1 : 0,
-          });
+          items.push(buildVideoObject(item, username));
         }
       }
 

package/src/lib/args.js

@@ -560,6 +560,7 @@ function parseSearchArgs(args) {
   let serverUrl = null;
   let basePort = 3333;
   let portCount = 10;
+  let parallel = 1;
   let proxy = null;
 
   for (let i = 0; i < args.length; i++) {
@@ -570,6 +571,8 @@ function parseSearchArgs(args) {
       basePort = parseInt(args[++i]) || 3333;
     } else if (arg === "--port-count") {
       portCount = parseInt(args[++i]) || 10;
+    } else if (arg === "-p" || arg === "--parallel") {
+      parallel = parseInt(args[++i]) || 1;
     } else if (arg === "--proxy") {
       proxy = args[++i];
     }
@@ -577,7 +580,7 @@ function parseSearchArgs(args) {
 
   return {
     subcommand: "search",
-    search: { serverUrl, basePort, portCount, proxy },
+    search: { serverUrl, basePort, portCount, parallel, proxy },
     urls: [],
     outputFormat: "json",
     exploreCount: 0,