openclaw-voc-skill/openclaw-skills/xiaohongshu/xiaohongshu-note-comments/api-config.json

{
  "name": "xiaohongshu-note-comments",
  "displayName": "小红书笔记评论",
  "description": "根据 note_id 批量抓取小红书笔记评论（完整评论文本、用户、点赞数、时间、回复数），支持翻页。中国市场 VOC 分析的核心数据源。",
  "category": "xiaohongshu",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/xiaohongshu/app/get_note_comments",
    "headers": {
      "Authorization": "Bearer gqsZHfMWgAiMwV+ITbmZy0qALADWBZVS7QnV7kKJe9CwzgWgJG+7bwK+GQ==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "note_id"
    ],
    "properties": {
      "note_id": {
        "type": "string",
        "description": "小红书笔记 ID（24 位十六进制），从 xiaohongshu-search-notes 获取"
      },
      "cursor": {
        "type": "string",
        "description": "翻页游标。首次请求留空，翻页时使用上次响应的 data.cursor",
        "default": ""
      }
    }
  },
  "requestTransform": {
    "query": {
      "note_id": "{{note_id}}",
      "cursor": "{{cursor}}"
    }
  },
  "response": {
    "type": "object",
    "description": "评论列表（按热度排序，双层 data 包装，每次约 10 条）",
    "note": "cursor 字段是 JSON 字符串（如 '{\"cursor\":\"69a426900..\"}'），翻页时原样传回。",
    "keyFields": {
      "data.code": "HTTP 状态码（外层）",
      "data.data.code": "业务状态码（0=成功）",
      "data.data.success": "布尔成功标志",
      "data.data.has_more": "是否还有更多评论（翻页终止条件）",
      "data.data.cursor": "下一页游标（JSON 字符串），翻页时作为 cursor 参数原样传回",
      "data.data.comments[]": "评论列表（按热度排序，每页约 10 条）",
      "data.data.comments[].id": "评论唯一 ID",
      "data.data.comments[].content": "评论正文（VOC 核心数据 — NLP 聚类的原始输入）",
      "data.data.comments[].create_time": "评论时间戳（毫秒）",
      "data.data.comments[].like_count": "评论获赞数（高赞 = 共识，加权过滤）",
      "data.data.comments[].sub_comment_count": "子评论/回复数",
      "data.data.comments[].user_info.user_id": "评论者 ID",
      "data.data.comments[].user_info.nickname": "评论者昵称",
      "data.data.comments[].user_info.image": "评论者头像",
      "data.data.comments[].ip_location": "评论 IP 地域（地域分布洞察）",
      "data.data.comments[].sub_comments[]": "热门子评论列表（作者/其他用户的回复）"
    }
  },
  "workflow": {
    "description": "推荐调用链",
    "steps": [
      "1. xiaohongshu-search-notes(keyword) → 发现高评论笔记",
      "2. xiaohongshu-note-comments(note_id) ← 本 skill，批量抓评论",
      "3. （翻页）xiaohongshu-note-comments(note_id, cursor=上次的 data.cursor) → 直到 has_more=false",
      "4. 下游 NLP 聚类：痛点/亮点/场景/人群"
    ]
  },
  "usageExamples": [
    {
      "name": "爆款笔记评论采集",
      "input": {
        "note_id": "665f95200000000006005624"
      },
      "description": "首次请求，抓取第一页评论（约 10-20 条，按热度排序）"
    },
    {
      "name": "评论翻页",
      "input": {
        "note_id": "665f95200000000006005624",
        "cursor": "65ab1234567890abcdef"
      },
      "description": "根据上次响应的 data.cursor 继续翻页"
    }
  ],
  "reportMapping": {
    "slides": [
      "小红书用户 VOC 原声",
      "小红书用户痛点聚类",
      "小红书使用场景洞察"
    ],
    "dataPoints": [
      "用户真实评论文本",
      "高赞评论（共识指标）",
      "子评论讨论热点",
      "评论 IP 地域分布",
      "用户表达关键词"
    ]
  },
  "timeout": 60000,
  "retry": {
    "maxAttempts": 3,
    "delay": 2000,
    "backoffMultiplier": 2,
    "retryOn": [400, 429, 500, 502, 503, 504]
  },
  "notes": "本 skill 使用共享社媒数据订阅（/thapi/ 网关），不经过 APIG 计费。评论按热度排序，单次返回约 10-20 条。"
}