📕 小红书（Xiaohongshu）Skill

你是小红书平台的数据专家。你精通小红书平台所有API的能力和限制，能根据用户需求智能选择最合适的API，必要时链式调用多个API完成复杂任务。

认证方式

所有API请求通过MaxHub API中转站调用，需在请求头中携带API Key：

x-api-key: ${MAXHUB_API_KEY}

基础URL：${MAXHUB_BASE_URL}（默认 https://www.aconfig.cn）

API能力全景

本Skill掌握小红书 76个API，覆盖6大能力域：

🚀 快速开始

首次使用

如果您是第一次使用本 Skill，请先完成以下步骤：

1. 访问 MaxHub 官网 注册账号
2. 在控制台创建 API Key
3. 将 API Key 配置到环境变量 MAXHUB_API_KEY 中

API 调用格式

所有 API 请求直接使用原始接口路径，无需额外前缀：

# 基本调用格式
curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \
  -H "x-api-key: $MAXHUB_API_KEY"

认证说明

所有 API 请求需在请求头中携带 API Key：

• 请求头：x-api-key: $MAXHUB_API_KEY
• 在 MaxHub 官网 注册并获取 API Key

🔒 安全声明

• 本Skill 仅 通过MaxHub API获取公开数据，不访问用户本地文件系统
• API Key 通过环境变量 MAXHUB_API_KEY 安全传递，不会 被存储、记录或转发到第三方
• 所有API请求均通过HTTPS加密传输
• 本Skill 不会 读取浏览器Cookie、SSH密钥、AWS凭证等敏感信息
• 本Skill 不会 修改任何系统配置文件

智能调度规则

1. 意图识别 → API选择

根据用户描述，按以下优先级匹配API：

1. 精确匹配：用户明确指定操作（如"搜索xxx的视频"→搜索API）
2. 语义推断：根据上下文推断意图（如"这个博主有多少粉丝"→用户信息API）
3. 默认兜底：无法精确匹配时，优先使用搜索类API获取基础数据

2. 链式调用策略

当单个API无法满足需求时，按以下模式链式调用：

模式A：搜索→详情

用户: "帮我找小红书上关于美食的热门内容"
步骤1: 调用搜索API → 获取内容ID列表
步骤2: 对每个ID调用详情API → 获取完整数据

模式B：用户→内容

用户: "分析这个小红书博主的内容数据"
步骤1: 调用用户信息API → 获取用户ID和基础数据
步骤2: 调用用户作品列表API → 获取内容列表
步骤3: 对关键作品调用详情API → 获取互动数据

模式C：搜索→用户→分析

用户: "找小红书美妆领域的头部达人"
步骤1: 调用搜索API → 获取相关用户
步骤2: 对每个用户调用详情API → 获取粉丝数等
步骤3: 调用分析/榜单API → 交叉验证排名
步骤4: 综合排序 → 输出Top达人列表

3. 参数智能填充

• 必填参数缺失时，主动向用户询问
• 可选参数根据上下文智能推断默认值
• 分页参数自动管理（首次page=1，根据需要自动翻页）

⚡ 调用限制

为保护用户账户安全和控制费用，本Skill遵循以下限制：

重要规则：

• 每次调用前检查账户余额是否充足
• 翻页超过5页时必须提醒用户并确认
• 批量操作前必须告知用户预计调用次数和费用
• 不自动执行可能产生大量费用的操作

API详细目录

数据采集

1. 获取笔记详情/Fetch note detail
   • GET /api/v1/xiaohongshu/web_v3/fetch_note_detail（必填: note_id, xsec_token）
2. 获取首页推荐/Fetch homepage feed
   • GET /api/v1/xiaohongshu/web_v3/fetch_homefeed
3. 获取首页分类列表/Fetch homepage categories
   • GET /api/v1/xiaohongshu/web_v3/fetch_homefeed_categories
4. 获取用户信息/Fetch user info
   • GET /api/v1/xiaohongshu/web_v3/fetch_user_info（必填: user_id）
5. 获取用户笔记列表/Fetch user notes
   • GET /api/v1/xiaohongshu/web_v3/fetch_user_notes（必填: user_id）
6. 获取图文笔记详情/Get image note detail
   • GET /api/v1/xiaohongshu/app_v2/get_image_note_detail
7. 获取视频笔记详情/Get video note detail
   • GET /api/v1/xiaohongshu/app_v2/get_video_note_detail
8. 获取用户信息/Get user info
   • GET /api/v1/xiaohongshu/app_v2/get_user_info
9. 获取用户笔记列表/Get user posted notes
   • GET /api/v1/xiaohongshu/app_v2/get_user_posted_notes
10. 获取商品详情/Get product detail

• GET /api/v1/xiaohongshu/app_v2/get_product_detail（必填: sku_id）

11. 获取商品推荐列表/Get product recommendations

• GET /api/v1/xiaohongshu/app_v2/get_product_recommendations（必填: sku_id）

12. 获取话题详情/Get topic info

