channel-worker 2.5.105 → 2.5.107

package/lib/api-client.js

@@ -68,7 +68,7 @@ class ApiClient {
   async getNextCommand(workerId) {
     // Daemon-handled types. `_pw` variants route to the Playwright pipeline
     // (lib/playwright-runner → scripts/<base>.js) instead of the extension.
-    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link';
+    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,comment_facebook_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link';
     return this.request('GET', `/workers/commands?worker_id=${workerId}&types=${encodeURIComponent(workerTypes)}`);
   }
 

package/lib/command-poller.js

@@ -200,10 +200,17 @@ class CommandPoller {
     let conn;
     try {
       conn = await this._connectNstProfileByName(profileName);
+      // Từ khoá và ngành hàng loại trừ nhau: có keyword thì KHÔNG được để
+      // `category` rơi về mặc định 'women_clothes', không thì scrapeOffers nhận
+      // cả hai và lượt tìm im lặng biến thành lượt duyệt tab quần áo nữ.
+      const keyword = String(payload.keyword || '').trim();
       const res = await scraper.scrapeOffers(conn.context, {
-        category: payload.category || 'women_clothes',   // Tier-1 default: quần áo nữ
-        match_id: payload.match_id || null,
-        sort_types: payload.sort_types || [2, 3],         // commission + sales, merged
+        keyword: keyword || null,
+        category: keyword ? null : (payload.category || 'women_clothes'),   // Tier-1 default: quần áo nữ
+        match_id: keyword ? null : (payload.match_id || null),
+        // Ở chế độ từ khoá, sort_type 3 là GIÁ GIẢM DẦN chứ không phải doanh số
+        // (đo 09/09) — scrapeOffers tự cắt, đây chỉ là không đưa vào cho đỡ rối.
+        sort_types: payload.sort_types || (keyword ? [2] : [2, 3]),         // commission + sales, merged
         pages: payload.pages ?? 2,
         page_limit: payload.page_limit ?? 20,
         delay_ms: payload.delay_ms ?? 2500,               // human-like pacing (anti-bot)
@@ -217,9 +224,24 @@ class CommandPoller {
         await this.api.updateCommand(command._id, { status: 'done', result: { needs_verify: true, reason: res.reason, count: res.products?.length || 0 } });
         return;
       }
-      console.log(`[shopee] scraped ${res.raw_count} raw → ${res.products.length} after filters from ${profileName}`);
+      console.log(`[shopee] scraped ${res.raw_count} raw → ${res.products.length} after filters from ${profileName}${keyword ? ` (từ khoá "${keyword}")` : ''}`);
       await this.api.upsertAffiliateProducts(res.products, { user_id: command.user_id });
-      await this.api.updateCommand(command._id, { status: 'done', result: { count: res.products.length, raw: res.raw_count } });
+      // Lượt tìm theo từ khoá trả kèm CHÍNH danh sách tìm được, không chỉ đếm:
+      // bên gọi phải chấm chọn đúng trên những món của lượt này. Đọc lại từ kho
+      // thì lẫn hàng của các lượt trước và mất luôn thứ tự Shopee xếp.
+      // Cắt gọn để kết quả lệnh không phình (ảnh/biến thể ở lại trong kho).
+      const slim = keyword
+        ? res.products.slice(0, 20).map((r) => ({
+          shop_id: r.shop_id, item_id: r.item_id, name: r.name, price: r.price,
+          commission_rate: r.commission_rate, commission_value: r.commission_value,
+          sold_count: r.sold_count, rating: r.rating, cover_image: r.cover_image,
+          product_url: r.product_url, category_group: r.category_group,
+        }))
+        : undefined;
+      await this.api.updateCommand(command._id, {
+        status: 'done',
+        result: { count: res.products.length, raw: res.raw_count, keyword: res.keyword || null, ...(slim ? { products: slim } : {}) },
+      });
     } catch (err) {
       console.error(`[shopee] scrape failed: ${err.message}`);
       await this.api.updateCommand(command._id, { status: 'failed', error: String(err.message || err).slice(0, 500) });
@@ -441,7 +463,7 @@ class CommandPoller {
       //
       // Scoped to the browse-only scripts. Publish keeps its profile open on
       // purpose: one profile serves several platform uploads back-to-back.
-      const CLOSE_AFTER = new Set(['nurture_facebook', 'warmup_facebook', 'warmup_youtube', 'warmup_tiktok', 'fetch_facebook_reel_stats']);
+      const CLOSE_AFTER = new Set(['nurture_facebook', 'warmup_facebook', 'warmup_youtube', 'warmup_tiktok', 'fetch_facebook_reel_stats', 'comment_facebook']);
       // Cờ vừa bị TẮT trên web → bỏ profile khỏi sổ giữ mở, để nó quay về vòng
       // đời đóng-mở bình thường ngay từ lượt này.
       if (!keepOpen.enabled && this._keptOpenProfiles) this._keptOpenProfiles.delete(profileId);

package/lib/shopee-scraper.js

@@ -246,6 +246,14 @@ function applyFilters(rows, f = {}) {
 async function scrapeOffers(ctx, {
   category = null,        // key in AFFILIATE_CATEGORIES (e.g. 'women_clothes')
   match_id = null,        // explicit category id override
+  // Tìm theo TỪ KHOÁ thay vì duyệt tab ngành hàng. Cùng endpoint, khác tham số:
+  // `list_type=0&keyword=<kw>&filter_types=2` (đo 09/09/2026 — ghi chú cũ bảo
+  // "cần signed header" là sai/lạc hậu).
+  //
+  // Đây là thứ gỡ bế tắc kho bão hoà: 6 tab ngành hàng luôn trả về top N giống
+  // nhau nên kho đứng yên ở 34 sản phẩm. Từ khoá thì mở ra đúng món hợp với
+  // từng video.
+  keyword = null,
   sort_types = [2],      // [2]=commission; pass [2,3] to merge commission+sales
   pages = 2,
   page_limit = 20,
@@ -256,6 +264,18 @@ async function scrapeOffers(ctx, {
   sort_type = null,
 } = {}) {
   if (sort_type != null) sort_types = [sort_type];
+  const kw = String(keyword || '').trim();
+  // ⚠️ Ý NGHĨA CỦA sort_type ĐỔI KHI TÌM THEO TỪ KHOÁ (đo 09/09/2026):
+  //   2 = bán chạy   ← thứ mình muốn
+  //   3 = GIÁ GIẢM DẦN, không phải doanh số (khác hẳn chế độ duyệt tab)
+  //   1 = liên quan, trả về toàn hàng bán 0 / 0 sao
+  // Mặc định của hàm là [2] nên chế độ từ khoá đã đúng sẵn; nhưng bên gọi quen
+  // tay truyền [2,3] như lúc quét tab thì một nửa kết quả là hàng đắt nhất chứ
+  // không phải hàng bán chạy. Cắt 3 đi và nói ra, đừng lặng lẽ quét rác.
+  if (kw && sort_types.includes(3)) {
+    sort_types = sort_types.filter((x) => x !== 3);
+    if (!sort_types.length) sort_types = [2];
+  }
   const cat = category && AFFILIATE_CATEGORIES[category] ? AFFILIATE_CATEGORIES[category] : null;
   const mid = match_id || cat?.match_id || null;
   // Default the category_groups filter to the category's own group (so a
@@ -285,15 +305,20 @@ async function scrapeOffers(ctx, {
       for (let i = 0; i < pages; i++) {
         const offset = i * page_limit;
         const res = await page.evaluate(async (q) => {
-          const cat = q.listType
-            ? `&list_type=${q.listType}`
-            : (q.mid ? `&list_type=3&match_type=2&match_id=${q.mid}` : '&list_type=0');
+          // Từ khoá đứng TRƯỚC ngành hàng: hai chế độ loại trừ nhau, gửi cả hai
+          // thì Shopee bỏ qua keyword và mình tưởng đang tìm mà thật ra vẫn
+          // đang duyệt tab cũ.
+          const cat = q.kw
+            ? `&list_type=0&keyword=${encodeURIComponent(q.kw)}&filter_types=2`
+            : (q.listType
+              ? `&list_type=${q.listType}`
+              : (q.mid ? `&list_type=3&match_type=2&match_id=${q.mid}` : '&list_type=0'));
           const url = `/api/v3/offer/product/list?sort_type=${q.st}&page_offset=${q.offset}&page_limit=${q.page_limit}&client_type=1${cat}`;
           try {
             const r = await fetch(url, { credentials: 'include' });
             return { status: r.status, json: await r.json().catch(() => null) };
           } catch (e) { return { status: 0, error: String(e.message) }; }
-        }, { st, offset, page_limit, mid, listType });
+        }, { st, offset, page_limit, mid, listType, kw });
 
         if (isBlockedState(page.url(), res) || res.json?.code === 90309999) {
           return { status: 'needs_verify', products: [...byId.values()], raw_count: rawCount, reason: `blocked mid-scrape (http ${res.status}, code ${res.json?.code})` };
@@ -314,7 +339,10 @@ async function scrapeOffers(ctx, {
     }
 
     const products = applyFilters([...byId.values()], filters);
-    return { status: 'ok', products, raw_count: rawCount };
+    // `keyword` đi kèm kết quả để bên gọi ghi lại sản phẩm tìm được theo từ
+    // khoá nào — không có nó thì kho chỉ biết "có món này", không biết vì sao
+    // nó được nhặt về, và lượt chấm điểm hợp-video sau này mất căn cứ.
+    return { status: 'ok', products, raw_count: rawCount, keyword: kw || null };
   } finally {
     if (opened) await page.close().catch(() => {});
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "channel-worker",
-  "version": "2.5.105",
+  "version": "2.5.107",
   "description": "Channel Manager worker daemon — runs on remote machines to execute video pipeline jobs",
   "main": "lib/daemon.js",
   "bin": {

package/scripts/comment_facebook.js

@@ -0,0 +1,271 @@
+// Thả link affiliate xuống BÌNH LUẬN của một bài Facebook đã đăng, rồi ghim.
+//
+// Vì sao là bình luận chứ không phải caption: bài đang lên view thì không ai đi
+// sửa caption của nó — sửa caption là bài quay lại hàng đợi xét duyệt của
+// Facebook giữa lúc nó đang được phân phối. Bình luận thì ghim được, sửa được,
+// xoá được, không đụng vào bài.
+//
+// Chạy trên chính profile NST của kênh (máy đăng bài) chứ không phải máy
+// Shopee: bình luận phải mang danh Page thì mới ghim được, và một link lạ dưới
+// bài của mình do tài khoản khác thả thì người xem đọc ra là spam.
+//
+// Payload: { post_url, text, link, pin?, idea_id?, channel_id? }
+//   post_url: link bài đã XÁC MINH (API chặn sẵn ô rỗng — services/AffComment)
+//   text:     nguyên câu bình luận sẽ gõ, đã gồm link
+//   link:     riêng chuỗi link, dùng để ĐỌC LẠI xác minh — xem `verified`
+//
+// Trả về { verified, comment_url, commented_as, pinned, post_url }.
+//
+// ⚠️ LUẬT LÕI CỦA SCRIPT NÀY: `verified` chỉ được true khi đã đọc lại thấy một
+// bình luận THẬT trên trang mang đúng chuỗi link. Gõ xong + bấm Enter KHÔNG
+// phải bằng chứng — đó đúng là cách 39 ca "đăng xong mà post_url rỗng" ra đời:
+// script khai thành công theo thao tác của chính nó, không theo thứ trang web
+// hiện ra. API hạ mọi kết quả thiếu `verified` xuống 'failed'.
+
+const { assertAccountUsable, readPublishBlock } = require('./lib/fb-guard');
+const { humanClick, humanType, pause, randInt } = require('./lib/human');
+
+const NAV_TIMEOUT_MS = 45_000;
+// Bình luận hiện ra gần như tức thì, nhưng lượt đầu sau khi mở bài thì Facebook
+// còn đang dựng khung bình luận. 20 giây là dư cho trường hợp chậm nhất đo được
+// mà vẫn không treo lệnh.
+const VERIFY_TIMEOUT_MS = 20_000;
+
+// Ô soạn bình luận. Facebook thay nhãn theo phiên bản giao diện và theo việc
+// đang bình luận với tư cách ai, nên dò theo NHIỀU nhãn thay vì một selector
+// "đúng nhất" — bản trước chỉ có 'Viết bình luận' và trượt sạch trên giao diện
+// tiếng Anh.
+const BOX_SELECTORS = [
+  "[contenteditable='true'][aria-label*='Bình luận']",
+  "[contenteditable='true'][aria-label*='bình luận']",
+  "[contenteditable='true'][aria-label*='Comment']",
+  "[contenteditable='true'][aria-label*='comment']",
+  "[contenteditable='true'][aria-placeholder*='bình luận']",
+  "[contenteditable='true'][aria-placeholder*='comment']",
+  "[role='textbox'][contenteditable='true']",
+];
+
+// Nút mở khung bình luận, khi bài mở ra mà khung chưa dựng.
+const OPEN_COMMENTS_SELECTORS = [
+  "[aria-label='Bình luận'], [aria-label='Comment']",
+  "[aria-label*='Để lại bình luận'], [aria-label*='Leave a comment']",
+];
+
+function sel(list) { return list.join(', '); }
+
+// ─── tìm ô soạn ─────────────────────────────────────────────────────────────
+
+async function findCommentBox(page) {
+  for (const s of BOX_SELECTORS) {
+    const loc = page.locator(s);
+    const n = Math.min(await loc.count().catch(() => 0), 6);
+    for (let i = 0; i < n; i++) {
+      const el = loc.nth(i);
+      if (!(await el.isVisible().catch(() => false))) continue;
+      // Ô soạn BÀI (tường Page) cũng là contenteditable và cũng khớp
+      // `role=textbox` — gõ nhầm vào đó là đăng một bài mới toàn link. Ô bình
+      // luận luôn nằm bên trong khối bài; ô soạn bài thì không.
+      const inArticle = await el.evaluate((node) => !!node.closest("[role='article'], [role='dialog'], [role='complementary']"))
+        .catch(() => false);
+      if (!inArticle && !/comment|bình luận/i.test(s)) continue;
+      return el;
+    }
+  }
+  return null;
+}
+
+async function openCommentsIfNeeded(page, log) {
+  for (const s of OPEN_COMMENTS_SELECTORS) {
+    const loc = page.locator(s).first();
+    if (!(await loc.isVisible().catch(() => false))) continue;
+    log('info', `[fb-cmt] chưa thấy ô soạn — bấm mở khung bình luận ("${s}")`);
+    await humanClick(page, loc).catch(() => {});
+    await pause(page, 1800);
+    return true;
+  }
+  return false;
+}
+
+// ─── đọc lại để xác minh ────────────────────────────────────────────────────
+
+// Tìm bình luận THẬT mang chuỗi `link`. Bỏ qua mọi thứ nằm trong ô soạn: chữ
+// mình vừa gõ cũng khớp chuỗi tìm kiếm, mà nó chưa phải bình luận.
+//
+// Facebook đặt tên tác giả ngay trong aria-label của khối bình luận
+// ("Bình luận của <Tên>" / "Comment by <Name>") — đọc thẳng ở đó chắc hơn dò
+// anchor đầu tiên, vì trong khối còn có link tới bài, tới trang được nhắc tên.
+async function findPostedComment(page, link) {
+  return page.evaluate((needle) => {
+    const out = { found: false, author: '', comment_url: '' };
+    const nodes = [...document.querySelectorAll("[role='article']")];
+    for (const node of nodes) {
+      const txt = node.innerText || '';
+      if (!txt.includes(needle)) continue;
+      // Chính ô soạn (hoặc khối bài) — không tính.
+      if (node.querySelector("[contenteditable='true']") && !node.getAttribute('aria-label')) continue;
+      const label = node.getAttribute('aria-label') || '';
+      const m = /(?:Bình luận của|Comment by)\s+(.+)$/i.exec(label.trim());
+      // Không có aria-label dạng bình luận = nhiều khả năng đây là khối BÀI
+      // chứa chuỗi link trong caption, không phải bình luận.
+      if (!m) continue;
+      out.found = true;
+      out.author = m[1].trim().slice(0, 120);
+      const a = node.querySelector("a[href*='comment_id=']");
+      if (a) {
+        const href = a.getAttribute('href') || '';
+        out.comment_url = href.startsWith('http') ? href : `https://www.facebook.com${href}`;
+      }
+      return out;
+    }
+    return out;
+  }, link).catch(() => ({ found: false, author: '', comment_url: '' }));
+}
+
+async function waitForPostedComment(page, link, log, timeoutMs = VERIFY_TIMEOUT_MS) {
+  const deadline = Date.now() + timeoutMs;
+  let last = { found: false, author: '', comment_url: '' };
+  while (Date.now() < deadline) {
+    last = await findPostedComment(page, link);
+    if (last.found) return last;
+    await page.waitForTimeout(1200);
+  }
+  log('warn', `[fb-cmt] hết ${Math.round(timeoutMs / 1000)}s vẫn chưa đọc lại thấy bình luận mang link`);
+  return last;
+}
+
+// ─── ghim ───────────────────────────────────────────────────────────────────
+
+// Ghim là việc CÓ CŨNG TỐT, không có cũng xong: link đã nằm dưới bài rồi. Nên
+// mọi lỗi ở đây chỉ ghi log và trả false, KHÔNG ném — hỏng bước ghim mà đánh
+// cả lệnh thành thất bại thì lượt chạy lại sẽ thả bình luận thứ hai.
+async function pinComment(page, link, log) {
+  try {
+    const menuBtn = await page.evaluateHandle((needle) => {
+      const nodes = [...document.querySelectorAll("[role='article']")];
+      for (const node of nodes) {
+        if (!(node.innerText || '').includes(needle)) continue;
+        if (!/(Bình luận của|Comment by)/i.test(node.getAttribute('aria-label') || '')) continue;
+        const btn = [...node.querySelectorAll("[role='button'], [aria-haspopup='menu']")]
+          .find((b) => /hành động|tùy chọn|tuỳ chọn|options|actions/i.test(b.getAttribute('aria-label') || ''));
+        if (btn) { btn.scrollIntoView({ block: 'center' }); return btn; }
+      }
+      return null;
+    }, link);
+    const el = menuBtn.asElement();
+    if (!el) { log('info', '[fb-cmt] không thấy nút ⋯ của bình luận — bỏ qua bước ghim'); return false; }
+    await el.click({ timeout: 5000 }).catch(() => {});
+    await pause(page, 1200);
+
+    const item = page.locator("[role='menuitem'], [role='menu'] [role='button']")
+      .filter({ hasText: /Ghim bình luận|Ghim|Pin comment|Pin/i }).first();
+    if (!(await item.isVisible().catch(() => false))) {
+      log('info', '[fb-cmt] menu không có mục Ghim (thường là chưa bình luận bằng danh Page) — bỏ qua');
+      await page.keyboard.press('Escape').catch(() => {});
+      return false;
+    }
+    await item.click({ timeout: 5000 }).catch(() => {});
+    await pause(page, 1500);
+    log('info', '[fb-cmt] đã bấm Ghim bình luận');
+    return true;
+  } catch (e) {
+    log('warn', `[fb-cmt] ghim hỏng (bỏ qua, link vẫn nằm dưới bài): ${e.message.slice(0, 120)}`);
+    return false;
+  }
+}
+
+// ─── thân ───────────────────────────────────────────────────────────────────
+
+async function run({ page, payload = {}, log }) {
+  const postUrl = String(payload.post_url || '').trim();
+  const text = String(payload.text || '').trim();
+  const link = String(payload.link || '').trim();
+  if (!postUrl) throw new Error('thiếu post_url — không biết thả bình luận vào bài nào');
+  if (!text) throw new Error('thiếu text — không có gì để bình luận');
+  if (!link) throw new Error('thiếu link — không có gì để đọc lại xác minh');
+  if (!text.includes(link)) throw new Error('text không chứa link — API dựng sai câu bình luận');
+
+  // Ghé trang chủ TRƯỚC rồi mới sang bài, dù biết thừa link bài.
+  //
+  // Lý do không kiểm tra phiên ngay trên trang bài: lib/fb-guard đọc chữ trong
+  // body để đoán checkpoint/khoá tài khoản, mà trang bài thì đầy BÌNH LUẬN của
+  // người lạ — một người bình luận "tài khoản của bạn đã bị vô hiệu hoá" là đủ
+  // để script tự kết luận kênh mình chết. Trang chủ có feed thật, fb-guard
+  // thấy feed là trả 'ok' ngay, không cần đọc chữ.
+  await page.goto('https://www.facebook.com/', { waitUntil: 'domcontentloaded', timeout: NAV_TIMEOUT_MS }).catch(() => {});
+  await pause(page, 2200);
+  await assertAccountUsable(page, log);
+
+  log('info', `[fb-cmt] mở bài ${postUrl}`);
+  await page.goto(postUrl, { waitUntil: 'domcontentloaded', timeout: NAV_TIMEOUT_MS });
+  await pause(page, 2600);
+
+  // Trang bài mở ra là trang LỖI / bài đã xoá thì dừng ngay, đừng đi tìm ô soạn
+  // rồi báo "không thấy ô bình luận" — hai chuyện khác hẳn nhau khi đọc log.
+  const gone = await page.evaluate(() => {
+    const t = (document.body?.innerText || '').slice(0, 1500);
+    return /(Không có sẵn|nội dung này hiện không có|This content isn't available|Liên kết bị hỏng|Page Not Found)/i.test(t);
+  }).catch(() => false);
+  if (gone) throw new Error(`Bài không mở được (đã xoá, đổi quyền riêng tư, hoặc link sai): ${postUrl}`);
+
+  let box = await findCommentBox(page);
+  if (!box) {
+    await openCommentsIfNeeded(page, log);
+    box = await findCommentBox(page);
+  }
+  if (!box) {
+    await assertAccountUsable(page, log);
+    throw new Error(`Không tìm thấy ô soạn bình luận trên ${postUrl} (đã thử ${BOX_SELECTORS.length} nhãn) — nhiều khả năng bài tắt bình luận hoặc Facebook đổi giao diện`);
+  }
+
+  await box.scrollIntoViewIfNeeded({ timeout: 5000 }).catch(() => {});
+  await humanClick(page, box).catch(async () => { await box.click({ timeout: 5000 }); });
+  await pause(page, 900);
+
+  // typo: 0 — humanType vốn gõ sai rồi tự Backspace cho giống người, nhưng
+  // trong câu này có một URL: một ký tự sai giữa mã link làm Facebook dựng thẻ
+  // xem trước của link KHÁC ngay lúc gõ, và thẻ đó không rút lại bằng Backspace.
+  // Nhịp gõ thì vẫn giữ nguyên chất người.
+  await humanType(page, text, { typo: 0 });
+  await pause(page, randInt(900, 1800));
+
+  await page.keyboard.press('Enter');
+  log('info', '[fb-cmt] đã gửi bình luận — đang đọc lại để xác minh');
+  await pause(page, 2500);
+
+  // Facebook chặn theo tần suất thì nó nuốt bình luận và hiện chữ đỏ. Không
+  // đọc chỗ này là lệnh sẽ báo "không xác minh được" chung chung, và người đọc
+  // log đi tìm lỗi giao diện trong khi thủ phạm là cái phanh chống spam.
+  const block = await readPublishBlock(page);
+  if (block) {
+    throw new Error(`FB_COMMENT_RATE_LIMITED: Facebook chặn bình luận vì tần suất/nghi spam — bình luận KHÔNG được nhận. Chuỗi bắt được: "${block}". Dừng thả link trên kênh này cho tới khi người kiểm tra.`);
+  }
+
+  const found = await waitForPostedComment(page, link, log);
+  if (!found.found) {
+    await assertAccountUsable(page, log);
+    // KHÔNG ném lỗi kiểu "có thể đã thả": trả về verified=false để API ghi
+    // 'failed' kèm nguyên văn. Ném lỗi ở đây thì lượt chạy lại sẽ gõ thêm một
+    // bình luận nữa, mà bình luận trước có thể đã nằm đó rồi.
+    log('warn', '[fb-cmt] gõ và gửi xong nhưng KHÔNG đọc lại thấy bình luận — coi như chưa thả, người phải vào kiểm');
+    return { verified: false, post_url: postUrl, comment_url: '', commented_as: '', pinned: false };
+  }
+
+  log('info', `[fb-cmt] xác minh được bình luận — danh nghĩa "${found.author}"${found.comment_url ? ` · ${found.comment_url}` : ''}`);
+
+  let pinned = false;
+  if (payload.pin !== false) pinned = await pinComment(page, link, log);
+
+  return {
+    verified: true,
+    post_url: postUrl,
+    comment_url: found.comment_url || '',
+    // Tên hiện trên bình luận. Phải là tên Page — ra tên người thì profile đang
+    // bình luận bằng tài khoản cá nhân, link nằm dưới bài mà không ghim được và
+    // người xem đọc ra là spam của người lạ.
+    commented_as: found.author || '',
+    pinned,
+  };
+}
+
+module.exports = { run };
+module.exports.__testables = { findPostedComment, findCommentBox, BOX_SELECTORS, sel };