SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。"
    },
    "sort_type": {
      "enum": [
        "default",
        "time_descending",
        "like_count_descending"
      ],
      "type": "string",
      "default": "default",
      "description": "评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）"
    },
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_url"
  ],
  "properties": {
    "note_url": {
      "type": "string",
      "description": "小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。"
    },
    "sort_type": {
      "enum": [
        "default",
        "time_descending",
        "like_count_descending"
      ],
      "type": "string",
      "default": "default",
      "description": "评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）"
    },
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_url"
  ],
  "properties": {
    "note_url": {
      "type": "string",
      "description": "小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "minLength": 1,
      "description": "小红书笔记 ID。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_url"
  ],
  "properties": {
    "note_url": {
      "type": "string",
      "minLength": 1,
      "description": "小红书笔记页面链接、短链接或包含链接的分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id",
    "comment_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。"
    },
    "comment_id": {
      "type": "string",
      "description": "一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要传二级评论项自身的 comment_id。"
    },
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "sku_id"
  ],
  "properties": {
    "sku_id": {
      "type": "string",
      "description": "小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "小红书商品详情链接、短链接或包含商品链接的完整分享文案。不支持笔记链接、博主主页链接、纯分享口令或搜索词。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "review_id"
  ],
  "properties": {
    "review_id": {
      "type": "string",
      "description": "一级商品评价 ID。用户已提供时原样使用；否则从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不要传 root_review_id。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "review_id"
  ],
  "properties": {
    "review_id": {
      "type": "string",
      "description": "商品评价回复 ID。用户已提供时原样使用；否则从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不要传 root_review_id。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "sku_id"
  ],
  "properties": {
    "sku_id": {
      "type": "string",
      "description": "小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。"
    },
    "has_image": {
      "type": "boolean",
      "default": false,
      "description": "是否只返回带图片的商品评价"
    },
    "sort_type": {
      "enum": [
        "general",
        "time_descending"
      ],
      "type": "string",
      "default": "general",
      "description": "商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先）"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "share_text"
  ],
  "properties": {
    "share_text": {
      "type": "string",
      "minLength": 1,
      "description": "小红书笔记分享短链接，或包含该链接的完整分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "page_id"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "小红书标签页 page_id。"
    },
    "sort_type": {
      "enum": [
        "hot",
        "time_descending"
      ],
      "type": "string",
      "default": "hot",
      "description": "标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "topic_url"
  ],
  "properties": {
    "sort_type": {
      "enum": [
        "hot",
        "time_descending"
      ],
      "type": "string",
      "default": "hot",
      "description": "标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）"
    },
    "topic_url": {
      "type": "string",
      "description": "小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "encrypted_user_id"
  ],
  "properties": {
    "encrypted_user_id": {
      "type": "string",
      "description": "小红书加密用户 ID。用户已提供时直接原样使用；请传入完整 29 位小写十六进制值；不要传 24 位 user_id、小红书号、昵称或主页链接"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "profile_url": {
      "type": "string",
      "description": "小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "小红书用户 user_id。用户已提供时原样使用，支持完整的 24 位或 29 位小写十六进制 ID，无需先转换；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；续页须保持首屏的输入用户 ID 不变，即使对应同一用户，也不能换成结果返回的另一种 ID；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    },
    "profile_url": {
      "type": "string",
      "description": "小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "小红书用户 user_id。用户已提供时原样使用，支持完整的 24 位或 29 位小写十六进制 ID，无需先转换；否则可从笔记搜索、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表结果中的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称。"
    },
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；续页须保持首屏的输入用户 ID 不变，即使对应同一用户，也不能换成结果返回的另一种 ID；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用提交工具返回的 job_id；不要传 note_id 或笔记链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    },
    "note_scope": {
      "enum": [
        "daily",
        "cooperation"
      ],
      "type": "string",
      "default": "daily",
      "description": "笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    },
    "note_scope": {
      "enum": [
        "daily",
        "cooperation"
      ],
      "type": "string",
      "default": "daily",
      "description": "笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    },
    "note_scope": {
      "enum": [
        "daily",
        "cooperation"
      ],
      "type": "string",
      "default": "daily",
      "description": "笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{24}$",
      "description": "小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_url"
  ],
  "properties": {
    "note_url": {
      "type": "string",
      "description": "小红书笔记链接、短链接或分享文案。支持小红书笔记长链接、xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接，以及包含上述链接的完整分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。"
    },
    "note_type": {
      "enum": [
        "all",
        "image",
        "video"
      ],
      "type": "string",
      "default": "all",
      "description": "笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频）"
    },
    "sort_type": {
      "enum": [
        "general",
        "time_descending",
        "like_count_descending",
        "comment_count_descending",
        "collect_count_descending"
      ],
      "type": "string",
      "default": "general",
      "description": "笔记搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先）"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "笔记搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。"
    },
    "publish_time_range": {
      "enum": [
        "all",
        "day",
        "week",
        "half_year"
      ],
      "type": "string",
      "default": "all",
      "description": "发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "string",
      "description": "note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "note_url"
  ],
  "properties": {
    "note_url": {
      "type": "string",
      "description": "小红书视频笔记链接、短链接或分享文案。"
    }
  },
  "additionalProperties": false
}