@vocmarket/voc-skill 0.3.37 → 0.3.38

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.38",
+  "author": {
+    "name": "nkkj-BrainHack"
+  }
+}

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.38'
   });
 
   server.registerTool(

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.38",
+  "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.38",
+  "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/xiaohongshu-trend-intelligence/references/live-mode.md

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