aiconductor-cli 1.5.1 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiconductor-cli",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "AIConductor CLI 工具箱",
   "keywords": [
     "aiconductor",

package/src/api.js

@@ -11,6 +11,7 @@ const DELETE_PUBLISHED_WEBPAGE_API_PATH = "/api/delete_published_webpage";
 const SEARCH_API_PATH = "/api/doubao_search";
 const HOT_LIST_API_PATH = "/api/hot_list_mixed";
 const XHS_HOT_LIST_API_PATH = "/api/xhs_hot_list";
+const URL_TO_MARKDOWN_API_PATH = "/api/url_to_markdown";
 const DOUYIN_VIDEO_INFO_PATH = "/api/douyin_video_info";
 const DOUYIN_VIDEO_COMMENTS_PATH = "/api/douyin_video_comments";
 const DOUYIN_USER_VIDEOS_PATH = "/api/douyin_user_videos";
@@ -18,7 +19,33 @@ const DOUYIN_USER_DETAIL_PATH = "/api/douyin_user_detail";
 const DOUYIN_USER_SEARCH_PATH = "/api/douyin_user_search";
 const DOUYIN_VIDEO_SEARCH_PATH = "/api/douyin_video_search";
 const DOUYIN_LINK_TO_TEXT_PATH = "/api/douyin_link_to_text_v2";
+const DOUYIN_HOT_WORDS_PATH = "/api/douyin_hot_words";
+const DOUYIN_HOT_TOPICS_PATH = "/api/douyin_hot_topics";
+const DOUYIN_RISING_TOPICS_PATH = "/api/douyin_rising_topics";
+const DOUYIN_VIDEO_ORIGINAL_PATH = "/api/douyin_video_original";
 const XHS_NOTE_PUBLISH_PATH = "/api/xhs_note_publish";
+const XHS_NOTE_INFO_PATH = "/api/xhs_note_info_v3";
+const XHS_NOTE_COMMENTS_PATH = "/api/xhs_note_comments_fast";
+const XHS_NOTE_SEARCH_PATH = "/api/xhs_note_search_v3";
+const XHS_USER_INFO_PATH = "/api/xhs_user_info_v2";
+// 刻意打 v2：v3 已于 2026-11-05 迁到同一上游且同输出，但 v2 是历史真实流量所在（backend/api_docs 两篇一致）。
+const XHS_USER_NOTES_PATH = "/api/xhs_user_notes_v2";
+const XHS_PGY_BLOGGER_PATH = "/api/xhs_pgy_blogger";
+const XHS_PGY_AUDIENCE_PATH = "/api/xhs_pgy_audience";
+const XHS_PGY_PERFORMANCE_PATH = "/api/xhs_pgy_performance";
+
+// 本地校验区间，命中就在发请求前拦截，不产生计费
+const XHS_MAX_PAGES_LIMIT = 5;
+const XHS_MAX_SECONDS_LIMIT = 170;
+const XHS_SEARCH_SORTS = [
+  "general",
+  "time_descending",
+  "popularity_descending",
+  "comment_descending",
+  "collect_descending",
+];
+const XHS_SEARCH_NOTE_TIMES = ["day", "week", "halfyear"];
+const XHS_SEARCH_NOTE_TYPES = ["video", "note"];
 const WX_ARTICLE_DATA_PATH = "/api/wx_article_data";
 const WX_HISTORY_ARTICLES_PATH = "/api/wx_history_articles";
 const R2_UPLOADER_PATH = "/api/r2_uploader";
@@ -178,7 +205,7 @@ function throwOnBusinessFailure(resp) {
 
 /**
  * wx_history_articles 把上游失败塞在 HTTP 200 + success:true 的 data.code 里
- * （api_docs：data.code 为 0 才算成功，平台侧并不改写成 success:false）。
+ * （backend/api_docs：data.code 为 0 才算成功，平台侧并不改写成 success:false）。
  * 不认这个码，就会把「上游挂了」当成「这个号没有文章」。
  * @param {object} resp
  * @returns {object}
@@ -413,7 +440,7 @@ async function hotList(apiKey, params) {
   }
 
   const limit = validatePositiveInt(params.limit === undefined ? 30 : params.limit, "limit", 30);
-  // The hot-list service is currently served over HTTP; see api_docs/hot_list_mixed.md.
+  // The hot-list service is currently served over HTTP; see backend/api_docs/hot_list_mixed.md.
   const resp = await httpPost(API_HOST, HOT_LIST_API_PATH, {
     source_ids: sourceIds,
     latest: true,
@@ -529,6 +556,53 @@ async function douyinVideoComments(apiKey, videoUrl, maxCount) {
   return stripBilling(resp);
 }
 
+/**
+ * 抖音原画下载（最高画质直链）
+ * @param {string} apiKey
+ * @param {string} videoUrl 链接、分享文案或作品 ID
+ * @returns {Promise<object>}
+ */
+async function douyinVideoOriginal(apiKey, videoUrl) {
+  const resp = await httpPost(API_HOST, DOUYIN_VIDEO_ORIGINAL_PATH, {
+    api_key: apiKey,
+    video_url: videoUrl,
+  });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音热词榜（原子接口）
+ * @param {string} apiKey
+ * @returns {Promise<object>}
+ */
+async function douyinHotWords(apiKey) {
+  const resp = await httpPost(API_HOST, DOUYIN_HOT_WORDS_PATH, { api_key: apiKey });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音热点榜（原子接口，一次返回 current + rocketing）
+ * @param {string} apiKey
+ * @returns {Promise<object>}
+ */
+async function douyinHotTopics(apiKey) {
+  const resp = await httpPost(API_HOST, DOUYIN_HOT_TOPICS_PATH, { api_key: apiKey });
+  return stripBilling(resp);
+}
+
+/**
+ * 抖音飙升热点榜（原子接口）
+ * @param {string} apiKey
+ * @param {number} [limit] 1~20，越界时后端回退为 10
+ * @returns {Promise<object>}
+ */
+async function douyinRisingTopics(apiKey, limit) {
+  const body = { api_key: apiKey };
+  if (limit !== undefined && limit !== null) body.limit = limit;
+  const resp = await httpPost(API_HOST, DOUYIN_RISING_TOPICS_PATH, body);
+  return stripBilling(resp);
+}
+
 /**
  * 获取抖音用户视频列表
  * @param {string} apiKey
@@ -626,6 +700,23 @@ async function wxArticleData(apiKey, url) {
   return throwOnBusinessFailure(stripBilling(resp));
 }
 
+/**
+ * 将任意网页（含微信公众号文章）转成干净的 Markdown
+ * @param {string} apiKey
+ * @param {{ url: string, timeout?: number|string }} params
+ * @returns {Promise<object>} `markdown` 在顶层，不在 data 下
+ */
+async function urlToMarkdown(apiKey, params = {}) {
+  const body = { url: requireText(params.url, "url（网页链接）") };
+  if (params.timeout !== undefined && params.timeout !== null && params.timeout !== "") {
+    body.timeout = validatePositiveInt(params.timeout, "timeout");
+  }
+  const resp = await httpPost(API_HOST, URL_TO_MARKDOWN_API_PATH, body, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+  return throwOnBusinessFailure(stripBilling(resp));
+}
+
 /**
  * 获取微信公众号历史文章列表（按成功翻页次数计费）
  * @param {string} apiKey
@@ -677,6 +768,260 @@ async function xhsNotePublish(apiKey, params) {
   return stripBilling(resp);
 }
 
+/**
+ * 抛 api_error（上层按业务失败处理）
+ * @param {object} result
+ * @returns {object}
+ */
+function throwOnXhsFailure(result) {
+  if (result?.success === false) {
+    throw Object.assign(new Error(result.message || "小红书接口返回失败"), { type: "api_error" });
+  }
+  return result;
+}
+
+/**
+ * 校验 1~上限 的正整数（上限单独校验，避免与其他命令的 limit 语义混住）
+ * @param {*} value
+ * @param {string} name
+ * @param {number} max
+ * @returns {number|null}
+ */
+function validateXhsPositiveInt(value, name, max) {
+  if (value === undefined || value === null || value === "") return null;
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || n > max) {
+    throw Object.assign(new Error(`${name} 须为 1~${max} 的整数，收到: ${value}`), {
+      type: "validation_error",
+    });
+  }
+  return n;
+}
+
+/**
+ * 获取小红书笔记详情。
+ * 注意：只传 note_id 即可（2026-11-05 实测，不需要 xsec_token）。
+ * @param {string} apiKey
+ * @param {string} noteId
+ * @returns {Promise<object>} `note_data` 在顶层，没有 data.data 嵌套
+ */
+async function xhsNoteInfo(apiKey, noteId) {
+  const resp = await httpPost(API_HOST, XHS_NOTE_INFO_PATH, { note_id: noteId }, {
+    Authorization: `Bearer ${apiKey}`,
+  }, http);
+  return throwOnXhsFailure(stripBilling(resp));
+}
+
+/**
+ * 获取小红书笔记一级评论（含可见的楼内回复 sub_comments）。
+ * @param {string} apiKey
+ * @param {{noteId?: string, shareText?: string, maxPages?: number, maxSeconds?: number}} params
+ * @returns {Promise<object>} `data.data.comments`，10 条/页
+ */
+async function xhsNoteComments(apiKey, params = {}) {
+  const body = {};
+  const maxPages = validateXhsPositiveInt(params.maxPages, "max_pages", XHS_MAX_PAGES_LIMIT);
+  const maxSeconds = validateXhsPositiveInt(params.maxSeconds, "max_seconds", XHS_MAX_SECONDS_LIMIT);
+  if (maxPages !== null) body.max_pages = maxPages;
+  if (maxSeconds !== null) body.max_seconds = maxSeconds;
+
+  if (params.noteId) {
+    body.note_id = params.noteId;
+  } else if (params.shareText) {
+    body.share_text = params.shareText;
+  } else {
+    throw Object.assign(new Error("note_id 与分享链接至少提供一个"), { type: "validation_error" });
+  }
+
+  const resp = await httpPost(API_HOST, XHS_NOTE_COMMENTS_PATH, body, {
+    Authorization: `Bearer ${apiKey}`,
+  }, http);
+  return throwOnXhsFailure(stripBilling(resp));
+}
+
+/**
+ * 按关键词搜索小红书笔记。
+ * @param {string} apiKey
+ * @param {{keyword: string, maxPages?: number, sort?: string, noteTime?: string, noteType?: string}} params
+ * @returns {Promise<object>} `data.data.items[]`，20 条/页
+ */
+async function xhsNoteSearch(apiKey, params = {}) {
+  const keyword = typeof params.keyword === "string" ? params.keyword.trim() : "";
+  if (!keyword) {
+    throw Object.assign(new Error("keyword 不能为空"), { type: "validation_error" });
+  }
+
+  const body = { keyword };
+  const maxPages = validateXhsPositiveInt(params.maxPages, "max_pages", XHS_MAX_PAGES_LIMIT);
+  if (maxPages !== null) body.max_pages = maxPages;
+
+  if (params.sort) {
+    if (!XHS_SEARCH_SORTS.includes(params.sort)) {
+      throw Object.assign(new Error(`sort 仅支持 ${XHS_SEARCH_SORTS.join("|")}，收到: ${params.sort}`), {
+        type: "validation_error",
+      });
+    }
+    body.sort = params.sort;
+  }
+  if (params.noteTime) {
+    if (!XHS_SEARCH_NOTE_TIMES.includes(params.noteTime)) {
+      throw Object.assign(new Error(`note_time 仅支持 ${XHS_SEARCH_NOTE_TIMES.join("|")}，收到: ${params.noteTime}`), {
+        type: "validation_error",
+      });
+    }
+    body.note_time = params.noteTime;
+  }
+  if (params.noteType) {
+    if (!XHS_SEARCH_NOTE_TYPES.includes(params.noteType)) {
+      throw Object.assign(new Error(`note_type 仅支持 ${XHS_SEARCH_NOTE_TYPES.join("|")}，收到: ${params.noteType}`), {
+        type: "validation_error",
+      });
+    }
+    body.note_type = params.noteType;
+  }
+
+  const resp = await httpPost(API_HOST, XHS_NOTE_SEARCH_PATH, body, {
+    Authorization: `Bearer ${apiKey}`,
+  }, http);
+  return throwOnXhsFailure(stripBilling(resp));
+}
+
+/**
+ * 获取小红书用户详情。
+ * @param {string} apiKey
+ * @param {string} userId
+ * @returns {Promise<object>} `user_info` 在顶层，interactions 为 5 项中文
+ */
+async function xhsUserInfo(apiKey, userId) {
+  const resp = await httpPost(API_HOST, XHS_USER_INFO_PATH, { user_id: userId }, {
+    Authorization: `Bearer ${apiKey}`,
+  }, http);
+  return throwOnXhsFailure(stripBilling(resp));
+}
+
+/**
+ * 蒲公英三件套的公共请求体：24 位小写十六进制当 user_id，其余当主页链接。
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {object}
+ */
+function pgyRequestBody(apiKey, input) {
+  const text = input === undefined || input === null ? "" : String(input).trim();
+  if (!text) {
+    throw Object.assign(new Error("请提供小红书 user_id 或达人主页链接"), {
+      type: "validation_error",
+    });
+  }
+  const body = { api_key: apiKey };
+  if (/^[0-9a-f]{24}$/.test(text)) body.user_id = text;
+  else body.profile_url = text;
+  return body;
+}
+
+/**
+ * 小红书达人详情（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyBlogger(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_BLOGGER_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
+/**
+ * 小红书达人粉丝画像（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyAudience(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_AUDIENCE_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
+/**
+ * 小红书达人笔记性价比（蒲公英）
+ * @param {string} apiKey
+ * @param {string} input user_id 或主页链接
+ * @returns {Promise<object>}
+ */
+async function xhsPgyPerformance(apiKey, input) {
+  const resp = await httpPost(API_HOST, XHS_PGY_PERFORMANCE_PATH, pgyRequestBody(apiKey, input));
+  return stripBilling(resp);
+}
+
+/**
+ * 获取小红书用户笔记列表。
+ * @param {string} apiKey
+ * @param {{userId: string, maxPages?: number}} params
+ * @returns {Promise<object>} `data.data.notes[]`，20 条/页
+ */
+async function xhsUserNotes(apiKey, params = {}) {
+  if (!params.userId) {
+    throw Object.assign(new Error("user_id 不能为空"), { type: "validation_error" });
+  }
+  const body = { user_id: params.userId };
+  const maxPages = validateXhsPositiveInt(params.maxPages, "max_pages", XHS_MAX_PAGES_LIMIT);
+  if (maxPages !== null) body.max_pages = maxPages;
+
+  const resp = await httpPost(API_HOST, XHS_USER_NOTES_PATH, body, {
+    Authorization: `Bearer ${apiKey}`,
+  }, http);
+  return throwOnXhsFailure(stripBilling(resp));
+}
+
+/**
+ * 展开小红书分享短链（xhslink.cn / xhslink.com）为真实长链。
+ * 短链必须跟随 302，否则拿不到 note_id。
+ * @param {string} shortUrl
+ * @returns {Promise<string>} 长链；不是跳转时原样返回
+ */
+function resolveXhsShortLink(shortUrl) {
+  return new Promise((resolve, reject) => {
+    let parsed;
+    try {
+      parsed = new URL(shortUrl);
+    } catch {
+      reject(Object.assign(new Error(`短链格式无效: ${shortUrl}`), { type: "validation_error" }));
+      return;
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      reject(Object.assign(new Error(`短链仅支持 HTTP/HTTPS: ${shortUrl}`), { type: "validation_error" }));
+      return;
+    }
+
+    const transport = parsed.protocol === "https:" ? https : http;
+    const req = transport.request({
+      hostname: parsed.hostname,
+      port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+      path: `${parsed.pathname}${parsed.search}`,
+      method: "GET",
+      headers: {
+        "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
+      },
+    }, (res) => {
+      const location = res.headers?.location;
+      if (res.statusCode >= 300 && res.statusCode < 400 && location) {
+        if (res.resume) res.resume();
+        resolve(location);
+        return;
+      }
+      if (res.resume) res.resume();
+      resolve(shortUrl);
+    });
+
+    req.setTimeout(15000, () => {
+      req.destroy();
+      reject(Object.assign(new Error(`短链解析超时: ${shortUrl}`), { type: "network_error" }));
+    });
+    req.on("error", (err) => {
+      reject(Object.assign(new Error(`短链解析失败: ${err.message}`), { type: "network_error" }));
+    });
+    req.end();
+  });
+}
+
 module.exports = {
   resolveApiKey,
   publishHtml,
@@ -693,8 +1038,22 @@ module.exports = {
   douyinUserSearch,
   douyinVideoSearch,
   douyinLinkToText,
+  douyinHotWords,
+  douyinHotTopics,
+  douyinRisingTopics,
+  douyinVideoOriginal,
   r2Upload,
   xhsNotePublish,
+  xhsNoteInfo,
+  xhsNoteComments,
+  xhsNoteSearch,
+  xhsUserInfo,
+  xhsUserNotes,
+  resolveXhsShortLink,
+  xhsPgyBlogger,
+  xhsPgyAudience,
+  xhsPgyPerformance,
   wxArticleData,
   wxHistoryArticles,
+  urlToMarkdown,
 };