@vocmarket/voc-skill 0.3.15 → 0.3.17

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 and Douyin trend reports, live social VOC collection, 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.15",
+  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and Douyin 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.17",
   "author": {
     "name": "nkkj-BrainHack"
   }

package/.mcp.json

@@ -3,9 +3,9 @@
     "voc": {
       "command": "node",
       "args": [
-        "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence\\mcp\\src\\server.js"
+        "E:\\workspace\\openclaw-voc-skill\\claude-code\\claude-code-voc-intelligence\\mcp\\src\\server.js"
       ],
-      "cwd": "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence"
+      "cwd": "E:\\workspace\\openclaw-voc-skill\\claude-code\\claude-code-voc-intelligence"
     }
   }
 }

package/README.md

@@ -110,6 +110,7 @@ npx --yes @vocmarket/voc-skill@latest workspace --smoke
 .claude/skills/voc-speaking-script/SKILL.md
 .claude/skills/voc-competitor-map/SKILL.md
 .claude/skills/voc-business-workflow/SKILL.md
+.claude/skills/fmode-image-analysis/SKILL.md
 .claude/plugins/voc-intelligence
 ```
 
@@ -186,9 +187,11 @@ npx --yes @vocmarket/voc-skill@latest install --smoke
 - `voc-speaking-script`
 - `voc-competitor-map`
 - `voc-business-workflow`
+- `fmode-image-analysis`
 
 MCP 工具：
 
+- `fmode_image_analysis`
 - `voc_business_workflow_run`
 - `voc_xiaohongshu_trend_run`
 - `voc_xiaohongshu_preference_update`
@@ -207,6 +210,8 @@ MCP 工具：
 ```powershell
 npm --prefix claude-code-voc-intelligence run xhs:sample
 npm --prefix claude-code-voc-intelligence run dy:sample
+npm --prefix claude-code-voc-intelligence run fmode:image:smoke
+claude-voc image --image-path E:\workspace\example\screenshot.png --prompt "识别截图里的文字、主体和风险点"
 npm --prefix claude-code-voc-intelligence run voc:issue-pool
 npm --prefix claude-code-voc-intelligence run voc:deep-dive
 npm --prefix claude-code-voc-intelligence run voc:business-workflow

package/bin/claude-voc.js