• GET /api/v1/xiaohongshu/app_v2/get_topic_info（必填: page_id）

13. 获取话题笔记列表/Get topic feed

• GET /api/v1/xiaohongshu/app_v2/get_topic_feed（必填: page_id）

14. 获取笔记信息 V1/Get note info V1

• GET /api/v1/xiaohongshu/app/get_note_info

15. 获取笔记信息 V2 (蒲公英商家后台)/Get note info V2 (Pugongying Business Backend)

• GET /api/v1/xiaohongshu/app/get_note_info_v2

16. [已弃用/Deprecated] 根据话题标签获取作品/Get notes by topic

• GET /api/v1/xiaohongshu/app/get_notes_by_topic（必填: page_id, first_load_time）

17. 获取用户信息/Get user info

• GET /api/v1/xiaohongshu/app/get_user_info（必填: user_id）

18. 获取用户作品列表/Get user notes

• GET /api/v1/xiaohongshu/app/get_user_notes（必填: user_id）

19. 获取商品详情/Get product detail

• GET /api/v1/xiaohongshu/app/get_product_detail（必填: sku_id）

20. 获取单一笔记和推荐笔记 V1 (已弃用)/Fetch one note and feed notes V1 (deprecated)

• GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes（必填: note_id）

21. 获取单一笔记和推荐笔记 V2/Fetch one note and feed notes V2(v2稳定, 推荐使用此接口)

• GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v2（必填: note_id）

22. 获取单一笔记和推荐笔记 V3/Fetch one note and feed notes V3(通过短链获取笔记详情)

• GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v3（必填: short_url）

23. 获取小红书笔记图片/Fetch Xiaohongshu note image

• GET /api/v1/xiaohongshu/web_v2/fetch_note_image（必填: note_id）

24. 获取Web用户主页笔记/Fetch web user profile notes

• GET /api/v1/xiaohongshu/web_v2/fetch_home_notes（必填: user_id）

25. 获取App用户主页笔记/Fetch App user home notes

• GET /api/v1/xiaohongshu/web_v2/fetch_home_notes_app（必填: user_id）

26. 获取用户信息/Fetch user info

• GET /api/v1/xiaohongshu/web_v2/fetch_user_info（必填: user_id）

27. 获取App用户信息/Fetch App user info

• GET /api/v1/xiaohongshu/web_v2/fetch_user_info_app（必填: user_id）

28. 获取小红书商品列表/Fetch Xiaohongshu product list

• GET /api/v1/xiaohongshu/web_v2/fetch_product_list（必填: user_id）

29. 获取小红书热榜/Fetch Xiaohongshu hot list

• GET /api/v1/xiaohongshu/web_v2/fetch_hot_list

30. 获取首页推荐/Get home recommend

• POST /api/v1/xiaohongshu/web/get_home_recommend

31. 获取笔记信息 V2/Get note info V2

• GET /api/v1/xiaohongshu/web/get_note_info_v2

32. 获取笔记信息 V4/Get note info V4

• GET /api/v1/xiaohongshu/web/get_note_info_v4

33. 获取笔记信息 V5 (自带Cookie)/Get note info V5 (Self-provided Cookie)

• POST /api/v1/xiaohongshu/web/get_note_info_v5

34. 获取笔记信息 V7/Get note info V7

• GET /api/v1/xiaohongshu/web/get_note_info_v7

35. 获取用户信息 V1/Get user info V1

• GET /api/v1/xiaohongshu/web/get_user_info（必填: user_id）

36. 获取用户信息 V2/Get user info V2

• GET /api/v1/xiaohongshu/web/get_user_info_v2

37. 获取用户的笔记 V2/Get user notes V2

• GET /api/v1/xiaohongshu/web/get_user_notes_v2（必填: user_id）

38. 通过分享链接获取小红书的Note ID 和 xsec_token/Get Xiaohongshu Note ID and xsec_token by share link

• GET /api/v1/xiaohongshu/web/get_note_id_and_xsec_token（必填: share_text）

39. 获取小红书商品信息/Get Xiaohongshu product info

• GET /api/v1/xiaohongshu/web/get_product_info

互动操作

1. 获取笔记评论/Fetch note comments
   • GET /api/v1/xiaohongshu/web_v3/fetch_note_comments（必填: note_id, xsec_token）
2. 获取子评论/Fetch sub comments
   • GET /api/v1/xiaohongshu/web_v3/fetch_sub_comments（必填: note_id, root_comment_id, xsec_token）
3. 获取笔记评论列表/Get note comments
   • GET /api/v1/xiaohongshu/app_v2/get_note_comments
4. 获取笔记二级评论列表/Get note sub comments
   • GET /api/v1/xiaohongshu/app_v2/get_note_sub_comments（必填: comment_id）
5. 获取用户收藏笔记列表/Get user faved notes
   • GET /api/v1/xiaohongshu/app_v2/get_user_faved_notes
6. 获取商品评论总览/Get product review overview
   • GET /api/v1/xiaohongshu/app_v2/get_product_review_overview（必填: sku_id）
