← 返回 Skills 市场
xiewxx

maxhub-xiaohongshu

作者 Xie Hao · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
23
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install maxhub-xiaohongshu
功能描述
小红书/Xiaohongshu平台小红书笔记搜索、用户分析与种草数据采集。当用户提到小红书、xiaohongshu、red、种草、笔记等相关需求时激活此Skill。
使用说明 (SKILL.md)

📕 小红书（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大能力域：

能力域 API数量 核心能力
数据采集 39 获取用户笔记列表/Fetch user 、获取首页推荐/Fetch homepag、获取笔记详情/Fetch note de
互动操作 17 获取笔记二级评论列表/Get note 、获取笔记评论/Fetch note co、获取用户收藏笔记列表/Get user
搜索查询 15 搜索笔记/Search notes、获取搜索联想词/Fetch search、搜索用户/Search users
数据分析 1 获取热搜词/Fetch trending
创作者/达人 2 获取创作者热点灵感列表/Get crea、获取创作者推荐灵感列表/Get crea
内容解析 2 从分享链接中提取用户ID和xsec_to、提取分享链接信息/Extract sha

🚀 快速开始

首次使用

如果您是第一次使用本 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页 防止意外大量调用
单次最大返回条数 50条 控制数据量
链式调用最大深度 3层 防止无限递归
批量操作最大数量 10条 控制批量大小
费用提醒阈值 连续调用超过20次时提醒 避免意外消耗余额

重要规则：

  • 每次调用前检查账户余额是否充足
  • 翻页超过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）
  1. 获取商品推荐列表/Get product recommendations
  • GET /api/v1/xiaohongshu/app_v2/get_product_recommendations（必填: sku_id）
  1. 获取话题详情/Get topic info
  • GET /api/v1/xiaohongshu/app_v2/get_topic_info（必填: page_id）
  1. 获取话题笔记列表/Get topic feed
  • GET /api/v1/xiaohongshu/app_v2/get_topic_feed（必填: page_id）
  1. 获取笔记信息 V1/Get note info V1
  • GET /api/v1/xiaohongshu/app/get_note_info
  1. 获取笔记信息 V2 (蒲公英商家后台)/Get note info V2 (Pugongying Business Backend)
  • GET /api/v1/xiaohongshu/app/get_note_info_v2
  1. [已弃用/Deprecated] 根据话题标签获取作品/Get notes by topic
  • GET /api/v1/xiaohongshu/app/get_notes_by_topic（必填: page_id, first_load_time）
  1. 获取用户信息/Get user info
  • GET /api/v1/xiaohongshu/app/get_user_info（必填: user_id）
  1. 获取用户作品列表/Get user notes
  • GET /api/v1/xiaohongshu/app/get_user_notes（必填: user_id）
  1. 获取商品详情/Get product detail
  • GET /api/v1/xiaohongshu/app/get_product_detail（必填: sku_id）
  1. 获取单一笔记和推荐笔记 V1 (已弃用)/Fetch one note and feed notes V1 (deprecated)
  • GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes（必填: note_id）
  1. 获取单一笔记和推荐笔记 V2/Fetch one note and feed notes V2(v2稳定, 推荐使用此接口)
  • GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v2（必填: note_id）
  1. 获取单一笔记和推荐笔记 V3/Fetch one note and feed notes V3(通过短链获取笔记详情)
  • GET /api/v1/xiaohongshu/web_v2/fetch_feed_notes_v3（必填: short_url）
  1. 获取小红书笔记图片/Fetch Xiaohongshu note image
  • GET /api/v1/xiaohongshu/web_v2/fetch_note_image（必填: note_id）
  1. 获取Web用户主页笔记/Fetch web user profile notes
  • GET /api/v1/xiaohongshu/web_v2/fetch_home_notes（必填: user_id）
  1. 获取App用户主页笔记/Fetch App user home notes
  • GET /api/v1/xiaohongshu/web_v2/fetch_home_notes_app（必填: user_id）
  1. 获取用户信息/Fetch user info
  • GET /api/v1/xiaohongshu/web_v2/fetch_user_info（必填: user_id）
  1. 获取App用户信息/Fetch App user info
  • GET /api/v1/xiaohongshu/web_v2/fetch_user_info_app（必填: user_id）
  1. 获取小红书商品列表/Fetch Xiaohongshu product list
  • GET /api/v1/xiaohongshu/web_v2/fetch_product_list（必填: user_id）
  1. 获取小红书热榜/Fetch Xiaohongshu hot list
  • GET /api/v1/xiaohongshu/web_v2/fetch_hot_list
  1. 获取首页推荐/Get home recommend
  • POST /api/v1/xiaohongshu/web/get_home_recommend
  1. 获取笔记信息 V2/Get note info V2
  • GET /api/v1/xiaohongshu/web/get_note_info_v2
  1. 获取笔记信息 V4/Get note info V4
  • GET /api/v1/xiaohongshu/web/get_note_info_v4
  1. 获取笔记信息 V5 (自带Cookie)/Get note info V5 (Self-provided Cookie)
  • POST /api/v1/xiaohongshu/web/get_note_info_v5
  1. 获取笔记信息 V7/Get note info V7
  • GET /api/v1/xiaohongshu/web/get_note_info_v7
  1. 获取用户信息 V1/Get user info V1
  • GET /api/v1/xiaohongshu/web/get_user_info（必填: user_id）
  1. 获取用户信息 V2/Get user info V2
  • GET /api/v1/xiaohongshu/web/get_user_info_v2
  1. 获取用户的笔记 V2/Get user notes V2
  • GET /api/v1/xiaohongshu/web/get_user_notes_v2（必填: user_id）
  1. 通过分享链接获取小红书的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）
  1. 获取小红书商品信息/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）
  1. 获取单一笔记和推荐笔记 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）
  1. 获取笔记评论/Fetch note comments
  • GET /api/v1/xiaohongshu/web_v2/fetch_note_comments（必填: note_id）
  1. 获取子评论/Fetch sub comments
  • GET /api/v1/xiaohongshu/web_v2/fetch_sub_comments（必填: note_id, comment_id）
  1. 获取用户粉丝列表/Fetch follower list
  • GET /api/v1/xiaohongshu/web_v2/fetch_follower_list（必填: user_id）
  1. 获取用户关注列表/Fetch following list
  • GET /api/v1/xiaohongshu/web_v2/fetch_following_list（必填: user_id）
  1. 获取笔记评论 V1/Get note comments V1
  • GET /api/v1/xiaohongshu/web/get_note_comments（必填: note_id）
  1. 获取笔记评论回复 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）
  1. 获取搜索笔记/Fetch search notes
  • GET /api/v1/xiaohongshu/web_v2/fetch_search_notes（必填: keywords）
  1. 获取搜索用户/Fetch search users
  • GET /api/v1/xiaohongshu/web_v2/fetch_search_users（必填: keywords）
  1. 搜索笔记/Search notes
  • GET /api/v1/xiaohongshu/web/search_notes（必填: keyword）
  1. 搜索笔记 V3/Search notes V3
  • GET /api/v1/xiaohongshu/web/search_notes_v3（必填: keyword）
  1. 搜索用户/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次/分钟）
