⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.2.2

xiaohongshu-tool

um-why@um-why⭐ 17 stars· last commit 4d ago· 1 open issues

小红书公开数据检索工具:关键词搜笔记、笔记详情、评论、博主作品与粉丝量等互动数据。用户提到小红书/xhs/rednote 且需要查数据、做选题、竞品监控、KOL筛选、评论舆情分析时调用;给关键词或链接即可,无需登录账号

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐ 17 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

📊 小红书洞察与竞品分析助手

一句话价值主张:把「人工刷 2 小时小红书」变成「一条命令 30 秒」——输入关键词或链接,直接拿回结构化爆款数据,AI 接着就能帮你做选题、盯竞品、筛 KOL、读评论区。

4 大能力 · 单次最多 1 万条 · 无需登录小红书 · 无需部署,Node.js 一键运行


😫 如果你在做小红书运营,这些场景你一定熟悉

你的日常传统做法用本SKILL后
找下周的选题方向翻 50 条笔记,手动记点赞收藏,约 1 小时search-cli 一条命令返回 50 条结构化数据,30 秒
盯竞品账号动更新了什么每天手动刷对方主页post-cli 直接拉作品列表 + 发布时间 + 互动数据
判断一个 KOL 数据有没有注水靠感觉、看粉丝量拍脑袋三项原始互动数值到手,评论/点赞比值一算便知
摸清用户到底在吐槽什么一条条往下翻评论区comment-cli 一次拉全量评论,AI 直接做舆情归纳
追今天刚起的热点反复刷发现页碰运气「最新排序 + 一天内」精准捕获实时内容

🔥 为什么选它

  • 🔒 安全:不登录你的小红书账号,零封号风险——这是爬虫方案给不了的
  • 💪 强大:单次最多拉取 1 万条数据,出参字段全面,可见即所得
  • 🎛️ 精准:内容类型 / 排序 / 时间范围 / 数量四维筛选,直出你要的那批数据
  • 🪶 轻量:零依赖、零部署,装好 Node.js 就能跑,Windows / macOS / Linux 通吃
  • 🤖 为 AI 而生:标准 JSON 出参 + 完整 SKILL.md,WorkBuddy / Openclaw / Claude Code / Cursor 等 Agent 开箱即用
  • 📁 省心:每次执行结果自动归档本地日志,写周报、做复盘直接翻记录

🎯 核心能力一览

能力输入你拿到什么
🔍 关键词搜索关键词笔记列表 + 作者 + 点赞/收藏/评论 + 可直接打开的链接
📰 笔记详情笔记链接标题、正文、图片、互动数据、作者信息
💬 评论获取笔记链接评论内容 + 评论者 + 互动数据,支持按时间剔除过期评论
👥 博主监控主页链接公开作品列表;--limit 0 时返回粉丝量、点赞量、收藏量

🚀 30 秒上手

第 1 步:访问 小红书实时数据获取技能官网 开通 TOKEN(数据 API 服务,开通即用)

第 2 步:配置环境变量

# Windows (PowerShell)
$env:GUAIKEI_API_TOKEN = "你的TOKEN"

# macOS / Linux
export GUAIKEI_API_TOKEN="你的TOKEN"

第 3 步:跑第一条命令

# 搜「露营装备」最近一周高赞图文,取 20 条
node src/xiaohongshu/search-cli.js --keyword "露营装备" --type 2 --sort 2 --time 2 --limit 20

更多命令示例:

# 追热点:一天内最新内容
node src/xiaohongshu/search-cli.js --keyword "多巴胺穿搭" --sort 1 --time 1 --limit 50

# 拉一篇笔记的 200 条评论做舆情分析
node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --limit 200

# 盯竞品:博主近 30 条作品
node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" --limit 30

# 查博主真实体量:粉丝量、点赞量、收藏量
node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" --limit 0

📦 数据长什么样

每条结果都是标准 JSON,AI 可直接消化、程序可直接解析:

