@vocmarket/voc-skill 0.3.38 → 0.3.39

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "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",
+  "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/server.js

@@ -66,7 +66,7 @@ function normalizeToolResult(result = {}) {
 function createServer() {
   const server = new McpServer({
     name: 'voc-intelligence',
-    version: '0.3.38'
+    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,6 +1,6 @@
 {
   "name": "@vocmarket/voc-skill",
-  "version": "0.3.38",
+  "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": {

package/skill-package-manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-voc-intelligence",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "capabilities": {
     "summary": "三类情报源同源接入：①社媒内容（含抖音/小红书/微信视频号等）②国内电商+创作者情报 ③海外选品。统一 search→doc→call、鉴权计费一致。",
     "channels": [

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

@@ -16,10 +16,10 @@ live 模式默认保持小规模：
 
 ## 接口优先级
 
-live 采集走可用链路，不再依赖已不稳定的旧 App 搜索/详情：
+live 采集只走健康的 V2：
 
-- 搜索：`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/search_notes`，空结果再降级 `web_v3/fetch_search_notes`
+- 详情：视频笔记用 `app_v2/get_video_note_detail`，图文笔记用 `app_v2/get_image_note_detail`
 - 评论：`app_v2/get_note_comments`
 
 ## 媒体持久化