安全使用建议
Review this skill before installing. Use it only if you trust MaxHub and are comfortable with its Xiaohongshu API surface. Keep `MAXHUB_BASE_URL` on a trusted HTTPS endpoint, use a dedicated API key, monitor costs, and avoid the signing or cookie-backed endpoints unless the maintainer clearly explains and scopes them.
功能分析
Type: OpenClaw Skill Name: maxhub-xiaohongshu Version: 1.0.0 The skill bundle is a comprehensive integration for the MaxHub API (aconfig.cn) to perform data collection and analysis on the Xiaohongshu platform. It contains detailed instructions for an AI agent to handle search, user analysis, and content parsing through a centralized API proxy. While there is a minor documentation inconsistency in SKILL.md (referencing Douyin in examples), the code logic and instructions are focused on legitimate data retrieval, include explicit security constraints against local file access, and lack any indicators of data exfiltration, persistence, or malicious execution.
能力标签
requires-sensitive-credentials
能力评估
⚠ Purpose & Capability
Searching and analyzing Xiaohongshu data is coherent with the stated purpose, but the included API catalog lists a Xiaohongshu web signing endpoint and a cookie-backed note endpoint, which is broader than the stated public-data/no-cookie/no-bypass posture.
ℹ Instruction Scope
The agent is instructed to choose among many APIs and chain calls, but the skill also discloses limits for pagination, batch size, chain depth, and cost confirmation.
✓ Install Mechanism
This is an instruction-only skill with no install spec, no binaries, and no code files; there is no executable installer behavior in the provided artifacts.
ℹ Credentials
The skill requires a MaxHub API key and sends requests to a configured MaxHub base URL, which is expected for its purpose, but users should ensure the base URL is trusted and HTTPS.
✓ Persistence & Privilege
The artifacts state that the skill does not access the local filesystem, browser sessions, SSH/AWS credentials, or system configuration, and no persistence mechanism is provided.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install maxhub-xiaohongshu
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /maxhub-xiaohongshu 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Skill renamed from "maxhub-reddit" (Reddit support) to "maxhub-xiaohongshu" and now provides Xiaohongshu (小红书) platform data search and analysis. - Replaced all Reddit-related features with Xiaohongshu-specific functions, supporting note search, user analysis, data extraction, and more. - Substantially expanded API coverage: supports 76 Xiaohongshu APIs across 6 functional domains, including data collection, interaction, search, analytics, creator, and content parsing. - Updated activation logic and documentation to trigger only for Xiaohongshu-related queries. - Maintained MaxHub API key-based security and operational best practices.
元数据
Slug maxhub-xiaohongshu
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

maxhub-xiaohongshu 是什么？

小红书/Xiaohongshu平台小红书笔记搜索、用户分析与种草数据采集。当用户提到小红书、xiaohongshu、red、种草、笔记等相关需求时激活此Skill。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 23 次。

如何安装 maxhub-xiaohongshu？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install maxhub-xiaohongshu」即可一键安装，无需额外配置。

maxhub-xiaohongshu 是免费的吗？

是的，maxhub-xiaohongshu 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

maxhub-xiaohongshu 支持哪些平台？

maxhub-xiaohongshu 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 maxhub-xiaohongshu？

由 Xie Hao（@xiewxx）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 留言讨论