{
  [
    {
      "id": "6a377...d46",
      "title": "深圳奇妙日花费大概多少",
      "desc": "奇妙日如果不买很多周边去互动 花门票钱进去能看到些什么呢? 二编 奇妙日换成在深圳的了喔 #kpl奇妙日",
      "liked_count": "336",
      "collected_count": "128",
      "comment_count": "193",
      "shared_count": "45",
      "user": { "nickname": "xxx", "user_id": "..." },
      "image_list": [
        "https://sns-na-i11.xhscdn.com/spectrum/...",
        "https://sns-na-i11.xhscdn.com/spectrum/...",
        "https://sns-na-i11.xhscdn.com/spectrum/..."
      ],
      "publish_time": "2026-09-08 20:06:00",
      "timestamp": "1788870094000",
      "type": "normal",
      "url": "https://www.xiaohongshu.com/explore/...?xsec_token=..."
    }
  ]
}

拿到数据后,让 AI 继续做:标题公式提炼 → 爆款归因 → 评论区观点聚类 → 竞品发文节奏分析 → 生成报告,一条链路到底。

✨ 适用人群

✅ 小红书内容创作者 / 运营 | ✅ 品牌营销 / 市场人员 | ✅ 数据分析师 | ✅ MCN 机构 / 博主经纪人 | ✅ AI Agent / 自动化工作流玩家

💬 购买前你可能想问

Q:需要登录我的小红书账号吗? 不需要。全程只读取公开数据,你的账号与工具零接触,无风控、无封号风险。

Q:数据从哪来,合规吗? 数据经 小红书洞察与竞品分析助手 官方数据接口返回,仅覆盖小红书公开可见内容。除关键词/链接等查询参数外,不上传本机任何数据。结果限个人/团队内部分析使用。

Q:我在国内,网络有要求吗? 国内直连可用,无需代理。

Q:一定要付费 TOKEN 吗? 是。数据接口由 guaikei.com 提供,需开通 TOKEN(16-256 位字符串)后使用,成本远低于同类 SaaS 数据平台年费。

Q:AI 工具里怎么用? 把本技能装进 WorkBuddy / Openclaw / QClaw / ima / Claude Code / Cursor,然后直接说人话:「帮我找最近一周小红书露营装备的高赞笔记」,Agent 会自动选对脚本、传对参数。

⚠️ 诚实的边界说明

  • 仅支持小红书公开数据:私密笔记、草稿、创作者后台数据(涨粉曲线、粉丝画像)、商业化数据(报价、聚光后台)均不支持,也不会支持
  • 不提供任何写操作(发布/点赞/评论/关注)
  • 不替你做营销决策——工具给数据,判断权在你