@@ -15,6 +15,7 @@ const EXCLUDED_DIRS = new Set([
   'node_modules',
   'memory',
   'outputs',
+  '.npm-cache-acceptance',
   '.tmp',
   '.git',
   '.claude'
@@ -36,6 +37,7 @@ function usage() {
     '  claude-voc install --workspace --smoke',
     '  claude-voc check',
     '  claude-voc smoke',
+    '  claude-voc image --image-path <file> --prompt <text>',
     '  claude-voc path',
     '',
     'npx:',
@@ -181,6 +183,11 @@ function assertInstalled(targetDir) {
     'skills/voc-speaking-script/SKILL.md',
     'skills/voc-competitor-map/SKILL.md',
     'skills/voc-business-workflow/SKILL.md',
+    'skills/fmode-image-analysis/SKILL.md',
+    'skills/voc-api-catalog/SKILL.md',
+    'mcp/src/tools/fmode-image-analysis.js',
+    'mcp/src/tools/voc-api-catalog-run.js',
+    'mcp/catalog/voc-social-endpoints.json',
     'mcp/src/server.js'
   ];
   const missing = required.filter(rel => !fs.existsSync(path.join(targetDir, rel)));
@@ -641,6 +648,8 @@ function writeWorkspaceSkillEntries(targetDir) {
   const speakingScriptSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-speaking-script');
   const competitorMapSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-competitor-map');
   const businessWorkflowSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-business-workflow');
+  const fmodeImageSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'fmode-image-analysis');
+  const apiCatalogSkillDir = path.join(WORKSPACE_ROOT, '.claude', 'skills', 'voc-api-catalog');
   ensureDir(xhsSkillDir);
   ensureDir(douyinSkillDir);
   ensureDir(issuePoolSkillDir);
@@ -649,6 +658,8 @@ function writeWorkspaceSkillEntries(targetDir) {
   ensureDir(speakingScriptSkillDir);
   ensureDir(competitorMapSkillDir);
   ensureDir(businessWorkflowSkillDir);
+  ensureDir(fmodeImageSkillDir);
+  ensureDir(apiCatalogSkillDir);
   fs.writeFileSync(path.join(xhsSkillDir, 'SKILL.md'), workspaceSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(douyinSkillDir, 'SKILL.md'), workspaceDouyinSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(issuePoolSkillDir, 'SKILL.md'), workspaceIssuePoolSkillText(targetDir), 'utf8');
@@ -657,6 +668,8 @@ function writeWorkspaceSkillEntries(targetDir) {
   fs.writeFileSync(path.join(speakingScriptSkillDir, 'SKILL.md'), workspaceSpeakingScriptSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(competitorMapSkillDir, 'SKILL.md'), workspaceCompetitorMapSkillText(targetDir), 'utf8');
   fs.writeFileSync(path.join(businessWorkflowSkillDir, 'SKILL.md'), workspaceBusinessWorkflowSkillText(targetDir), 'utf8');
+  fs.copyFileSync(path.join(targetDir, 'skills', 'fmode-image-analysis', 'SKILL.md'), path.join(fmodeImageSkillDir, 'SKILL.md'));
+  fs.copyFileSync(path.join(targetDir, 'skills', 'voc-api-catalog', 'SKILL.md'), path.join(apiCatalogSkillDir, 'SKILL.md'));
 }
 
 function writeWorkspaceActivation(targetDir) {
@@ -672,6 +685,8 @@ function writeWorkspaceActivation(targetDir) {
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-speaking-script\\SKILL.md');
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-competitor-map\\SKILL.md');
   console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-business-workflow\\SKILL.md');
+  console.log('Wrote workspace skill entry: .\\.claude\\skills\\fmode-image-analysis\\SKILL.md');
+  console.log('Wrote workspace skill entry: .\\.claude\\skills\\voc-api-catalog\\SKILL.md');
 }
 
 function printNextSteps(targetDir) {
@@ -692,6 +707,7 @@ function printNextSteps(targetDir) {
     console.log('  .\\.claude\\skills\\voc-speaking-script\\SKILL.md');
     console.log('  .\\.claude\\skills\\voc-competitor-map\\SKILL.md');
     console.log('  .\\.claude\\skills\\voc-business-workflow\\SKILL.md');
+    console.log('  .\\.claude\\skills\\fmode-image-analysis\\SKILL.md');
     console.log('  .\\.claude\\plugins\\voc-intelligence');
     console.log('');
     console.log('Restart the VSCode Claude Code session if it was already open.');
@@ -769,6 +785,12 @@ function printPath(opts) {
 }
 
 function main() {
+  const directCommand = process.argv[2];
+  if (directCommand === 'image' || directCommand === 'fmode-image') {
+    run(process.execPath, ['mcp/src/tools/fmode-image-analysis.js', ...process.argv.slice(3)], SOURCE_ROOT);
+    return;
+  }
+
   const opts = parseArgs(process.argv.slice(2));
   if (opts.help || opts.command === 'help') {
     console.log(usage());

package/docs/capability-map.md

@@ -22,6 +22,12 @@
 | 选中一条内容继续改口播 | `voc-speaking-script` | `voc_speaking_script_run` | 60 秒稿、30 秒稿、提词器版、改稿反馈、定稿记忆 |
 | 下轮继续优化 | 同一 skill | 带同一 `memory`，或带 project/industry/scenario/audience 让工具自动分桶 | 应用历史记忆，避免从零开始 |
 
+## Fmode Image Analysis Add-on
+
+| 能力 | 推荐入口 | MCP 工具 | 输出重点 |
+| --- | --- | --- | --- |
+| 图片识别/截图分析 | `fmode-image-analysis` | `fmode_image_analysis` | 使用平台用户 token 调用 Fmode Doubao vision，默认模型 `doubao-seed-2-0-pro-260215` |
+
 ## 技能入口
 
 ### `voc-business-workflow`

package/docs/npm-packaging-notes.md

@@ -1,93 +1,228 @@
-# Claude Code VOC 技能包 npm 打包经验
+# Claude Code VOC 技能包 npm 打包与发布说明
 
-## 目标
+## 当前包名
 
-同一个技能包同时支持两种交付：
+VOC 技能包当前对外 npm 包名：
 
-- 链接下载 zip：适合不会 npm 的客户，解压后执行 `node install.js`。
-- npm/npx 安装：适合教学、远程交付和批量升级。
+```bash
+@vocmarket/voc-skill
+```
 
-推荐命令：
+CLI 命令保持不变：
 
 ```bash
-npm install -g @vocmarket/voc-skill
-claude-voc install
+claude-voc
 ```
 
-免全局安装：
+插件安装目录也保持不变：
 
-```bash
-npx @vocmarket/voc-skill install
+```text
+voc-intelligence
 ```
 
-## 关键设计
+这样做的目的：对外包名更短、更适合课程和市场传播；同时不破坏已经沉淀好的 Claude Code 插件目录、MCP server 名称和 skill 入口。
 
-`npx` 下载的包可能在临时缓存里，不能直接让 Claude Code 长期加载这个临时目录。
+## 用户安装方式
 
-所以 `claude-voc install` 会把包复制到固定目录：
+推荐给 VSCode Claude Code 使用工作区安装：
+
+```powershell
+npx --yes @vocmarket/voc-skill@latest workspace --smoke
+```
+
+工作区安装会写入：
 
 ```text
-~/.claude/plugins/voc-intelligence
+.\.mcp.json
+.\.claude\plugins\voc-intelligence
+.\.claude\skills\xiaohongshu-trend-intelligence\SKILL.md
+.\.claude\skills\douyin-trend-intelligence\SKILL.md
+.\.claude\skills\voc-issue-pool\SKILL.md
+.\.claude\skills\voc-problem-deep-dive\SKILL.md
+.\.claude\skills\voc-content-plan\SKILL.md
+.\.claude\skills\voc-speaking-script\SKILL.md
+.\.claude\skills\voc-competitor-map\SKILL.md
+.\.claude\skills\voc-business-workflow\SKILL.md
 ```
 
-然后在该目录安装运行依赖，并输出：
+全局安装：
 
-```bash
-claude --plugin-dir "<安装目录>"
+```powershell
+npm install -g @vocmarket/voc-skill
+claude-voc install
 ```
 
-这样全局安装和 npx 安装的结果一致，后续也便于升级。
+npx 免全局安装：
 
-## package.json 要点
+```powershell
+npx --yes @vocmarket/voc-skill@latest install
+```
 
-- npm 包名使用 scoped package：`@vocmarket/voc-skill`
-- CLI 入口：
+## package.json 要点
 
 ```json
 {
+  "name": "@vocmarket/voc-skill",
   "bin": {
     "claude-voc": "bin/claude-voc.js"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }
 ```
 
-- `files` 必须显式包含：
-  - `.claude-plugin/`
-  - `.mcp.json`
-  - `bin/`
-  - `skills/`
-  - `mcp/`
-  - `memory-templates/`
-  - `docs/`
-  - `install.js`
-  - `skill-package-manifest.json`
+`files` 必须显式包含：
+
+- `.claude-plugin/`
+- `.mcp.json`
+- `bin/`
+- `docs/`
+- `install.js`
+- `mcp/`
+- `memory-templates/`
+- `package.json`
+- `scripts/`
+- `skill-package-manifest.json`
+- `skills/`
+
+不要发布：
+
+- `.env`
+- `.env.local`
+- `.npmrc`
+- `node_modules/`
+- `memory/`
+- `outputs/`
+- 本地 smoke 临时目录
+
+## 发布前验证
+
+在仓库根目录执行：
+
+```powershell
+npm --prefix claude-code/claude-code-voc-intelligence run mcp:smoke
+npm --prefix claude-code/claude-code-voc-intelligence run smoke:package
+npm run claude-voc:acceptance
+npm run claude-voc:build
+npm run claude-voc:npm-pack
+```
 
-## 验证命令
+`npm run claude-voc:npm-pack` 会做三类验证：
 
-根目录执行：
+1. 校验 npm package metadata、CLI 入口和必要文件。
+2. 生成 `dist/npm/vocmarket-voc-skill-<version>.tgz`。
+3. 在临时目录模拟 npm install、npx install、workspace install，并执行 `--smoke`。
 
-```bash
-npm run claude-voc:npm-pack
-```
+`npm run claude-voc:acceptance` 是更完整的发布前验收，会额外断言 workspace 安装后的：
 
-这个命令会做三件事：
+- `.mcp.json` 已生成
+- 8 个 `.claude/skills/*/SKILL.md` 入口已生成
+- MCP server 路径是安装后插件目录里的绝对路径
+- `npm pack --dry-run` 能看到关键文件
 
-1. 校验 npm package metadata 和 CLI 入口。
-2. 生成 `dist/npm/*.tgz`。
-3. 在临时目录里模拟 npm 安装，并执行 `claude-voc install --smoke`。
+## 正式发布
 
-发布命令：
+推荐使用 release 脚本：
 
-```bash
+```powershell
+powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/publish.ps1
+```
+
+也可以直接执行：
+
+```powershell
 npm run claude-voc:npm-publish
 ```
 
-发布前需要完成 `npm login`，或在 CI/部署环境配置 npm token。
+发布脚本会读取以下位置的 token：
+
+```text
+release/npm/claude-code-voc-intelligence/.env.local
+```
+
+文件内容格式：
+
+```text
+NPM_TOKEN=你的 npm automation token
+```
+
+也支持环境变量：
+
+```powershell
+$env:NPM_TOKEN="你的 npm automation token"
+```
+
+不要提交 `.env.local`、npm token、VOC session token、模型 API key 或任何真实用户凭证。
+
+## 发布后验证
+
+确认 npm latest：
+
+```powershell
+npm view @vocmarket/voc-skill name version dist-tags.latest --registry=https://registry.npmjs.org/
+```
+
+线上安装 smoke：
+
+```powershell
+$test = Join-Path $env:TEMP ("vocmarket-online-smoke-" + [guid]::NewGuid())
+New-Item -ItemType Directory -Path $test | Out-Null
+Push-Location $test
+npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke
+Pop-Location
+```
+
+## npm 发布假失败处理
+
+有时 `npm publish` 已经返回成功，例如：
+
+```text
++ @vocmarket/voc-skill@0.3.15
+```
+
+但脚本紧接着执行 `npm view` 时，registry 还没同步完成，会短暂返回 404。
+
+处理方式：
+
+1. 等 20-60 秒后重新执行：
+
+```powershell
+npm view @vocmarket/voc-skill@0.3.15 version --registry=https://registry.npmjs.org/
+```
+
+2. 如果返回版本号，说明发布已经成功，不要重复发布同一个版本。
+3. 如果持续 404，再检查 npm 组织权限、token 权限和包名 scope。
+
+当前发布脚本已经把后置校验等待次数从 6 次增加到 12 次，减少这种假失败。
+
+## 当前发布记录
+
+- 2026-06-05：已发布 `@vocmarket/voc-skill@0.3.15`。
+- `npm view @vocmarket/voc-skill name version dist-tags.latest` 返回 `0.3.15`。
+- 线上 `npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke` 已通过。
+- 旧包 `@gangvy/claude-code-voc-intelligence@*` 已标记为 deprecated，安装旧包时会提示改用 `@vocmarket/voc-skill`。
+- 已新增 `npm run claude-voc:acceptance` 一键发布前验收，覆盖包级 smoke、MCP smoke、npm pack dry-run 和 workspace 安装断言。
+- 包内包含 8 个 skill、12 个 MCP tools。
+- smoke 覆盖 sample report、证据卡、图片缓存、xsec URL 规范化、偏好记忆、no-token 充值提示、祖先 `.env.local` token 读取、抖音搜索入参错误保护、跨行业样例和 MCP tool discovery。
+
+## 后续版本同步
+
+升级版本时同步修改：
+
+- `claude-code/claude-code-voc-intelligence/package.json`
+- `claude-code/claude-code-voc-intelligence/package-lock.json`
+- `claude-code/claude-code-voc-intelligence/skill-package-manifest.json`
+- `claude-code/claude-code-voc-intelligence/.claude-plugin/plugin.json`
+- 如涉及 MCP server 或记忆 schema，同步对应版本字段
+- `dist/npm/claude-code-voc-npm-package-manifest.json`
+- `dist/claude-code-voc-intelligence-suite-manifest.json`
+- `release/npm/claude-code-voc-intelligence/README.md`
+- `release/npm/claude-code-voc-intelligence/release-checklist.md`
 
-## 注意点
+## 体验原则
 
-- zip 包和 npm 包共用同一套源码，但验证脚本分开。
-- npm 包不要发布 `node_modules/`、`memory/`、`outputs/`、`.env`。
-- `install.js` 不强依赖 `package-lock.json`，因为 npm publish 后 package-lock 不一定随包安装。
-- 用户侧不要暴露 profile、output、collectionMode 这类参数；安装完成后仍然用自然语言启动。
-
+- 用户侧不要暴露 `profile`、`output`、`collectionMode` 等底层参数。
+- 用户用自然语言触发 VOC 采集、问题池、单点深挖、内容计划和口播脚本。
+- 第一轮真实采集只输出“初步判断 / 机会假设 / 待校准”，不要包装成最终结论。
+- 无 token、余额不足、业务权限未开通时，返回开通/充值引导，不直接暴露底层 403、余额接口或 stack trace。

package/install.js

@@ -111,6 +111,11 @@ function checkFiles() {
     'skills/voc-speaking-script/SKILL.md',
     'skills/voc-competitor-map/SKILL.md',
     'skills/voc-business-workflow/SKILL.md',
+    'skills/fmode-image-analysis/SKILL.md',
+    'skills/voc-api-catalog/SKILL.md',
+    'mcp/src/tools/fmode-image-analysis.js',
+    'mcp/src/tools/voc-api-catalog-run.js',
+    'mcp/catalog/voc-social-endpoints.json',
     'mcp/src/server.js'
   ].forEach(assertFile);
 

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

@@ -0,0 +1,143 @@
+{
+  "version": "1.0.0",
+  "updatedAt": "2026-06-21",
+  "gateway": {
+    "social": {
+      "baseUrl": "https://server.fmode.cn/api/voc-social",
+      "auth": "Authorization: Bearer <r: 开头的会话 token>",
+      "upstream": "TikHub (server.fmode.cn/thapi/v1)",
+      "billing": "每次转发调用扣除 1 次社交平台 API 额度（缓存命中也会计费）。",
+      "note": "这是一个通用转发网关：任意 proxyPath 都会被透传到上游 TikHub。本清单只列出已验证的常用接口；未列出的接口可以直接用 voc_api_call 传 rawPath + method + params 调用，无需改代码。",
+      "rawPathHint": "调用未在清单中的接口时，把上游的相对路径填到 voc_api_call 的 rawPath，例如 douyin/search/fetch_general_search_v2，并按上游文档拼 query/body。"
+    }
+  },
+  "platforms": [
+    { "key": "douyin", "label": "抖音", "status": "verified" },
+    { "key": "xiaohongshu", "label": "小红书", "status": "verified" },
+    { "key": "tiktok", "label": "TikTok", "status": "gateway_available" },
+    { "key": "youtube", "label": "YouTube", "status": "gateway_available" },
+    { "key": "twitter", "label": "Twitter/X", "status": "gateway_available" },
+    { "key": "instagram", "label": "Instagram", "status": "gateway_available" },
+    { "key": "linkedin", "label": "LinkedIn", "status": "gateway_available" }
+  ],
+  "endpoints": [
+    {
+      "id": "douyin.search_general",
+      "platform": "douyin",
+      "channel": "social",
+      "title": "抖音综合搜索",
+      "summary": "按关键词搜索抖音视频（综合搜索 v2）。任意行业/方向关键词均可用于趋势与 VOC 选题采集。",
+      "proxyPath": "douyin/search/fetch_general_search_v2",
+      "method": "POST",
+      "paramsIn": "body",
+      "params": [
+        { "name": "keyword", "in": "body", "type": "string", "required": true, "desc": "搜索关键词，任意行业/方向均可，例如 股权律师、医美 玻尿酸、少儿编程、新能源汽车。" },
+        { "name": "cursor", "in": "body", "type": "integer", "required": false, "default": 0, "desc": "分页游标，首页为 0，翻页用上一次返回的 cursor。" },
+        { "name": "sort_type", "in": "body", "type": "string", "required": false, "default": "0", "desc": "排序：0 综合，1 最多点赞，2 最新发布。" },
+        { "name": "publish_time", "in": "body", "type": "string", "required": false, "default": "0", "desc": "发布时间：0 不限，1 一天内，7 一周内，180 半年内。" },
+        { "name": "filter_duration", "in": "body", "type": "string", "required": false, "default": "0", "desc": "时长筛选：0 不限，0-1 一分钟内，1-5 一到五分钟，5-10000 五分钟以上。" },
+        { "name": "content_type", "in": "body", "type": "string", "required": false, "default": "0", "desc": "内容类型：0 不限，1 视频，2 图集，3 文章。" },
+        { "name": "search_id", "in": "body", "type": "string", "required": false, "default": "", "desc": "连续翻页时透传上一次返回的 search_id。" },
+        { "name": "backtrace", "in": "body", "type": "string", "required": false, "default": "", "desc": "连续翻页时透传上一次返回的 backtrace。" }
+      ],
+      "tags": ["抖音", "douyin", "搜索", "search", "视频", "关键词", "趋势", "voc"],
+      "billing": 1,
+      "responseHint": "返回视频列表，每条含 aweme_id、desc、统计字段等；aweme_id 可用于拉取评论。",
+      "example": { "keyword": "新能源汽车", "cursor": 0, "sort_type": "0" }
+    },
+    {
+      "id": "douyin.video_comments",
+      "platform": "douyin",
+      "channel": "social",
+      "title": "抖音视频评论列表",
+      "summary": "按 aweme_id 拉取某条抖音视频的评论，用于采集真实用户声音（VOC）。",
+      "proxyPath": "douyin/app/v3/fetch_video_comments",
+      "method": "GET",
+      "paramsIn": "query",
+      "params": [
+        { "name": "aweme_id", "in": "query", "type": "string", "required": true, "desc": "视频 ID，来自抖音综合搜索结果。" },
+        { "name": "cursor", "in": "query", "type": "integer", "required": false, "default": 0, "desc": "评论分页游标，首页 0。" },
+        { "name": "count", "in": "query", "type": "integer", "required": false, "default": 20, "desc": "每页评论数，建议 20。" }
+      ],
+      "tags": ["抖音", "douyin", "评论", "comments", "voc", "用户声音"],
+      "billing": 1,
+      "responseHint": "返回评论列表，含评论文本、点赞数、cid（用于拉取楼中楼回复）。",
+      "example": { "aweme_id": "7300000000000000000", "cursor": 0, "count": 20 }
+    },
+    {
+      "id": "douyin.comment_replies",
+      "platform": "douyin",
+      "channel": "social",
+      "title": "抖音评论回复（楼中楼）",
+      "summary": "按视频 item_id 和评论 comment_id 拉取某条评论下的回复。",
+      "proxyPath": "douyin/app/v3/fetch_video_comment_replies",
+      "method": "GET",
+      "paramsIn": "query",
+      "params": [
+        { "name": "item_id", "in": "query", "type": "string", "required": true, "desc": "视频 ID（同 aweme_id）。" },
+        { "name": "comment_id", "in": "query", "type": "string", "required": true, "desc": "父评论 ID（来自评论列表的 cid）。" },
+        { "name": "cursor", "in": "query", "type": "integer", "required": false, "default": 0, "desc": "回复分页游标。" },
+        { "name": "count", "in": "query", "type": "integer", "required": false, "default": 20, "desc": "每页回复数。" }
+      ],
+      "tags": ["抖音", "douyin", "评论", "回复", "replies", "voc"],
+      "billing": 1,
+      "responseHint": "返回某条父评论下的回复列表。",
+      "example": { "item_id": "7300000000000000000", "comment_id": "7300000000000000001", "cursor": 0, "count": 20 }
+    },
+    {
+      "id": "xiaohongshu.search_notes",
+      "platform": "xiaohongshu",
+      "channel": "social",
+      "title": "小红书笔记搜索",
+      "summary": "按关键词搜索小红书笔记，任意行业/方向均可，用于趋势与 VOC 选题采集。",
+      "proxyPath": "xiaohongshu/app/search_notes",
+      "method": "GET",
+      "paramsIn": "query",
+      "params": [
+        { "name": "keyword", "in": "query", "type": "string", "required": true, "desc": "搜索关键词，任意行业/方向均可。" },
+        { "name": "page", "in": "query", "type": "integer", "required": false, "default": 1, "desc": "页码，从 1 开始。" },
+        { "name": "sort", "in": "query", "type": "string", "required": false, "default": "popularity_descending", "desc": "排序：general 综合，time_descending 最新，popularity_descending 最热。" },
+        { "name": "note_type", "in": "query", "type": "string", "required": false, "default": "_0", "desc": "笔记类型：_0 不限，_1 视频，_2 图文。" }
+      ],
+      "tags": ["小红书", "xiaohongshu", "xhs", "搜索", "search", "笔记", "关键词", "趋势", "voc"],
+      "billing": 1,
+      "responseHint": "返回笔记列表，每条含 note_id，可用于拉取详情和评论。",
+      "example": { "keyword": "敏感肌护肤", "page": 1, "sort": "popularity_descending", "note_type": "_0" }
+    },
+    {
+      "id": "xiaohongshu.note_detail",
+      "platform": "xiaohongshu",
+      "channel": "social",
+      "title": "小红书笔记详情",
+      "summary": "按 note_id 拉取小红书笔记详情（正文、图片、统计等）。",
+      "proxyPath": "xiaohongshu/app/get_note_info",
+      "method": "GET",
+      "paramsIn": "query",
+      "params": [
+        { "name": "note_id", "in": "query", "type": "string", "required": true, "desc": "笔记 ID，来自搜索结果。" }
+      ],
+      "tags": ["小红书", "xiaohongshu", "xhs", "笔记", "详情", "note"],
+      "billing": 1,
+      "responseHint": "返回单条笔记的完整内容。",
+      "example": { "note_id": "650000000000000000000000" }
+    },
+    {
+      "id": "xiaohongshu.note_comments",
+      "platform": "xiaohongshu",
+      "channel": "social",
+      "title": "小红书笔记评论",
+      "summary": "按 note_id 拉取小红书笔记评论，用于采集真实用户声音（VOC）。",
+      "proxyPath": "xiaohongshu/app/get_note_comments",
+      "method": "GET",
+      "paramsIn": "query",
+      "params": [
+        { "name": "note_id", "in": "query", "type": "string", "required": true, "desc": "笔记 ID，来自搜索结果。" },
+        { "name": "cursor", "in": "query", "type": "string", "required": false, "default": "", "desc": "评论分页游标，翻页用上一次返回的 cursor。" }
+      ],
+      "tags": ["小红书", "xiaohongshu", "xhs", "评论", "comments", "voc", "用户声音"],
+      "billing": 1,
+      "responseHint": "返回笔记评论列表。",
+      "example": { "note_id": "650000000000000000000000", "cursor": "" }
+    }
+  ]
+}