@vocmarket/voc-skill 0.3.37 → 0.3.39

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
-{
-  "name": "voc-intelligence",
-  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu/Douyin/WeChat Channels collection and trend reports, live social VOC collection, Fmode Doubao image analysis, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
-  "version": "0.3.37",
-  "author": {
-    "name": "nkkj-BrainHack"
-  }
-}
+{
+  "name": "voc-intelligence",
+  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu/Douyin/WeChat Channels collection and trend reports, live social VOC collection, Fmode Doubao image analysis, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
+  "version": "0.3.39",
+  "author": {
+    "name": "nkkj-BrainHack"
+  }
+}

package/mcp/catalog/voc-social-endpoints.json

@@ -915,7 +915,10 @@
           "desc": "连续翻页时透传上一次返回的 session_id。"
         }
       ],
-      "responseHint": "返回笔记列表，含 note_id、标题、作者、互动数；翻页递增 page 并透传 search_id/session_id。"
+      "responseHint": "返回笔记列表，含 note_id、标题、作者、互动数；翻页递增 page 并透传 search_id/session_id。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.search_notes",
+      "recommendationPriority": -1000
     },
     {
       "id": "xiaohongshu.note_detail",
@@ -952,7 +955,10 @@
           "desc": "可选：直接传小红书分享文案/链接，与 note_id 二选一。"
         }
       ],
-      "responseHint": "返回单条笔记对象，含正文、图片/视频、话题、互动数。"
+      "responseHint": "返回单条笔记对象，含正文、图片/视频、话题、互动数。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.get_image_note_detail",
+      "recommendationPriority": -1000
     },
     {
       "id": "xiaohongshu.note_comments",
@@ -997,7 +1003,8 @@
           "desc": "可选安全令牌，来自 search_notes 返回的 note.xsec_token；部分笔记风控需要。"
         }
       ],
-      "responseHint": "返回评论列表，含 comment_id、文本、点赞、子评论数；翻页用返回的游标。"
+      "responseHint": "返回评论列表，含 comment_id、文本、点赞、子评论数；翻页用返回的游标。",
+      "recommendationPriority": 80
     },
     {
       "id": "xiaohongshu.sub_comments",
@@ -1043,7 +1050,8 @@
           "desc": "分页游标，首页留空，翻页用上一次返回的 start。"
         }
       ],
-      "responseHint": "返回某条评论的回复列表；翻页用返回的 start。"
+      "responseHint": "返回某条评论的回复列表；翻页用返回的 start。",
+      "recommendationPriority": 70
     },
     {
       "id": "xiaohongshu.user_info",
@@ -1074,7 +1082,10 @@
           "desc": "用户 id（24 位 hex），来自 search_notes 返回的 note.user.userid；注意不是数字 red_id。"
         }
       ],
-      "responseHint": "返回用户资料对象，含粉丝数、获赞收藏、简介。"
+      "responseHint": "返回用户资料对象，含粉丝数、获赞收藏、简介。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.get_user_info",
+      "recommendationPriority": -1000
     },
     {
       "id": "xiaohongshu.user_notes",
@@ -1113,7 +1124,10 @@
           "desc": "分页游标，首页留空，翻页用上一次返回的 cursor。"
         }
       ],
-      "responseHint": "返回该用户的笔记列表；翻页用返回的 cursor。"
+      "responseHint": "返回该用户的笔记列表；翻页用返回的 cursor。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.get_user_posted_notes",
+      "recommendationPriority": -1000
     },
     {
       "id": "xiaohongshu.topic_notes",
@@ -1190,7 +1204,10 @@
           "desc": "翻页透传上一次返回的 session_id。"
         }
       ],
-      "responseHint": "返回话题下笔记列表；翻页透传 last_note_ct/last_note_id/cursor_score/session_id。"
+      "responseHint": "返回话题下笔记列表；翻页透传 last_note_ct/last_note_id/cursor_score/session_id。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.get_topic_feed",
+      "recommendationPriority": -1000
     },
     {
       "id": "xiaohongshu.search_products",
@@ -1276,7 +1293,10 @@
           "desc": "连续翻页时透传上一次返回的 session_id。"
         }
       ],
-      "responseHint": "返回商品列表，含标题、价格、销量、店铺。"
+      "responseHint": "返回商品列表，含标题、价格、销量、店铺。",
+      "deprecated": true,
+      "replacedBy": "xiaohongshu.app_v2.search_products",
+      "recommendationPriority": -1000
     },
     {
       "id": "tiktok.web.fetch_post_detail",
@@ -10405,7 +10425,8 @@
         "app",
         "v2"
       ],
-      "requiredParams": []
+      "requiredParams": [],
+      "recommendationPriority": 90
     },
     {
       "id": "xiaohongshu.app_v2.get_video_note_detail",
@@ -10423,7 +10444,8 @@
         "app",
         "v2"
       ],
-      "requiredParams": []
+      "requiredParams": [],
+      "recommendationPriority": 90
     },
     {
       "id": "xiaohongshu.app_v2.get_note_comments",
@@ -10479,7 +10501,8 @@
         "app",
         "v2"
       ],
-      "requiredParams": []
+      "requiredParams": [],
+      "recommendationPriority": 60
     },
     {
       "id": "xiaohongshu.app_v2.get_user_posted_notes",
@@ -10497,7 +10520,8 @@
         "app",
         "v2"
       ],
-      "requiredParams": []
+      "requiredParams": [],
+      "recommendationPriority": 50
     },
     {
       "id": "xiaohongshu.app_v2.get_user_faved_notes",
@@ -10535,7 +10559,8 @@
       ],
       "requiredParams": [
         "keyword"
-      ]
+      ],
+      "recommendationPriority": 100
     },
     {
       "id": "xiaohongshu.app_v2.search_users",
@@ -10595,7 +10620,8 @@
       ],
       "requiredParams": [
         "keyword"
-      ]
+      ],
+      "recommendationPriority": 30
     },
     {
       "id": "xiaohongshu.app_v2.search_groups",
@@ -10715,7 +10741,8 @@
       ],
       "requiredParams": [
         "page_id"
-      ]
+      ],
+      "recommendationPriority": 40
     },
     {
       "id": "xiaohongshu.app_v2.get_topic_feed",
@@ -10735,7 +10762,8 @@
       ],
       "requiredParams": [
         "page_id"
-      ]
+      ],
+      "recommendationPriority": 40
     },
     {
       "id": "xiaohongshu.app_v2.get_creator_inspiration_feed",

package/mcp/src/features/xiaohongshu-trend/live-collector.js

@@ -231,17 +231,49 @@ function normalizeComment(raw, noteId, keyword) {
   };
 }
 