📞 帮助与支持

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md13 KBupstream ↗
    ---
    name: xiaohongshu-tool
    description: 小红书公开数据检索工具:关键词搜笔记、笔记详情、评论、博主作品与粉丝量等互动数据。用户提到小红书/xhs/rednote 且需要查数据、做选题、竞品监控、KOL筛选、评论舆情分析时调用;给关键词或链接即可,无需登录账号
    license: MIT
    version: 1.1.4
    category: 数据分析
    platforms: [WorkBuddy, Openclaw, QClaw, ima, Claude Code, Cursor]
    homepage: https://github.com/um-why/xiaohongshu-openclaw-skill
    metadata:
      type: command
      runtime: "[email protected]+"
      requires:
        bins: ["node"]
        env: ["GUAIKEI_API_TOKEN"]
      env_desc:
        GUAIKEI_API_TOKEN: "小红书数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通。"
      category:
        - "Integrations"
        - "Research"
        - "Creative"
        - "内容创作"
        - "数据分析"
        - "商业运营"
      tags:
        - "小红书"
        - "小红书搜索"
        - "小红书笔记"
        - "小红书评论"
        - "小红书博主"
        - "小红书运营"
        - "小红书数据分析"
        - "爆款选题"
        - "竞品分析"
        - "KOL筛选"
        - "评论舆情分析"
        - "内容选题调研"
        - "趋势洞察"
        - "种草营销"
        - "新媒体运营"
        - "关键词搜索"
        - "评论分析"
        - "选题调研"
        - "爆款挖掘"
        - "小红书内容创作"
        - "小红书营销"
      examples:
        - "帮我找最近一周小红书『露营装备』的高赞图文笔记 → node src/xiaohongshu/search-cli.js --keyword '露营装备' --type 2 --sort 2 --time 2 --limit 20"
        - "这条小红书笔记评论区在吐槽什么 → node src/xiaohongshu/comment-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy' --limit 200"
        - "看这个小红书博主最近 30 条作品发什么 → node src/xiaohongshu/post-cli.js --url 'https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy' --limit 30"
        - "分析这篇小红书爆款笔记为什么火 → node src/xiaohongshu/detail-cli.js --url 'https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy'"
        - "监控『多巴胺穿搭』最新动态 → node src/xiaohongshu/search-cli.js --keyword '多巴胺穿搭' --sort 1 --time 1 --limit 50"
    ---
    
    # 小红书洞察与竞品分析助手
    
    > ✨ **一句话**:给关键词或链接,拿回结构化的小红书公开数据——笔记、评论、博主作品,直接喂给后续的选题分析、竞品对比、舆情归纳。
    
    > ✨ **解决什么问题**:小红书运营最费时间的不是写内容,是「先搞清楚该写什么」。人工翻 50 条笔记记录点赞收藏要一小时,本工具一条命令返回 50 条结构化数据,AI 直接接着做归纳。
    
    | 你要做的事     | 这个技能给你什么                         | 省掉的动作             |
    | -------------- | ---------------------------------------- | ---------------------- |
    | 找选题方向     | 按点赞/收藏排序的笔记列表 + 完整互动数据 | 手动翻页、逐条记录数据 |
    | 盯竞品账号     | 博主公开作品列表 + 发布时间 + 互动表现   | 每天手动刷对方主页     |
    | 筛 KOL 真实性  | 点赞/评论/收藏三项原始数值               | 靠感觉判断数据是否注水 |
    | 摸用户真实想法 | 单篇笔记的评论区全量数据                 | 手动往下翻评论         |
    | 追热点         | 按「最新」+「一天内」筛出的实时内容      | 反复刷发现页           |
    
    **🔥核心优势**
    
    - **🔒 安全**:不登录你的小红书账号,零封号风险——这是爬虫方案给不了的
    - **💪 强大**:单次最多拉取 **1 万条**数据,出参字段全面,可见即所得
    - **🎛️ 精准**:内容类型 / 排序 / 时间范围 / 数量四维筛选,直出你要的那批数据
    - **🪶 轻量**:零依赖、零部署,装好 Node.js 就能跑,Windows / macOS / Linux 通吃
    - **🤖 为 AI 而生**:标准 JSON 出参 + 完整 SKILL.md,WorkBuddy / Openclaw / Claude Code / Cursor 等 Agent 开箱即用
    - **📁 省心**:每次执行结果自动归档本地日志,写周报、做复盘直接翻记录
    
    ---
    
    ## 1. ✅ 什么时候应该调用这个技能
    
    ### 1.1 🎯 满足以下**任一**条件即调用
    
    - 用户提到「小红书」「小红薯」「xhs」「rednote」并要求查看、搜索、分析内容
    - 用户要做 **关键词搜索**、**爆款选题调研**、**竞品监控**、**评论洞察**、**博主作品追踪**、 **KOL/博主筛选**、**评论区舆情分析**、**关键词趋势跟踪**。
    - 用户提供了小红书关键词、笔记链接或博主主页链接,希望拿到结构化数据。
    - 用户给出 `xiaohongshu.com` 或 `xhslink.com` 开头的链接
    - 用户说「帮我看看 XX 在小红书上的情况」这类需要真实数据支撑的判断
    - 用户后续还要基于结果继续做总结、对比、筛选、报告生成。
    
    ### 1.2 🚫 以下情况**不要调用**
    
    - 用户只让写文案、起标题、改脚本,没要求查数据
    - 用户查询的平台是抖音、B站、微博、公众号
    - 用户要求获取私密内容、登录态数据、隐藏数据或非公开信息。
    - 用户既没有提供关键词,也没有提供可识别的小红书链接,且任务目标不明确。
    
    ### 1.3 👀 意图模糊时的追问模板
    
    用户说「帮我做小红书竞品分析」——信息不足,按此追问:
    
    > 需要确认三件事:1)竞品是具体某个账号(给我主页链接),还是某个品类关键词?2)关注最新动态还是历史高赞?3)大概看多少条?
    
    拿到答案再执行。**不要自行编造关键词或链接。**
    
    ---
    
    ## 2. 🔀 四个能力与路由
    
    > **Note:** 请先通过 [小红书实时数据获取官网](https://www.guaikei.com) 开通TOKEN,配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。
    
    | 用户意图信号                          | 脚本                             | 必填        | 返回                                                 |
    | ------------------------------------- | -------------------------------- | ----------- | ---------------------------------------------------- |
    | 给的是**关键词**,无链接              | `src/xiaohongshu/search-cli.js`  | `--keyword` | 笔记列表 + 作者 + 互动数据 + 可点击 url              |
    | 给的是**笔记链接**,要看正文/互动数据 | `src/xiaohongshu/detail-cli.js`  | `--url`     | 笔记详情 + 作者信息                                  |
    | 给的是**笔记链接**,只要评论          | `src/xiaohongshu/comment-cli.js` | `--url`     | 评论内容 + 评论者 + 互动数据                         |
    | 给的是**博主主页链接**                | `src/xiaohongshu/post-cli.js`    | `--url`     | 作品列表;`--limit 0` 时返回粉丝量、点赞量、收藏量等 |
    
    ### 2.1 🧭 路由细则
    
    - 用户给的是 **关键词**,没有链接:走 **关键词搜索**。
    - 用户给的是 `https://www.xiaohongshu.com/explore/...` 或可解析到笔记的短链:若只关心评论,走 **笔记评论查询**;若要笔记详情一起看,走 **笔记详情**。
    - 用户给的是 `https://www.xiaohongshu.com/user/profile/...` 或可解析到主页的短链:走 **博主作品监控**。
    - 如果用户同时给出多个目标,按用户目标拆分执行,不要把不同意图硬塞进一次命令。
    
    ### 2.2 ⚖️ detail 与 comment 的区别
    
    - `detail-cli.js`:要笔记本身(标题、正文、图片、点赞收藏数)。
    - `comment-cli.js`:只要评论区,不返回正文。
    
    **同时需要正文和大量评论时**:调 `detail-cli.js` 拿正文,再调 `comment-cli.js --limit 500` 拿评论。
    
    ### 2.3 🧩 组合工作流
    
    **选题调研**
    
    ```
    search-cli --sort 2 --time 2 --limit 30    # 先拿一周高赞
    → 挑出前 5 条的 url
    → detail-cli 逐条看正文结构
    → 汇总标题公式 / 开头钩子 / 话题标签
    ```
    
    **竞品监控**
    
    ```
    post-cli --limit 30                        # 拿对方近 30 条
    → 按发布时间算更新频率
    → 按互动数据找出爆款
    → comment-cli 拉爆款的评论区看用户为什么买
    ```
    
    **KOL 筛选**
    
    ```
    post-cli --limit 20
    → 计算 评论数/点赞数、收藏数/点赞数 比值
    → 比值异常偏低 → 疑似刷量,标记风险
    ```
    
    ---
    
    ## 3. 🧺 输入规则
    
    ### 3.1 🔍 关键词搜索
    
    | 参数             | 必填 | 取值                                                                       | 默认 |
    | ---------------- | ---- | -------------------------------------------------------------------------- | ---- |
    | `--keyword` `-k` | 是   | 2-50 字符,不能是链接                                                      | —    |
    | `--type` `-t`    | 否   | 内容类型,`0` 全部 / `1` 视频 / `2` 图文                                   | `0`  |
    | `--sort` `-s`    | 否   | 排序规则,`0` 综合 / `1` 最新 / `2` 最多点赞 / `3` 最多评论 / `4` 最多收藏 | `0`  |
    | `--time` `-i`    | 否   | 发布时间,`0` 不限 / `1` 一天内 / `2` 一周内 / `3` 半年内                  | `0`  |
    | `--limit` `-l`   | 否   | 返回数量,整数 1-10000                                                     | `10` |
    
    **参数选择建议**(直接影响结果质量,请按意图选):
    
    | 用户说                             | 应该传              |
    | ---------------------------------- | ------------------- |
    | 「爆款」「高赞」「什么内容火」     | `--sort 2`          |
    | 「最新」「刚发的」「实时」「现在」 | `--sort 1 --time 1` |
    | 「这周趋势」「近期」               | `--sort 1 --time 2` |
    | 「大家都在收藏什么」「值得存的」   | `--sort 4`          |
    | 「讨论度高」「评论多」             | `--sort 3`          |
    | 「文案怎么写」「图文笔记」         | `--type 2`          |
    | 「视频怎么拍」                     | `--type 1`          |
    
    `--limit` 建议:快速看一眼 `10`;正经做选题 `30-50`;批量分析 `200+`(注意返回体积,超过 1000 条时告知用户数据量)。
    
    ### 3.2 📰 笔记详情
    
    至少要确认:
    
    - `url`:小红书笔记链接。
    
    适用链接示例:
    
    - `https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy`
    - `https://xhslink.com/m/xxx`
    
    如果用户给的是博主主页链接,不要误走详情脚本,先指出链接类型不匹配。
    
    ### 3.3 📡 博主作品监控
    
    至少要确认:
    
    - `url`:小红书博主主页链接。
    
    可选参数:
    
    - `limit`:返回作品数量上限;为 `0` 时返回该博主的互动数据(粉丝量、点赞量、收藏量等)。
    
    适用链接示例:
    
    - `https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy`
    - `https://xhslink.com/m/xxx`
    
    如果用户给的是笔记详情链接,不要误走博主脚本,先说明需要主页链接。
    
    ### 3.4 💬 笔记评论获取
    
    至少要确认:
    
    - `url`:小红书笔记链接。
    
    可选参数:
    
    - `expire`:有效评论天数筛选,整数 1-4745,不传时默认 2190,即近 6 年。
    - `limit`:评论数量上限,整数 1-10000,不传时默认 10。
    
    适用链接示例:
    
    - `https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy`
    - `https://xhslink.com/m/xxx`
    
    如果用户给的是博主主页链接,不要误走评论脚本,先指出链接类型不匹配。
    与「笔记详情」的区别:本能力只取评论数据,不返回笔记正文 / 互动详情,适合只想做评论洞察、观点聚类或舆情分析的场景。
    
    **👉 详细选项说明**, 可参阅 [完整选项说明](references/options.md)
    
    ---
    
    ## 4. 📜 执行原则
    
    - **缺输入先问**:无关键词 → 追问;无链接 → 追问;链接类型不明 → 确认是笔记还是主页;无 TOKEN → 提醒配置。
    - **成功输出**:目标 + 关键参数 + 结构化 JSON 结果,必要时补一小段摘要。
    - **失败不编造**:token 无效、链接非法、结果为空、接口异常、超时——如实告知原因。空结果不是成功结论。
    - **后续衔接**:结果可继续用于选题汇总、高赞对比、评论聚类、竞品风格总结、发文节奏分析、报告生成。
    
    ---
    
    ## 5. 🚫 反模式
    
    | 错误做法                                | 后果                 | 正确做法                            |
    | --------------------------------------- | -------------------- | ----------------------------------- |
    | 主页链接传 `detail-cli` / `comment-cli` | 不返回数据           | 主页走 `post-cli`                   |
    | 笔记链接传 `post-cli`                   | 不返回数据           | 笔记走 `detail-cli` / `comment-cli` |
    | 关键词纯 emoji / 纯符号                 | 清洗后为空,校验失败 | 换有意义的文字关键词                |
    | `--limit 20000`                         | 超上限回退为 10      | 上限 10000                          |
    | 查抖音 / 微信                           | 无结果               | 明确告知不支持                      |
    
    ---
    
    ## 6. 💡 命令示例
    
    ```bash
    # 关键词搜索:一周内图文,按点赞排序,取 20 条
    node src/xiaohongs
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/um-why-xiaohongshu-openclaw-skill.md

// REPO STATS

17 stars
1 open issues
Last commit: 4d ago