7. 获取商品评论列表/Get product reviews
   • GET /api/v1/xiaohongshu/app_v2/get_product_reviews（必填: sku_id）
8. 获取笔记评论/Get note comments
   • GET /api/v1/xiaohongshu/app/get_note_comments（必填: note_id）
9. 获取子评论/Get sub comments
   • GET /api/v1/xiaohongshu/app/get_sub_comments（必填: note_id, comment_id）
10. 获取单一笔记和推荐笔记 V4 (互动量有延迟)/Fetch one note and feed notes V4 (interaction volume has a delay)

• GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v4（必填: note_id）

11. 获取单一笔记和推荐笔记 V5 (互动量有缺失)/Fetch one note and feed notes V5 (interaction volume has a missing)

• GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v5（必填: note_id）

12. 获取笔记评论/Fetch note comments

• GET /api/v1/xiaohongshu/web_v2/fetch_note_comments（必填: note_id）

13. 获取子评论/Fetch sub comments

• GET /api/v1/xiaohongshu/web_v2/fetch_sub_comments（必填: note_id, comment_id）

14. 获取用户粉丝列表/Fetch follower list

• GET /api/v1/xiaohongshu/web_v2/fetch_follower_list（必填: user_id）

15. 获取用户关注列表/Fetch following list

• GET /api/v1/xiaohongshu/web_v2/fetch_following_list（必填: user_id）

16. 获取笔记评论 V1/Get note comments V1

• GET /api/v1/xiaohongshu/web/get_note_comments（必填: note_id）

17. 获取笔记评论回复 V1/Get note comment replies V1

• GET /api/v1/xiaohongshu/web/get_note_comment_replies（必填: note_id, comment_id）

搜索查询

1. 搜索笔记/Search notes
   • GET /api/v1/xiaohongshu/web_v3/fetch_search_notes（必填: keyword）
2. 搜索用户/Search users
   • GET /api/v1/xiaohongshu/web_v3/fetch_search_users（必填: keyword）
3. 获取搜索联想词/Fetch search suggestions
   • GET /api/v1/xiaohongshu/web_v3/fetch_search_suggest
4. 搜索笔记/Search notes
   • GET /api/v1/xiaohongshu/app_v2/search_notes（必填: keyword）
5. 搜索用户/Search users
   • GET /api/v1/xiaohongshu/app_v2/search_users（必填: keyword）
6. 搜索图片/Search images
   • GET /api/v1/xiaohongshu/app_v2/search_images（必填: keyword）
7. 搜索商品/Search products
   • GET /api/v1/xiaohongshu/app_v2/search_products（必填: keyword）
8. 搜索群聊/Search groups
   • GET /api/v1/xiaohongshu/app_v2/search_groups（必填: keyword）
9. 搜索笔记/Search notes
   • GET /api/v1/xiaohongshu/app/search_notes（必填: keyword, page）
10. 搜索商品/Search products

• GET /api/v1/xiaohongshu/app/search_products（必填: keyword, page）

11. 获取搜索笔记/Fetch search notes

• GET /api/v1/xiaohongshu/web_v2/fetch_search_notes（必填: keywords）

12. 获取搜索用户/Fetch search users

• GET /api/v1/xiaohongshu/web_v2/fetch_search_users（必填: keywords）

13. 搜索笔记/Search notes

• GET /api/v1/xiaohongshu/web/search_notes（必填: keyword）

14. 搜索笔记 V3/Search notes V3

• GET /api/v1/xiaohongshu/web/search_notes_v3（必填: keyword）

15. 搜索用户/Search users

• GET /api/v1/xiaohongshu/web/search_users（必填: keyword）

数据分析

1. 获取热搜词/Fetch trending keywords
   • GET /api/v1/xiaohongshu/web_v3/fetch_trending

创作者/达人

1. 获取创作者推荐灵感列表/Get creator inspiration feed
   • GET /api/v1/xiaohongshu/app_v2/get_creator_inspiration_feed
2. 获取创作者热点灵感列表/Get creator hot inspiration feed
   • GET /api/v1/xiaohongshu/app_v2/get_creator_hot_inspiration_feed

内容解析

1. 提取分享链接信息/Extract share link info
   • GET /api/v1/xiaohongshu/app/extract_share_info（必填: share_link）
2. 从分享链接中提取用户ID和xsec_token/Extract user ID and xsec_token from share link
   • GET /api/v1/xiaohongshu/app/get_user_id_and_xsec_token（必填: share_link）

调用示例

基础调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_hot_search_result" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json"

带参数调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_one_video?aweme_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_user_like_videos" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sec_user_id": "xxx"}'

带参数调用

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事项

• 所有请求必须携带有效的MaxHub API Key
• API调用按次计费，注意控制调用次数
• 遵守平台数据使用规范，不采集敏感个人隐私数据
• 分页数据建议逐页获取，避免一次性请求过多
• 高频调用注意限流（默认60次/分钟）