@pomelolabs/leads 0.0.0-stage → 0.1.1

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: pomelo
+      name: '@pomelolabs/leads'

package/host/browser.js

@@ -0,0 +1,662 @@
+/**
+ * Real local-browser collector.
+ *
+ * Everything here runs in a visible Chromium window with a persistent profile.
+ * The user logs in once; searches then use ordinary mouse/scroll/keyboard input
+ * with human pacing. Platform DOM and risk controls change often, so selectors
+ * are intentionally defensive and failures return a readable error instead of
+ * fabricated rows.
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import puppeteer from 'puppeteer';
+
+const PLATFORM_URLS = {
+  xhs: {
+    label: '小红书',
+    home: 'https://www.xiaohongshu.com/explore',
+    search: (keyword) =>
+      `https://www.xiaohongshu.com/search_result?keyword=${encodeURIComponent(keyword)}&source=web_search_result_notes`,
+  },
+  douyin: {
+    label: '抖音',
+    home: 'https://www.douyin.com/',
+    search: (keyword) => `https://www.douyin.com/search/${encodeURIComponent(keyword)}`,
+  },
+};
+
+function homeDir() {
+  return process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+}
+function profileDir() {
+  return path.join(homeDir(), 'pomelo', 'browser-profile');
+}
+function logDir() {
+  return path.join(homeDir(), 'pomelo', 'logs');
+}
+
+const SYSTEM_BROWSERS = process.platform === 'darwin'
+  ? [
+      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+      '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+      '/Applications/Chromium.app/Contents/MacOS/Chromium',
+      '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+      '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+      path.join(os.homedir(), 'Applications/Google Chrome.app/Contents/MacOS/Google Chrome'),
+    ]
+  : process.platform === 'win32'
+    ? [
+        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+      ]
+    : [
+        '/usr/bin/google-chrome',
+        '/usr/bin/google-chrome-stable',
+        '/usr/bin/chromium',
+        '/usr/bin/chromium-browser',
+        '/usr/bin/microsoft-edge',
+      ];
+
+async function executableAt(candidate) {
+  if (!candidate) return false;
+  try {
+    await fs.access(candidate, fs.constants?.X_OK ?? 0);
+    return true;
+  } catch {
+    try {
+      await fs.access(candidate);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+async function findPlaywrightChromium() {
+  const roots = [
+    path.join(os.homedir(), 'Library/Caches/ms-playwright'),
+    path.join(os.homedir(), '.cache/ms-playwright'),
+  ];
+  for (const root of roots) {
+    let names = [];
+    try {
+      names = await fs.readdir(root);
+    } catch {
+      continue;
+    }
+    for (const name of names.filter((item) => item.startsWith('chromium-')).sort().reverse()) {
+      const candidates = process.platform === 'darwin'
+        ? [
+            path.join(root, name, 'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium'),
+            path.join(root, name, 'chrome-mac/Chromium.app/Contents/MacOS/Chromium'),
+            path.join(root, name, 'chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
+            path.join(root, name, 'chrome-mac/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
+          ]
+        : [
+            path.join(root, name, 'chrome-linux/chrome'),
+            path.join(root, name, 'chrome-linux64/chrome'),
+          ];
+      for (const candidate of candidates) {
+        if (await executableAt(candidate)) return candidate;
+      }
+    }
+  }
+  return '';
+}
+
+async function resolveBrowserExecutable() {
+  const explicit = process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_PATH;
+  if (explicit && await executableAt(explicit)) {
+    return { executable: explicit, source: 'env' };
+  }
+  const preferredChromium = path.join(homeDir(), 'pomelo', 'Chromium.app/Contents/MacOS/Google Chrome for Testing');
+  if (await executableAt(preferredChromium)) {
+    return { executable: preferredChromium, source: 'chromium' };
+  }
+  const chromium = await findPlaywrightChromium();
+  if (chromium) {
+    return { executable: chromium, source: 'playwright-chromium' };
+  }
+  try {
+    const bundled = await puppeteer.executablePath();
+    if (bundled && await executableAt(bundled)) {
+      return { executable: bundled, source: 'puppeteer' };
+    }
+  } catch {
+    /* fall through to system browsers */
+  }
+  for (const candidate of SYSTEM_BROWSERS) {
+    if (await executableAt(candidate)) {
+      return { executable: candidate, source: 'system' };
+    }
+  }
+  return null;
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function humanPause(min = 280, max = 720) {
+  return sleep(min + Math.random() * (max - min));
+}
+
+let activeBrowser = null;
+let activeLoginPage = null;
+
+async function detectPlatformLogins() {
+  let browser = activeBrowser?.connected ? activeBrowser : null;
+  let temporary = false;
+  let borrowed = false;
+  if (!browser) {
+    // A previous Host or a visible login window may still own the profile.
+    // Attach through its DevTools port instead of launching a second browser.
+    try {
+      const port = Number.parseInt((await fs.readFile(path.join(profileDir(), 'DevToolsActivePort'), 'utf8')).split('\n')[0], 10);
+      if (port > 0) {
+        browser = await puppeteer.connect({ browserURL: `http://127.0.0.1:${port}` });
+        borrowed = true;
+      }
+    } catch {
+      browser = null;
+    }
+  }
+  if (!browser) {
+    const resolved = await resolveBrowserExecutable();
+    if (!resolved) return { known: false };
+    try {
+      browser = await puppeteer.launch({
+        headless: true,
+        executablePath: resolved.executable,
+        userDataDir: profileDir(),
+        args: ['--no-sandbox', '--disable-gpu', '--no-first-run', '--no-default-browser-check'],
+      });
+      temporary = true;
+    } catch {
+      return { known: false };
+    }
+  }
+  try {
+    const cookies = await browser.cookies();
+    const has = (domain, names) => cookies.some((cookie) => cookie.domain.includes(domain)
+      && names.includes(cookie.name) && String(cookie.value || '').length > 8);
+    return {
+      known: true,
+      checkedAt: new Date().toISOString(),
+      xhs: { loggedIn: has('xiaohongshu.com', ['web_session']) },
+      douyin: { loggedIn: has('douyin.com', ['sessionid', 'sessionid_ss', 'sid_tt']) },
+    };
+  } catch {
+    return { known: false };
+  } finally {
+    if (borrowed) await browser.disconnect().catch?.(() => {});
+    else if (temporary) await browser.close().catch(() => {});
+  }
+}
+
+export async function browserStatus() {
+  const resolved = await resolveBrowserExecutable();
+  const logins = await detectPlatformLogins();
+  return {
+    installed: Boolean(resolved),
+    executable: resolved?.executable || '',
+    source: resolved?.source || '',
+    profile: profileDir(),
+    running: Boolean(activeBrowser?.connected),
+    loginWindowOpen: Boolean(activeLoginPage && !activeLoginPage.isClosed()),
+    logins,
+  };
+}
+
+async function launchBrowser() {
+  if (activeBrowser?.connected) return activeBrowser;
+  const resolved = await resolveBrowserExecutable();
+  if (!resolved) {
+    const error = new Error('本机没有可用的 Chrome / Chromium / Edge。请先安装浏览器，或在设置里安装采集浏览器。');
+    error.code = 'BROWSER_MISSING';
+    throw error;
+  }
+  await fs.mkdir(profileDir(), { recursive: true, mode: 0o700 });
+  await fs.mkdir(logDir(), { recursive: true, mode: 0o700 });
+  activeBrowser = await puppeteer.launch({
+    headless: false,
+    executablePath: resolved.executable,
+    userDataDir: profileDir(),
+    defaultViewport: { width: 1440, height: 900 },
+    ignoreDefaultArgs: ['--enable-automation'],
+    args: [
+      '--no-first-run',
+      '--no-default-browser-check',
+      '--lang=zh-CN',
+      '--window-size=1440,900',
+    ],
+  });
+  activeBrowser.on('disconnected', () => {
+    activeBrowser = null;
+    activeLoginPage = null;
+  });
+  return activeBrowser;
+}
+
+async function humanMove(page, x, y) {
+  const steps = 8 + Math.floor(Math.random() * 8);
+  for (let i = 1; i <= steps; i += 1) {
+    await page.mouse.move(
+      x + (Math.random() - 0.5) * 8,
+      y + (Math.random() - 0.5) * 8,
+      { steps: 1 },
+    );
+    await sleep(12 + Math.random() * 22);
+  }
+}
+
+async function humanScroll(page, amount = 420) {
+  await page.mouse.move(700 + Math.random() * 120, 500 + Math.random() * 120);
+  const rounds = 3 + Math.floor(Math.random() * 3);
+  for (let i = 0; i < rounds; i += 1) {
+    await page.mouse.wheel({ deltaY: amount + Math.random() * 120 });
+    await humanPause(180, 460);
+  }
+}
+
+async function submitSearch(page, kind, keyword) {
+  const selectors = kind === 'xhs'
+    ? ['input#search-input', 'input[placeholder*="搜索"]', '.search-input input', 'input[type="search"]']
+    : ['input[data-e2e="searchbar-input"]', 'input[placeholder*="搜索"]', 'input[type="search"]'];
+  for (const selector of selectors) {
+    const input = await page.$(selector);
+    if (!input) continue;
+    const box = await input.boundingBox();
+    if (!box) continue;
+    await humanMove(page, box.x + box.width * 0.45, box.y + box.height * 0.55);
+    await page.mouse.click(box.x + box.width * 0.45, box.y + box.height * 0.55);
+    await humanPause(180, 420);
+    await input.click({ clickCount: 3 }).catch(() => {});
+    await page.keyboard.press('Backspace').catch(() => {});
+    for (const char of keyword) {
+      await page.keyboard.type(char);
+      await sleep(70 + Math.random() * 90);
+    }
+    await humanPause(250, 550);
+    await page.keyboard.press('Enter');
+    await humanPause(1400, 2400);
+    return true;
+  }
+  return false;
+}
+
+async function openPage(url) {
+  const browser = await launchBrowser();
+  const page = await browser.newPage();
+  page.setDefaultTimeout(20000);
+  page.setDefaultNavigationTimeout(45000);
+  await page.goto(url, { waitUntil: 'domcontentloaded' });
+  await humanPause(1600, 2600);
+  return page;
+}
+
+async function looksLoggedOut(page, platform) {
+  return page.evaluate((kind) => {
+    const text = (document.body?.innerText || '').replace(/\s+/g, ' ');
+    const loginText = kind === 'xhs'
+      ? /登录后查看|登录后即可|扫码登录|手机号登录|登录小红书/
+      : /登录后查看|登录后即可|扫码登录|手机号登录|登录抖音/;
+    const visible = (selector) => {
+      const el = document.querySelector(selector);
+      if (!el) return false;
+      const rect = el.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+    return visible('.login-container') || visible('.login-modal') || visible('[class*="login-mask"]') || loginText.test(text);
+  }, platform);
+}
+
+function cleanCount(value) {
+  return String(value || '').replace(/\s+/g, ' ').trim().slice(0, 20);
+}
+
+async function collectXhs(page, keyword) {
+  if (await looksLoggedOut(page, 'xhs')) {
+    const error = new Error('小红书需要登录。请先在设置里点“登录”，在弹出的浏览器窗口登录后重试。');
+    error.code = 'LOGIN_REQUIRED';
+    throw error;
+  }
+  await humanScroll(page, 480);
+  await humanScroll(page, 380);
+  await humanPause(700, 1200);
+
+  const posts = await page.evaluate(() => {
+    const seen = new Set();
+    const cards = [
+      ...document.querySelectorAll('section.note-item, div.note-item, div[class*="note-item"]'),
+    ];
+    const items = [];
+    for (const card of cards) {
+      const link = card.querySelector('a[href*="/explore/"], a[href*="/discovery/item/"]');
+      const url = link?.href || location.href;
+      if (seen.has(url)) continue;
+      seen.add(url);
+      const img = card.querySelector('a.cover img, .cover img, img[data-xhs-img]') || card.querySelector('img');
+      const title =
+        card.querySelector('.footer .title span, .footer .title, .title, .note-title, [class*="title"]')?.textContent?.trim() ||
+        img?.alt ||
+        '';
+      if (!title) continue;
+      const author =
+        card.querySelector('.author .name, .author-wrapper .name, .name, [class*="author"] [class*="name"]')?.textContent?.trim() ||
+        '';
+      const count =
+        card.querySelector('.like-wrapper .count, .like-wrapper, .count, [class*="like"] [class*="count"]')?.textContent?.trim() ||
+        '';
+      items.push({
+        title: title.slice(0, 180),
+        author: author.slice(0, 80),
+        likes: count.replace(/[^\d.万亿wWkK+]/g, '').slice(0, 20),
+        cover: img?.currentSrc || img?.src || '',
+        url,
+        platform: '小红书',
+        format: '图文',
+      });
+    }
+    return items.slice(0, 12);
+  });
+
+  if (!posts.length) {
+    const error = new Error('没有从小红书页面读到公开结果。可能是登录失效、页面结构变化或平台触发了验证，请在弹出的浏览器里检查后重试。');
+    error.code = 'NO_RESULTS';
+    throw error;
+  }
+  return posts.map((post) => ({ ...post, keyword }));
+}
+
+async function collectDouyin(page, keyword) {
+  if (await looksLoggedOut(page, 'douyin')) {
+    const error = new Error('抖音需要登录。请先在设置里点“登录”，在弹出的浏览器窗口登录后重试。');
+    error.code = 'LOGIN_REQUIRED';
+    throw error;
+  }
+  await humanScroll(page, 500);
+  await humanScroll(page, 360);
+  await humanPause(700, 1200);
+
+  const posts = await page.evaluate(() => {
+    const seen = new Set();
+    const anchors = [...document.querySelectorAll('a[href*="/video/"]')];
+    const items = [];
+    for (const anchor of anchors) {
+      const url = anchor.href;
+      if (seen.has(url)) continue;
+      seen.add(url);
+      const card = anchor.closest('li, div[data-e2e], article, div') || anchor;
+      const img = card.querySelector('a.cover img, .cover img, img[data-xhs-img]') || card.querySelector('img');
+      const title =
+        img?.alt ||
+        card.querySelector('[data-e2e="video-desc"], [data-e2e="search-card-title"], h3, .title')?.textContent?.trim() ||
+        anchor.getAttribute('title') ||
+        '';
+      if (!title) continue;
+      const author =
+        card.querySelector('[data-e2e="video-author"], [data-e2e="search-card-author"], .author, [class*="author"]')?.textContent?.trim() ||
+        '';
+      const count =
+        card.querySelector('[data-e2e="video-like"], [data-e2e="search-card-like"], .like, [class*="like"]')?.textContent?.trim() ||
+        '';
+      items.push({
+        title: title.slice(0, 180),
+        author: author.slice(0, 80),
+        likes: count.replace(/[^\d.万亿wWkK+]/g, '').slice(0, 20),
+        cover: img?.currentSrc || img?.src || '',
+        url,
+        platform: '抖音',
+        format: '视频',
+      });
+    }
+    return items.slice(0, 12);
+  });
+
+  if (!posts.length) {
+    const error = new Error('没有从抖音页面读到公开结果。可能是登录失效、页面结构变化或平台触发了验证，请在弹出的浏览器里检查后重试。');
+    error.code = 'NO_RESULTS';
+    throw error;
+  }
+  return posts.map((post) => ({ ...post, keyword }));
+}
+
+async function collectProfile(page, platform, fallbackAvatar = '') {
+  await humanPause(1100, 1800);
+  await humanScroll(page, 460);
+  await page.evaluate(() => {
+    for (const img of document.querySelectorAll('section.note-item img, div.note-item img, img[data-xhs-img]')) {
+      img.loading = 'eager';
+      const lazy = img.getAttribute('data-src') || img.getAttribute('data-original');
+      if (lazy) img.src = lazy;
+    }
+  });
+  await humanScroll(page, 360);
+  await humanPause(1100, 1600);
+  return page.evaluate((label, fallbackAvatar) => {
+    const text = document.body?.innerText || '';
+    const followerMatch = text.match(/([\d.]+\s*[万亿wWkK]?)\s*粉丝/);
+    const pick = (selectors) => {
+      for (const selector of selectors) {
+        const el = document.querySelector(selector);
+        const value = el?.getAttribute?.('alt') || el?.textContent?.trim();
+        if (value) return value;
+      }
+      return '';
+    };
+    const name = pick(['[class*="user-name"]', '.user-nickname', '.user-name', 'h1', '.name']) || document.title.replace(/[-_].*$/, '').trim();
+    const avatarImgs = [...document.querySelectorAll('img')]
+      .map((img) => ({ src: img.currentSrc || img.src || '', width: img.naturalWidth || 0 }))
+      .filter((item) => item.src && /sns-avatar|avatar|aweme-avatar|douyinpic.*avatar|byteimg.*avatar/i.test(item.src) && !/fe-static|logo|placeholder|default/i.test(item.src))
+      .sort((a, b) => b.width - a.width);
+    const avatarBg = [...document.querySelectorAll('[style*="background-image"]')]
+      .map((el) => getComputedStyle(el).backgroundImage)
+      .find((value) => /sns-avatar|avatar/.test(value) && !/fe-static|logo|placeholder|default/.test(value));
+    const bgUrl = avatarBg?.match(/url\(["']?(.*?)["']?\)/)?.[1] || '';
+    const avatar = avatarImgs[0]?.src || bgUrl || fallbackAvatar;
+    const seen = new Set();
+    const cards = [...document.querySelectorAll('section.note-item, div.note-item, li[class*="note"], a[href*="/video/"]')];
+    const posts = [];
+    for (const card of cards) {
+      const link = card.matches?.('a[href]') ? card : card.querySelector('a[href*="/explore/"], a[href*="/discovery/item/"], a[href*="/video/"]');
+      const url = link?.href || '';
+      if (!url || seen.has(url)) continue;
+      seen.add(url);
+      const img = card.querySelector('a.cover img, .cover img, img[data-xhs-img]') || card.querySelector('img');
+      const title = pickFrom(card, ['.footer .title span', '.footer .title', '.title', '.note-title', '[data-e2e="video-desc"]', 'h3']) || img?.alt || '';
+      if (!title) continue;
+      const likeText = pickFrom(card, ['.like-wrapper .count', '.like-wrapper', '.count', '[data-e2e="video-like"]', '[class*="like"]']);
+      posts.push({ title: title.slice(0, 180), cover: img?.currentSrc || img?.src || '', url, likes: String(likeText || '').replace(/[^\d.万亿wWkK+]/g, '').slice(0, 20), author: name, platform: label, format: url.includes('/video/') ? '视频' : '图文' });
+      if (posts.length >= 12) break;
+    }
+    function pickFrom(root, selectors) {
+      for (const selector of selectors) {
+        const el = root.querySelector(selector);
+        const value = el?.textContent?.trim();
+        if (value) return value;
+      }
+      return '';
+    }
+    const cleanCover = (value) => value && /sns-webpic|notes_pre_post|spectrum|douyinpic|byteimg/i.test(value) && !/fe-static|logo|placeholder|default/i.test(value) ? value : '';
+    return {
+      name,
+      avatar,
+      followers: followerMatch ? followerMatch[1].trim() : '—',
+      posts: posts.map((post) => ({ ...post, cover: cleanCover(post.cover) })),
+    };
+  }, platform, fallbackAvatar);
+}
+
+async function resolveXhsProfile(page, account) {
+  let profileFallbackAvatar = '';
+  const direct = /^https?:\/\/.*xiaohongshu\.com\/user\/profile\//i.test(account);
+  if (direct) {
+    await page.goto(account, { waitUntil: 'domcontentloaded' });
+  } else {
+    const term = account.replace(/^@/, '').trim();
+    await page.goto(`https://www.xiaohongshu.com/search_result?keyword=${encodeURIComponent(term)}&type=51`, { waitUntil: 'domcontentloaded' });
+    await humanPause(1400, 2200);
+    let users = await page.evaluate(() => [...document.querySelectorAll('a[href*="/user/profile/"]')].map((a) => ({ url: a.href, name: (a.innerText || a.querySelector('img')?.alt || '').trim().slice(0, 80), avatar: a.querySelector('img')?.currentSrc || a.querySelector('img')?.src || '' })));
+    if (!users.length) {
+      await page.goto(`https://www.xiaohongshu.com/search_result?keyword=${encodeURIComponent(term)}&source=web_search_result_notes`, { waitUntil: 'domcontentloaded' });
+      await humanPause(1400, 2200);
+      await humanScroll(page, 420);
+      users = await page.evaluate(() => [...document.querySelectorAll('a[href*="/user/profile/"]')].map((a) => ({ url: a.href, name: (a.innerText || a.querySelector('img')?.alt || '').trim().slice(0, 80), avatar: a.querySelector('img')?.currentSrc || a.querySelector('img')?.src || '' })));
+    }
+    if (!users.length) {
+      const error = new Error('没有找到这个博主的用户主页，请粘贴博主主页链接或更准确的昵称。');
+      error.code = 'PROFILE_NOT_FOUND';
+      throw error;
+    }
+    const chosen = users.find((item) => item.name.includes(term) || term.includes(item.name)) || users[0];
+    await page.goto(chosen.url, { waitUntil: 'domcontentloaded' });
+    profileFallbackAvatar = chosen.avatar || '';
+  }
+  const profile = await collectProfile(page, '小红书', profileFallbackAvatar);
+  if (!profile.posts.length) {
+    const error = new Error('打开了博主主页，但没有读到公开作品。可能是登录失效或页面结构变化。');
+    error.code = 'PROFILE_EMPTY';
+    throw error;
+  }
+  return { ...profile, profileUrl: page.url() };
+}
+
+async function resolveDouyinProfile(page, account) {
+  let profileFallbackAvatar = '';
+  const direct = /^https?:\/\/.*douyin\.com\/user\//i.test(account);
+  if (direct) {
+    await page.goto(account, { waitUntil: 'domcontentloaded' });
+  } else {
+    const term = account.replace(/^@/, '').trim();
+    await page.goto(`https://www.douyin.com/search/${encodeURIComponent(term)}?type=user`, { waitUntil: 'domcontentloaded' });
+    await humanPause(1500, 2300);
+    const users = await page.evaluate(() => [...document.querySelectorAll('a[href*="/user/"]')].map((a) => ({ url: a.href, name: (a.innerText || a.querySelector('img')?.alt || '').trim().slice(0, 80), avatar: a.querySelector('img')?.currentSrc || a.querySelector('img')?.src || '' })));
+    if (!users.length) {
+      const error = new Error('没有找到这个博主的用户主页，请粘贴博主主页链接或更准确的昵称。');
+      error.code = 'PROFILE_NOT_FOUND';
+      throw error;
+    }
+    const chosen = users.find((item) => item.name.includes(term) || term.includes(item.name)) || users[0];
+    await page.goto(chosen.url, { waitUntil: 'domcontentloaded' });
+    profileFallbackAvatar = chosen.avatar || '';
+  }
+  const profile = await collectProfile(page, '抖音', profileFallbackAvatar);
+  if (!profile.posts.length) {
+    const error = new Error('打开了博主主页，但没有读到公开作品。可能是登录失效或页面结构变化。');
+    error.code = 'PROFILE_EMPTY';
+    throw error;
+  }
+  return { ...profile, profileUrl: page.url() };
+}
+
+async function debugShot(page, prefix) {
+  try {
+    await fs.mkdir(logDir(), { recursive: true, mode: 0o700 });
+    await page.screenshot({ path: path.join(logDir(), `${prefix}-${Date.now()}.png`) });
+  } catch {
+    /* best effort */
+  }
+}
+
+export async function searchPublic({ platform = '小红书', keyword }) {
+  const key = platform === '抖音' ? 'douyin' : 'xhs';
+  const meta = PLATFORM_URLS[key];
+  const term = String(keyword || '').trim().slice(0, 80);
+  if (!term) {
+    const error = new Error('请输入关键词');
+    error.code = 'EMPTY_KEYWORD';
+    throw error;
+  }
+  const page = await openPage(meta.home);
+  try {
+    const submitted = await submitSearch(page, key, term);
+    if (!submitted) {
+      await page.goto(meta.search(term), { waitUntil: 'domcontentloaded' });
+      await humanPause(1600, 2600);
+    }
+    const posts = key === 'xhs' ? await collectXhs(page, term) : await collectDouyin(page, term);
+    return {
+      platform: meta.label,
+      keyword: term,
+      posts,
+      collectedAt: new Date().toISOString(),
+      source: 'local-chromium-visible-search',
+    };
+  } catch (error) {
+    await debugShot(page, `search-${key}`);
+    throw error;
+  } finally {
+    await page.close().catch(() => {});
+  }
+}
+
+export async function openLogin(platform = '小红书') {
+  const key = platform === '抖音' ? 'douyin' : 'xhs';
+  const meta = PLATFORM_URLS[key];
+  if (!activeLoginPage || activeLoginPage.isClosed()) {
+    const browser = await launchBrowser();
+    activeLoginPage = await browser.newPage();
+    activeLoginPage.setDefaultTimeout(20000);
+    await activeLoginPage.goto(meta.home, { waitUntil: 'domcontentloaded' });
+  } else {
+    await activeLoginPage.bringToFront();
+  }
+  return { opened: true, platform: meta.label, url: meta.home };
+}
+
+export async function closeBrowser() {
+  if (activeBrowser) {
+    await activeBrowser.close().catch(() => {});
+    activeBrowser = null;
+    activeLoginPage = null;
+  }
+}
+
+export async function searchPeerProfile({ platform = '小红书', account }) {
+  const key = platform === '抖音' ? 'douyin' : 'xhs';
+  const page = await openPage(PLATFORM_URLS[key].home);
+  try {
+    if (await looksLoggedOut(page, key)) {
+      const error = new Error(`${PLATFORM_URLS[key].label}需要登录。请先在设置里打开登录窗口。`);
+      error.code = 'LOGIN_REQUIRED';
+      throw error;
+    }
+    const profile = key === 'xhs'
+      ? await resolveXhsProfile(page, String(account || ''))
+      : await resolveDouyinProfile(page, String(account || ''));
+    return {
+      platform: PLATFORM_URLS[key].label,
+      name: profile.name || String(account).replace(/^@/, ''),
+      avatar: profile.avatar || '',
+      followers: profile.followers || '—',
+      postCount: profile.posts.length,
+      profileUrl: profile.profileUrl,
+      posts: profile.posts,
+      collectedAt: new Date().toISOString(),
+    };
+  } catch (error) {
+    await debugShot(page, `peer-${key}`);
+    throw error;
+  } finally {
+    await page.close().catch(() => {});
+  }
+}
+
+export async function openLink(url) {
+  let target;
+  try {
+    target = new URL(url);
+  } catch {
+    throw new Error('链接无效');
+  }
+  if (target.protocol !== 'https:' && target.protocol !== 'http:') throw new Error('只支持 http/https 链接');
+  const browser = await launchBrowser();
+  const page = await browser.newPage();
+  page.setDefaultTimeout(20000);
+  await page.goto(target.href, { waitUntil: 'domcontentloaded' });
+  await page.bringToFront();
+  return { opened: true, url: target.href };
+}