+function flattenSearchItem(item) {
+  if (!item || typeof item !== 'object') return null;
+  if (item.note) return item.note;
+  if (item.note_card) {
+    const interact = item.note_card.interact_info || {};
+    return {
+      id: item.id || item.note_id || item.note_card.note_id,
+      note_id: item.id || item.note_id || item.note_card.note_id,
+      title: item.note_card.display_title || item.note_card.title || '',
+      desc: item.note_card.desc || item.note_card.display_title || '',
+      type: item.note_card.type || item.model_type || '',
+      user: item.note_card.user || {},
+      liked_count: interact.liked_count,
+      collected_count: interact.collected_count,
+      comments_count: interact.comment_count || interact.comments_count,
+      shared_count: interact.share_count || interact.shared_count,
+      cover: item.note_card.cover,
+      xsec_token: item.xsec_token || item.note_card.xsec_token || '',
+      note_card: item.note_card,
+      share_info: item.note_card.share_info,
+      mini_program_info: item.note_card.mini_program_info
+    };
+  }
+  return item;
+}
+
 function extractSearchNotes(data) {
   const items = data.items || data.note_list || data.notes || [];
   if (!Array.isArray(items)) return [];
   return items
-    .map(item => item.note || item)
+    .map(flattenSearchItem)
     .filter(note => note && (note.id || note.note_id));
 }
 
 function extractDetailNote(data) {
-  const list = data.note_list || data.notes || [];
-  return Array.isArray(list) && list[0] ? list[0] : data.note || data;
+  if (Array.isArray(data) && data[0]) {
+    const first = data[0];
+    const nested = first.note_list || first.notes || [];
+    if (Array.isArray(nested) && nested[0]) return nested[0];
+    return first.note || first;
+  }
+  const list = data && (data.note_list || data.notes) || [];
+  return Array.isArray(list) && list[0] ? list[0] : (data && data.note) || data;
 }
 
 function extractComments(data) {
@@ -301,7 +333,10 @@ async function collectLiveDataset({ profile, token, fallbackToken, options = {}
       for (const rawNote of rawNotes) {
         let note = rawNote;
         try {
-          const detail = await api.getNoteDetail({ noteId: rawNote.id });
+          const detail = await api.getNoteDetail({
+            noteId: rawNote.id,
+            noteType: rawNote.type
+          });
           note = normalizeNote(rawNote, keyword, extractDetailNote(detail.data));
         } catch (error) {
           warnings.push({
@@ -318,7 +353,11 @@ async function collectLiveDataset({ profile, token, fallbackToken, options = {}
         let cursor = '';
         for (let page = 0; page < maxCommentPages; page++) {
           try {
-            const commentResult = await api.getNoteComments({ noteId: note.id, cursor });
+            const commentResult = await api.getNoteComments({
+              noteId: note.id,
+              cursor,
+              xsecToken: rawNote.xsec_token || note.xsec_token || ''
+            });
             extractComments(commentResult.data).forEach(rawComment => {
               comments.push(normalizeComment(rawComment, note.id, keyword));
             });
@@ -363,5 +402,7 @@ module.exports = {
   normalizeNote,
   pickWebUrl,
   extractImageUrls,
+  extractSearchNotes,
+  extractDetailNote,
   hasXsecToken
 };

package/mcp/src/providers/xiaohongshu-api.js

@@ -1,21 +1,89 @@
 const { callSocialGateway } = require('./voc-gateway');
 
 const VOC_SOCIAL_API_ROOT = 'https://server.fmode.cn/api/voc-social';
-const XIAOHONGSHU_APP_BASE_URL = `${VOC_SOCIAL_API_ROOT}/xiaohongshu/app`;
+const XIAOHONGSHU_API_ROOT = `${VOC_SOCIAL_API_ROOT}/xiaohongshu`;
+const XIAOHONGSHU_APP_BASE_URL = `${XIAOHONGSHU_API_ROOT}/app`;
+
+const SEARCH_APP_V2_PATH = 'app_v2/search_notes';
+const SEARCH_WEB_V3_PATH = 'web_v3/fetch_search_notes';
+const DETAIL_IMAGE_PATH = 'app_v2/get_image_note_detail';
+const DETAIL_VIDEO_PATH = 'app_v2/get_video_note_detail';
+const DETAIL_APP_FALLBACK_PATH = 'app/get_note_info';
+const COMMENTS_PATH = 'app_v2/get_note_comments';
+
+function normalizeXiaohongshuBaseUrl(baseUrl) {
+  const value = String(baseUrl || XIAOHONGSHU_API_ROOT).replace(/\/$/, '');
+  return value.replace(/\/(app_v2|app|web_v3|web_v2|web)$/i, '').replace(/\/$/, '') || XIAOHONGSHU_API_ROOT;
+}
+
+function isRetryableUpstream(error) {
+  if (!error) return false;
+  if (error.kind === 'upstream') return true;
+  const status = Number(error.httpStatus || 0);
+  return status === 0 || status >= 500 || status === 301;
+}
+
+function mapSortType(sort) {
+  const value = String(sort || 'popularity_descending').trim();
+  if (!value || value === '_0') return 'popularity_descending';
+  if (value === 'time_desc') return 'time_descending';
+  if (value === 'popularity') return 'popularity_descending';
+  return value;
+}
+
+function mapAppV2NoteType(noteType) {
+  const value = String(noteType == null ? '_0' : noteType).trim();
+  if (value === '_0' || value === '0' || value === '不限' || value === '') return '不限';
+  if (value === '_1' || value === '1' || value === '视频' || value === '视频笔记') return '视频笔记';
+  if (value === '_2' || value === '2' || value === '图文' || value === '普通笔记' || value === 'normal') return '普通笔记';
+  if (value === '直播' || value === '直播笔记') return '直播笔记';
+  return value;
+}
+
+function mapWebV3NoteType(noteType) {
+  const value = String(noteType == null ? '_0' : noteType).trim();
+  if (value === '_1' || value === '1' || value === '视频' || value === '视频笔记' || value === 'video') return 1;
+  if (value === '_2' || value === '2' || value === '图文' || value === '普通笔记' || value === 'normal') return 2;
+  return 0;
+}
+
+function extractSearchItems(data) {
+  if (!data || typeof data !== 'object') return [];
+  const candidates = [data.items, data.note_list, data.notes, data.data && data.data.items];
+  for (const list of candidates) {
+    if (Array.isArray(list)) return list;
+  }
+  return [];
+}
+
+function hasNotePayload(data) {
+  if (!data) return false;
+  if (Array.isArray(data)) return data.some(item => hasNotePayload(item));
+  if (Array.isArray(data.note_list) && data.note_list.length) return true;
+  if (Array.isArray(data.notes) && data.notes.length) return true;
+  if (data.note && (data.note.id || data.note.note_id)) return true;
+  return Boolean(data.id || data.note_id);
+}
 
 class XiaohongshuApi {
   constructor(options = {}) {
-    this.baseUrl = options.baseUrl || process.env.XIAOHONGSHU_API_BASE_URL || XIAOHONGSHU_APP_BASE_URL;
+    this.baseUrl = normalizeXiaohongshuBaseUrl(
+      options.baseUrl ||
+      process.env.XIAOHONGSHU_API_BASE_URL ||
+      process.env.VOC_XIAOHONGSHU_API_BASE_URL ||
+      XIAOHONGSHU_API_ROOT
+    );
     this.token = options.token;
     this.fallbackToken = options.fallbackToken || '';
     this.headers = options.headers || {};
   }
 
-  request(proxyPath, query) {
+  request(proxyPath, { method = 'GET', query = {}, body } = {}) {
     return callSocialGateway({
       proxyPath,
-      method: 'GET',
+      method,
       query,
+      body,
       token: this.token,
       fallbackToken: this.fallbackToken,
       baseUrl: this.baseUrl,
@@ -23,26 +91,125 @@ class XiaohongshuApi {
     });
   }
 
-  searchNotes({ keyword, page = 1, sort = 'popularity_descending', noteType = '_0' }) {
-    return this.request('search_notes', {
-      keyword,
-      page,
-      sort,
-      note_type: noteType
-    });
+  async searchNotes({
+    keyword,
+    page = 1,
+    sort = 'popularity_descending',
+    noteType = '_0',
+    searchId = '',
+    sessionId = ''
+  }) {
+    const sortType = mapSortType(sort);
+    let firstError;
+
+    try {
+      const result = await this.request(SEARCH_APP_V2_PATH, {
+        query: {
+          keyword,
+          page,
+          sort_type: sortType,
+          note_type: mapAppV2NoteType(noteType),
+          search_id: searchId,
+          search_session_id: sessionId
+        }
+      });
+      if (extractSearchItems(result.data).length > 0) {
+        return {
+          ...result,
+          endpoint: SEARCH_APP_V2_PATH,
+          fallbackUsedForEndpoint: false
+        };
+      }
+    } catch (error) {
+      if (!isRetryableUpstream(error)) throw error;
+      firstError = error;
+    }
+
+    try {
+      const result = await this.request(SEARCH_WEB_V3_PATH, {
+        query: {
+          keyword,
+          page,
+          sort: sortType,
+          note_type: mapWebV3NoteType(noteType)
+        }
+      });
+      return {
+        ...result,
+        endpoint: SEARCH_WEB_V3_PATH,
+        fallbackUsedForEndpoint: true
+      };
+    } catch (error) {
+      throw firstError || error;
+    }
   }
 
-  getNoteDetail({ noteId }) {
-    return this.request('get_note_info', { note_id: noteId });
+  async getNoteDetail({ noteId, noteType = '', shareText = '' }) {
+    const query = {
+      note_id: noteId,
+      share_text: shareText
+    };
+    const preferred = /video/i.test(String(noteType || ''))
+      ? [DETAIL_VIDEO_PATH, DETAIL_IMAGE_PATH]
+      : [DETAIL_IMAGE_PATH, DETAIL_VIDEO_PATH];
+
+    let lastError;
+    for (const proxyPath of preferred) {
+      try {
+        const result = await this.request(proxyPath, { query });
+        if (hasNotePayload(result.data)) {
+          return {
+            ...result,
+            endpoint: proxyPath,
+            fallbackUsedForEndpoint: false
+          };
+        }
+      } catch (error) {
+        if (!isRetryableUpstream(error)) throw error;
+        lastError = error;
+      }
+    }
+
+    try {
+      const result = await this.request(DETAIL_APP_FALLBACK_PATH, {
+        query: {
+          note_id: noteId,
+          share_text: shareText
+        }
+      });
+      return {
+        ...result,
+        endpoint: DETAIL_APP_FALLBACK_PATH,
+        fallbackUsedForEndpoint: true
+      };
+    } catch (error) {
+      throw lastError || error;
+    }
   }
 
-  getNoteComments({ noteId, cursor = '' }) {
-    return this.request('get_note_comments', { note_id: noteId, cursor });
+  getNoteComments({ noteId, cursor = '', shareText = '', xsecToken = '' }) {
+    return this.request(COMMENTS_PATH, {
+      query: {
+        note_id: noteId,
+        cursor,
+        share_text: shareText,
+        xsec_token: xsecToken
+      }
+    });
   }
 }
 
 module.exports = {
   VOC_SOCIAL_API_ROOT,
+  XIAOHONGSHU_API_ROOT,
   XIAOHONGSHU_APP_BASE_URL,
+  SEARCH_APP_V2_PATH,
+  SEARCH_WEB_V3_PATH,
+  DETAIL_IMAGE_PATH,
+  DETAIL_VIDEO_PATH,
+  COMMENTS_PATH,
+  normalizeXiaohongshuBaseUrl,
+  extractSearchItems,
+  hasNotePayload,
   XiaohongshuApi
 };

package/mcp/src/server.js

@@ -66,7 +66,7 @@ function normalizeToolResult(result = {}) {
 function createServer() {
   const server = new McpServer({
     name: 'voc-intelligence',
-    version: '0.3.37'
+    version: '0.3.39'
   });
 
   server.registerTool(

package/mcp/src/tools/voc-api-catalog-run.js

@@ -37,7 +37,7 @@ async function searchVocApis(input = {}) {
   const matches = (query || input.platform || input.tag)
     ? searchEndpoints({ query, platform: input.platform, tag: input.tag, limit: input.limit || 20 })
     : listEndpoints();
-  const results = matches.map(summarizeEndpoint);
+  const results = matches.map(summarizeEndpoint).filter(item => !item.deprecated);
   const lines = [
     '## VOC 转发接口清单',
     '',
@@ -80,6 +80,12 @@ async function getVocApiDoc(input = {}) {
     });
   }
   endpoint = hydrateEndpoint(endpoint);
+  if (endpoint.deprecated) {
+    const replacement = endpoint.replacedBy ? `请改用 ${endpoint.replacedBy}。` : '请用 voc_api_search 改选现用接口。';
+    return errorResult(`接口「${endpoint.id}」已下架。${replacement}`, {
+      data: { endpoint: summarizeEndpoint(endpoint) }
+    });
+  }
   const paramLines = (endpoint.params || []).map(p => {
     const flag = p.required ? '必填' : '可选';
     const def = p.default !== undefined ? `，默认 ${JSON.stringify(p.default)}` : '';

package/package.json

@@ -1,80 +1,80 @@
-{
-  "name": "@vocmarket/voc-skill",
-  "version": "0.3.37",
-  "description": "Claude Code VOC intelligence skills for Xiaohongshu, Douyin and WeChat Channels trend/content collection, live social VOC, Fmode image analysis, single-issue deep dives, boss/operator action plans, and multi-turn memory.",
-  "type": "commonjs",
-  "bin": {
-    "claude-voc": "bin/claude-voc.js"
-  },
-  "scripts": {
-    "install:check": "node install.js --check",
-    "install:smoke": "node install.js --smoke",
-    "smoke:package": "node scripts/smoke-package.js",
-    "smoke:cross-industry": "node scripts/smoke-cross-industry.js",
-    "fmode:image": "node mcp/src/tools/fmode-image-analysis.js",
-    "fmode:image:smoke": "node scripts/fmode-image-analysis-smoke.js",
-    "smoke:billing": "node scripts/billing-client-smoke.js",
-    "smoke:budget": "node scripts/smoke-budget-guard.js",
-    "smoke:trend-budget": "node scripts/smoke-trend-budget.js",
-    "smoke:cost": "node scripts/smoke-cost-estimate.js",
-    "smoke:cost-calibration": "node scripts/smoke-cost-calibration.js",
-    "smoke:media": "node scripts/smoke-media-pipeline.js",
-    "smoke:request": "node scripts/smoke-voc-request-shaping.js",
-    "audit:index": "node scripts/audit-index.js",
-    "xhs:sample": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-sample --result-prefix XHS_TREND_RESULT",
-    "xhs:preference-smoke": "node mcp/src/tools/xiaohongshu-preference-update.js --message \"保留奶油风和全屋定制翻车方向，不要纯风格美图，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --result-prefix XHS_PREF_RESULT",
-    "xhs:sample-with-memory": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --output ../outputs/claude-code-xhs-memory-smoke/report --result-prefix XHS_TREND_RESULT",
-    "xhs:live": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode live --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-live --keyword-limit 1 --notes-per-keyword 1 --max-comment-pages 1 --result-prefix XHS_TREND_RESULT",
-    "dy:sample": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-sample --result-prefix DOUYIN_TREND_RESULT",
-    "dy:preference-smoke": "node mcp/src/tools/douyin-preference-update.js --message \"保留口播开头和评论区问题，不要只做纯素材剪辑，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --result-prefix DOUYIN_PREF_RESULT",
-    "dy:sample-with-memory": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --output ../outputs/claude-code-douyin-memory-smoke/report --result-prefix DOUYIN_TREND_RESULT",
-    "dy:live": "node mcp/src/tools/douyin-trend-run.js --collection-mode live --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-live --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 1 --result-prefix DOUYIN_TREND_RESULT",
-    "voc:issue-pool": "node mcp/src/tools/voc-issue-pool-run.js --project 示例品牌A --industry 家居定制 --scenario 线上获客 --audience 意向用户 --evidence \"第一次买不知道怎么选，怕踩雷。;价格有点高，不确定值不值。;咨询的时候没人理。\" --assistant-message-only",
-    "voc:deep-dive": "node mcp/src/tools/voc-problem-deep-dive-run.js --issue 怎么选 --industry 家居定制 --scenario 线上获客 --audience 意向用户 --assistant-message-only",
-    "voc:content-plan": "node mcp/src/tools/voc-content-plan-run.js --brand 示例品牌A --industry 家居定制 --issues \"第一次买怕踩雷;觉得价格贵;怕质量不稳定\" --assistant-message-only",
-    "voc:speaking-script": "node mcp/src/tools/voc-speaking-script-run.js --brand 示例品牌A --industry 家居定制 --topic \"第一次买怎么选不踩雷\" --user-issue \"第一次买怕选错\" --evidence \"第一次买不知道怎么选，怕踩雷\" --assistant-message-only",
-    "voc:competitor-map": "node mcp/src/tools/voc-competitor-map-run.js --brand 示例品牌A --city 本地 --category 家居定制 --assistant-message-only",
-    "voc:business-workflow": "node mcp/src/tools/voc-business-workflow-run.js --brand 示例品牌A --industry 家居定制 --platform douyin --collection-mode sample --keywords \"家居定制怎么选,第一次买怎么对比,售后\" --assistant-message-only",
-    "mcp:start": "node mcp/src/server.js",
-    "mcp:smoke": "node scripts/smoke-mcp.js",
-    "acceptance": "node scripts/acceptance.js",
-    "acceptance:installer": "node scripts/installer-acceptance.js"
-  },
-  "files": [
-    "SKILL.md",
-    ".claude-plugin/",
-    ".mcp.json",
-    "bin/",
-    "docs/",
-    "install.js",
-    "mcp/src/",
-    "mcp/catalog/params/",
-    "mcp/catalog/voc-social-endpoints.json",
-    "memory-templates/",
-    "package.json",
-    "README.md",
-    "scripts/",
-    "skill-package-manifest.json",
-    "skills/"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "claude-code",
-    "voc",
-    "voice-of-customer",
-    "xiaohongshu",
-    "douyin",
-    "trend-intelligence",
-    "customer-insights",
-    "mcp",
-    "openclaw",
-    "social-listening"
-  ],
-  "homepage": "https://www.npmjs.com/package/@vocmarket/voc-skill",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^4.4.3"
-  }
-}
+{
+  "name": "@vocmarket/voc-skill",
+  "version": "0.3.39",
+  "description": "Claude Code VOC intelligence skills for Xiaohongshu, Douyin and WeChat Channels trend/content collection, live social VOC, Fmode image analysis, single-issue deep dives, boss/operator action plans, and multi-turn memory.",
+  "type": "commonjs",
+  "bin": {
+    "claude-voc": "bin/claude-voc.js"
+  },
+  "scripts": {
+    "install:check": "node install.js --check",
+    "install:smoke": "node install.js --smoke",
+    "smoke:package": "node scripts/smoke-package.js",
+    "smoke:cross-industry": "node scripts/smoke-cross-industry.js",
+    "fmode:image": "node mcp/src/tools/fmode-image-analysis.js",
+    "fmode:image:smoke": "node scripts/fmode-image-analysis-smoke.js",
+    "smoke:billing": "node scripts/billing-client-smoke.js",
+    "smoke:budget": "node scripts/smoke-budget-guard.js",
+    "smoke:trend-budget": "node scripts/smoke-trend-budget.js",
+    "smoke:cost": "node scripts/smoke-cost-estimate.js",
+    "smoke:cost-calibration": "node scripts/smoke-cost-calibration.js",
+    "smoke:media": "node scripts/smoke-media-pipeline.js",
+    "smoke:request": "node scripts/smoke-voc-request-shaping.js",
+    "audit:index": "node scripts/audit-index.js",
+    "xhs:sample": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-sample --result-prefix XHS_TREND_RESULT",
+    "xhs:preference-smoke": "node mcp/src/tools/xiaohongshu-preference-update.js --message \"保留奶油风和全屋定制翻车方向，不要纯风格美图，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --result-prefix XHS_PREF_RESULT",
+    "xhs:sample-with-memory": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode sample --profile memory-templates/xiaohongshu-trend-profile.json --memory ../outputs/claude-code-xhs-memory-smoke/xiaohongshu-trend-memory.json --output ../outputs/claude-code-xhs-memory-smoke/report --result-prefix XHS_TREND_RESULT",
+    "xhs:live": "node mcp/src/tools/xiaohongshu-trend-run.js --collection-mode live --profile memory-templates/xiaohongshu-trend-profile.json --output ../outputs/claude-code-xhs-live --keyword-limit 1 --notes-per-keyword 1 --max-comment-pages 1 --result-prefix XHS_TREND_RESULT",
+    "dy:sample": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-sample --result-prefix DOUYIN_TREND_RESULT",
+    "dy:preference-smoke": "node mcp/src/tools/douyin-preference-update.js --message \"保留口播开头和评论区问题，不要只做纯素材剪辑，下一个版本更偏门店转化话术。\" --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --result-prefix DOUYIN_PREF_RESULT",
+    "dy:sample-with-memory": "node mcp/src/tools/douyin-trend-run.js --collection-mode sample --profile memory-templates/douyin-trend-profile.json --memory ../outputs/claude-code-douyin-memory-smoke/douyin-trend-memory.json --output ../outputs/claude-code-douyin-memory-smoke/report --result-prefix DOUYIN_TREND_RESULT",
+    "dy:live": "node mcp/src/tools/douyin-trend-run.js --collection-mode live --profile memory-templates/douyin-trend-profile.json --output ../outputs/claude-code-douyin-live --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 1 --result-prefix DOUYIN_TREND_RESULT",
+    "voc:issue-pool": "node mcp/src/tools/voc-issue-pool-run.js --project 示例品牌A --industry 家居定制 --scenario 线上获客 --audience 意向用户 --evidence \"第一次买不知道怎么选，怕踩雷。;价格有点高，不确定值不值。;咨询的时候没人理。\" --assistant-message-only",
+    "voc:deep-dive": "node mcp/src/tools/voc-problem-deep-dive-run.js --issue 怎么选 --industry 家居定制 --scenario 线上获客 --audience 意向用户 --assistant-message-only",
+    "voc:content-plan": "node mcp/src/tools/voc-content-plan-run.js --brand 示例品牌A --industry 家居定制 --issues \"第一次买怕踩雷;觉得价格贵;怕质量不稳定\" --assistant-message-only",
+    "voc:speaking-script": "node mcp/src/tools/voc-speaking-script-run.js --brand 示例品牌A --industry 家居定制 --topic \"第一次买怎么选不踩雷\" --user-issue \"第一次买怕选错\" --evidence \"第一次买不知道怎么选，怕踩雷\" --assistant-message-only",
+    "voc:competitor-map": "node mcp/src/tools/voc-competitor-map-run.js --brand 示例品牌A --city 本地 --category 家居定制 --assistant-message-only",
+    "voc:business-workflow": "node mcp/src/tools/voc-business-workflow-run.js --brand 示例品牌A --industry 家居定制 --platform douyin --collection-mode sample --keywords \"家居定制怎么选,第一次买怎么对比,售后\" --assistant-message-only",
+    "mcp:start": "node mcp/src/server.js",
+    "mcp:smoke": "node scripts/smoke-mcp.js",
+    "acceptance": "node scripts/acceptance.js",
+    "acceptance:installer": "node scripts/installer-acceptance.js"
+  },
+  "files": [
+    "SKILL.md",
+    ".claude-plugin/",
+    ".mcp.json",
+    "bin/",
+    "docs/",
+    "install.js",
+    "mcp/src/",
+    "mcp/catalog/params/",
+    "mcp/catalog/voc-social-endpoints.json",
+    "memory-templates/",
+    "package.json",
+    "README.md",
+    "scripts/",
+    "skill-package-manifest.json",
+    "skills/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude-code",
+    "voc",
+    "voice-of-customer",
+    "xiaohongshu",
+    "douyin",
+    "trend-intelligence",
+    "customer-insights",
+    "mcp",
+    "openclaw",
+    "social-listening"
+  ],
+  "homepage": "https://www.npmjs.com/package/@vocmarket/voc-skill",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  }
+}

package/scripts/smoke-package.js

@@ -515,7 +515,7 @@ async function smokeBusinessStatusErrors() {
     global.fetch = makeBusinessErrorFetch();
     await new XiaohongshuApi({
       token: 'r:smoke-token',
-      baseUrl: 'https://example.test/xiaohongshu/app'
+      baseUrl: 'https://example.test/xiaohongshu'
     }).searchNotes({ keyword: 'smoke' });
     throw new Error('xiaohongshu business status 403 did not throw');
   } catch (error) {

package/skill-package-manifest.json

@@ -1,137 +1,137 @@
-{
-  "name": "claude-code-voc-intelligence",
-  "version": "0.3.37",
-  "capabilities": {
-    "summary": "三类情报源同源接入：①社媒内容（含抖音/小红书/微信视频号等）②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
-    "channels": [
-      {
-        "key": "social",
-        "label": "社媒内容",
-        "platforms": 18,
-        "apis": 1018,
-        "examples": [
-          "抖音",
-          "小红书",
-          "TikTok",
-          "YouTube",
-          "微博",
-          "哔哩哔哩",
-          "快手",
-          "知乎",
-          "Instagram",
-          "Reddit",
-          "Twitter/X",
-          "微信/视频号"
-        ]
-      },
-      {
-        "key": "ecommerce",
-        "label": "国内电商 + 创作者情报",
-        "platforms": 32,
-        "apis": 289,
-        "examples": [
-          "京东",
-          "淘宝天猫",
-          "1688",
-          "抖音电商",
-          "TikTok Shop",
-          "闲鱼",
-          "得物",
-          "抖音星图",
-          "小红书蒲公英"
-        ]
-      },
-      {
-        "key": "overseas",
-        "label": "海外选品",
-        "platforms": 1,
-        "apis": 37,
-        "examples": [
-          "亚马逊"
-        ]
-      }
-    ],
-    "totals": {
-      "platforms": 51,
-      "apis": 1344
-    }
-  },
-  "description": "Claude Code native VOC intelligence package for cross-industry social VOC workflows. Includes Xiaohongshu, Douyin and WeChat Channels collection/intelligence, live token checks, evidence-card reports, single-issue VOC deep dives, boss/operator action plans, and scoped multi-turn memory.",
-  "changelogUrl": "https://www.npmjs.com/package/@vocmarket/voc-skill?activeTab=versions",
-  "plugin": "voc-intelligence",
-  "skills": [
-    "xiaohongshu-trend-intelligence",
-    "douyin-trend-intelligence",
-    "voc-issue-pool",
-    "voc-problem-deep-dive",
-    "voc-content-plan",
-    "voc-speaking-script",
-    "voc-competitor-map",
-    "voc-business-workflow",
-    "fmode-image-analysis",
-    "voc-api-catalog",
-    "voc-cost-controller"
-  ],
-  "mcpTools": [
-    "fmode_image_analysis",
-    "voc_business_workflow_run",
-    "voc_speaking_script_run",
-    "voc_issue_pool_run",
-    "voc_problem_deep_dive_run",
-    "voc_content_plan_run",
-    "voc_competitor_map_run",
-    "voc_xiaohongshu_token_check",
-    "voc_xiaohongshu_trend_run",
-    "voc_xiaohongshu_preference_update",
-    "voc_douyin_token_check",
-    "voc_douyin_trend_run",
-    "voc_douyin_preference_update",
-    "voc_api_search",
-    "voc_api_doc",
-    "voc_api_call",
-    "voc_billing_query",
-    "voc_cost_estimate",
-    "voc_usage_report"
-  ],
-  "apiCatalog": "mcp/catalog/voc-social-endpoints.json",
-  "entrySkill": "voc-business-workflow",
-  "capabilityMap": "docs/capability-map.md",
-  "taobaoV7Doc": "docs/taobao-item-detail-v7.md",
-  "bossPromptTemplates": "docs/boss-prompt-templates.md",
-  "liveAcceptanceChecklist": "docs/live-manual-acceptance-checklist.md",
-  "troubleshootingPlaybook": "docs/claude-code-troubleshooting-playbook.md",
-  "paymentLinksDoc": "docs/payment-package-links.md",
-  "contextBudgetDoc": "docs/context-budget-implementation-plan.md",
-  "costMeteringSpec": "docs/voc-cost-metering-and-balance-implementation-spec.md",
-  "apiErrorCodesDoc": "skills/voc-api-catalog/references/error-codes.md",
-  "primaryUseCases": [
-    "First-round Xiaohongshu or Douyin trend intelligence from sample or live collection",
-    "Evidence-first customer concern and opportunity reports",
-    "Prioritized VOC issue pools with status, evidence, impact, and next actions",
-    "Single VOC problem deep dive into boss/operator actions and 7-day validation plans",
-    "7-day VOC content plans with speaking scripts and validation metrics",
-    "VOC-backed speaking script co-creation with revision, finalization, and script memory",
-    "End-to-end VOC business workflow from market voices to issue, action, content, and script",
-    "Competitor maps and differentiated opportunity reports from VOC evidence",
-    "Interface catalog lookup and generic VOC gateway calls across social, ecommerce, and overseas channels",
-    "Preflight cost estimates, balance checks, budget controls, and post-run usage reports",
-    "Fmode Doubao vision image analysis for screenshots, product images, UI captures, charts, posters, and image text",
-    "Multi-turn preference and scoped memory so repeated use gets more tailored",
-    "Friendly token and recharge handling for live collection"
-  ],
-  "recommendedUserPrompts": [
-    "帮我做一份家装全屋定制行业的小红书趋势情报。先用演示样例跑通流程，不要真实采集。",
-    "帮我看下家居定制行业抖音上用户最近在吐槽什么，先小规模真实采集。",
-    "继续深挖“怎么选”这个问题，站在老板视角告诉我怎么解决。",
-    "监听 280 个账号并生成日报，先给我经济版、标准版和完整版的预计成本、余额风险和降本建议。",
-    "查一下这份报告实际调用了哪些接口、各调用多少次、分别消耗了多少额度。"
-  ],
-  "sampleCommand": "npm run xhs:sample",
-  "mcpSmokeCommand": "npm run mcp:smoke",
-  "installCommand": "node install.js",
-  "npmInstallCommand": "npm install -g @vocmarket/voc-skill && claude-voc install",
-  "npxInstallCommand": "npx @vocmarket/voc-skill install",
-  "workspaceInstallCommand": "npx @vocmarket/voc-skill workspace --smoke",
-  "workspaceInstallTarget": ".claude/plugins/voc-intelligence",
-  "installHint": "Supports three delivery modes: unzip and run node install.js, install globally into ~/.claude/plugins/voc-intelligence, or install into the current workspace. Workspace mode writes .mcp.json plus .claude/skills/* entries for trend intelligence, issue pool, deep dive, competitor map, content plan, speaking script, VOC business workflow, Fmode image analysis, API catalog, and cost controller so VSCode Claude Code can discover all workflows without relying only on --plugin-dir."
-}
+{
+  "name": "claude-code-voc-intelligence",
+  "version": "0.3.39",
+  "capabilities": {
+    "summary": "三类情报源同源接入：①社媒内容（含抖音/小红书/微信视频号等）②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
+    "channels": [
+      {
+        "key": "social",
+        "label": "社媒内容",
+        "platforms": 18,
+        "apis": 1018,
+        "examples": [
+          "抖音",
+          "小红书",
+          "TikTok",
+          "YouTube",
+          "微博",
+          "哔哩哔哩",
+          "快手",
+          "知乎",
+          "Instagram",
+          "Reddit",
+          "Twitter/X",
+          "微信/视频号"
+        ]
+      },
+      {
+        "key": "ecommerce",
+        "label": "国内电商 + 创作者情报",
+        "platforms": 32,
+        "apis": 289,
+        "examples": [
+          "京东",
+          "淘宝天猫",
+          "1688",
+          "抖音电商",
+          "TikTok Shop",
+          "闲鱼",
+          "得物",
+          "抖音星图",
+          "小红书蒲公英"
+        ]
+      },
+      {
+        "key": "overseas",
+        "label": "海外选品",
+        "platforms": 1,
+        "apis": 37,
+        "examples": [
+          "亚马逊"
+        ]
+      }
+    ],
+    "totals": {
+      "platforms": 51,
+      "apis": 1344
+    }
+  },
+  "description": "Claude Code native VOC intelligence package for cross-industry social VOC workflows. Includes Xiaohongshu, Douyin and WeChat Channels collection/intelligence, live token checks, evidence-card reports, single-issue VOC deep dives, boss/operator action plans, and scoped multi-turn memory.",
+  "changelogUrl": "https://www.npmjs.com/package/@vocmarket/voc-skill?activeTab=versions",
+  "plugin": "voc-intelligence",
+  "skills": [
+    "xiaohongshu-trend-intelligence",
+    "douyin-trend-intelligence",
+    "voc-issue-pool",
+    "voc-problem-deep-dive",
+    "voc-content-plan",
+    "voc-speaking-script",
+    "voc-competitor-map",
+    "voc-business-workflow",
+    "fmode-image-analysis",
+    "voc-api-catalog",
+    "voc-cost-controller"
+  ],
+  "mcpTools": [
+    "fmode_image_analysis",
+    "voc_business_workflow_run",
+    "voc_speaking_script_run",
+    "voc_issue_pool_run",
+    "voc_problem_deep_dive_run",
+    "voc_content_plan_run",
+    "voc_competitor_map_run",
+    "voc_xiaohongshu_token_check",
+    "voc_xiaohongshu_trend_run",
+    "voc_xiaohongshu_preference_update",
+    "voc_douyin_token_check",
+    "voc_douyin_trend_run",
+    "voc_douyin_preference_update",
+    "voc_api_search",
+    "voc_api_doc",
+    "voc_api_call",
+    "voc_billing_query",
+    "voc_cost_estimate",
+    "voc_usage_report"
+  ],
+  "apiCatalog": "mcp/catalog/voc-social-endpoints.json",
+  "entrySkill": "voc-business-workflow",
+  "capabilityMap": "docs/capability-map.md",
+  "taobaoV7Doc": "docs/taobao-item-detail-v7.md",
+  "bossPromptTemplates": "docs/boss-prompt-templates.md",
+  "liveAcceptanceChecklist": "docs/live-manual-acceptance-checklist.md",
+  "troubleshootingPlaybook": "docs/claude-code-troubleshooting-playbook.md",
+  "paymentLinksDoc": "docs/payment-package-links.md",
+  "contextBudgetDoc": "docs/context-budget-implementation-plan.md",
+  "costMeteringSpec": "docs/voc-cost-metering-and-balance-implementation-spec.md",
+  "apiErrorCodesDoc": "skills/voc-api-catalog/references/error-codes.md",
+  "primaryUseCases": [
+    "First-round Xiaohongshu or Douyin trend intelligence from sample or live collection",
+    "Evidence-first customer concern and opportunity reports",
+    "Prioritized VOC issue pools with status, evidence, impact, and next actions",
+    "Single VOC problem deep dive into boss/operator actions and 7-day validation plans",
+    "7-day VOC content plans with speaking scripts and validation metrics",
+    "VOC-backed speaking script co-creation with revision, finalization, and script memory",
+    "End-to-end VOC business workflow from market voices to issue, action, content, and script",
+    "Competitor maps and differentiated opportunity reports from VOC evidence",
+    "Interface catalog lookup and generic VOC gateway calls across social, ecommerce, and overseas channels",
+    "Preflight cost estimates, balance checks, budget controls, and post-run usage reports",
+    "Fmode Doubao vision image analysis for screenshots, product images, UI captures, charts, posters, and image text",
+    "Multi-turn preference and scoped memory so repeated use gets more tailored",
+    "Friendly token and recharge handling for live collection"
+  ],
+  "recommendedUserPrompts": [
+    "帮我做一份家装全屋定制行业的小红书趋势情报。先用演示样例跑通流程，不要真实采集。",
+    "帮我看下家居定制行业抖音上用户最近在吐槽什么，先小规模真实采集。",
+    "继续深挖“怎么选”这个问题，站在老板视角告诉我怎么解决。",
+    "监听 280 个账号并生成日报，先给我经济版、标准版和完整版的预计成本、余额风险和降本建议。",
+    "查一下这份报告实际调用了哪些接口、各调用多少次、分别消耗了多少额度。"
+  ],
+  "sampleCommand": "npm run xhs:sample",
+  "mcpSmokeCommand": "npm run mcp:smoke",
+  "installCommand": "node install.js",
+  "npmInstallCommand": "npm install -g @vocmarket/voc-skill && claude-voc install",
+  "npxInstallCommand": "npx @vocmarket/voc-skill install",
+  "workspaceInstallCommand": "npx @vocmarket/voc-skill workspace --smoke",
+  "workspaceInstallTarget": ".claude/plugins/voc-intelligence",
+  "installHint": "Supports three delivery modes: unzip and run node install.js, install globally into ~/.claude/plugins/voc-intelligence, or install into the current workspace. Workspace mode writes .mcp.json plus .claude/skills/* entries for trend intelligence, issue pool, deep dive, competitor map, content plan, speaking script, VOC business workflow, Fmode image analysis, API catalog, and cost controller so VSCode Claude Code can discover all workflows without relying only on --plugin-dir."
+}

package/skills/voc-api-catalog/SKILL.md

@@ -46,6 +46,25 @@ VOC 后端是一个**通用转发网关**（`https://server.fmode.cn/api/voc-soc
 4. `voc_api_call` 用真实关键词调用；翻页/拉评论时把上一次返回里的 cursor / id 透传进下一次调用。
 5. 用返回数据继续后续分析（可交给 voc-issue-pool、voc-content-plan 等技能）。
 
+## 小红书现用接口（V2）
+
+小红书社媒采集只走下面这些健康的 V2 接口。`voc_api_search` 会把它们排在前面；标了 `deprecated` 的旧接口不要调用，也不要在给用户的说明里提到。
+
+| 用途 | 接口 id | proxyPath | 必填 |
+|---|---|---|---|
+| 笔记搜索 | `xiaohongshu.app_v2.search_notes` | `xiaohongshu/app_v2/search_notes` | `keyword` |
+| 图文详情 | `xiaohongshu.app_v2.get_image_note_detail` | `xiaohongshu/app_v2/get_image_note_detail` | `note_id` 或 `share_text` |
+| 视频详情 | `xiaohongshu.app_v2.get_video_note_detail` | `xiaohongshu/app_v2/get_video_note_detail` | `note_id` 或 `share_text` |
+| 一级评论 | `xiaohongshu.note_comments` | `xiaohongshu/app_v2/get_note_comments` | `note_id` |
+| 楼中楼 | `xiaohongshu.sub_comments` | `xiaohongshu/app_v2/get_note_sub_comments` | `note_id` + `comment_id` |
+| 用户资料 | `xiaohongshu.app_v2.get_user_info` | `xiaohongshu/app_v2/get_user_info` | `user_id` |
+| 用户笔记 | `xiaohongshu.app_v2.get_user_posted_notes` | `xiaohongshu/app_v2/get_user_posted_notes` | `user_id` |
+| 话题详情 | `xiaohongshu.app_v2.get_topic_info` | `xiaohongshu/app_v2/get_topic_info` | `page_id` |
+| 话题笔记 | `xiaohongshu.app_v2.get_topic_feed` | `xiaohongshu/app_v2/get_topic_feed` | `page_id` |
+| 商品搜索 | `xiaohongshu.app_v2.search_products` | `xiaohongshu/app_v2/search_products` | `keyword` |
+
+搜索先用 `xiaohongshu.app_v2.search_notes` 拿 `note_id`，再按笔记类型选图文或视频详情，评论和楼中楼继续用上表两条。不确定类型时先试视频详情，空结果再试图文详情。具体参数用 `voc_api_doc` 读取，不要手写旧路径。
+
 ## 创作者侧情报（channel=ecommerce）
 
 抖音星图 / 小红书蒲公英（PGY）的创作者数据是 VOC 在**创作者生态**维度的情报源——它服务的是 VOC 一贯的「内容战略、竞对理解、受众洞察、选题与脚本」闭环，而**不是**「替用户挑达人投广告」。同一套数据用来回答这些 VOC 问题：

package/skills/xiaohongshu-trend-intelligence/references/live-mode.md

@@ -14,6 +14,14 @@ live 模式默认保持小规模：
 - `notesPerKeyword = 1`
 - `maxCommentPages = 1`
 
+## 接口优先级
+
+live 采集只走健康的 V2：
+
+- 搜索：`app_v2/search_notes`，空结果再降级 `web_v3/fetch_search_notes`
+- 详情：视频笔记用 `app_v2/get_video_note_detail`，图文笔记用 `app_v2/get_image_note_detail`
+- 评论：`app_v2/get_note_comments`
+
 ## 媒体持久化
 
 响应中的图片、视频、音频、封面、买家秀和详情素材始终写入本地 `assets/`，并登记到 `media-manifest.json`。旧 `cacheAssets` 参数仅作兼容，传 `false` 也不会跳过持久化；报告只引用本地路径。