xiaohongshu Skill (zhjiang22, OpenClaw): What It Does and How to Install It

Gives an OpenClaw agent scripts to search Xiaohongshu (RedNote), read posts and comments, comment, like, publish and report on trends.

Installs: 11.6K; on skills.sh
Stars: 125; on GitHub
Updated: Mar 2026; last commit

SKILL.md describes shell scripts that wrap the separate xiaohongshu-mcp project. They talk to a local service, http://localhost:18060/mcp by default, which drives a logged-in browser session. Most actions need a feed id and token pair that come from search, feed or profile results.

It loads when you ask about Xiaohongshu, such as searching a topic or tracking a trend. It needs the xiaohongshu-mcp binaries, jq and python3, and a QR-code sign-in. The README documents an OpenClaw install. It is a third-party wrapper, not made by Xiaohongshu.

Good for

People who research topics and trends on Xiaohongshu (RedNote)
Creators who want an agent to read comments or publish notes
OpenClaw users who want Xiaohongshu in their agent workspace

Install xiaohongshu

Any client

Run this in a terminal.

shell

wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-linux-amd64.tar.gz
wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-login-linux-amd64.tar.gz
mkdir -p ~/.local/bin
tar -xzf xiaohongshu-mcp-*.tar.gz -C ~/.local/bin/
tar -xzf xiaohongshu-login-*.tar.gz -C ~/.local/bin/
cd ~/.local/bin && mv xiaohongshu-mcp-* xiaohongshu-mcp && mv xiaohongshu-login-* xiaohongshu-login
chmod +x xiaohongshu-mcp xiaohongshu-login

Requires Linux or macOS.

This skill is documented for an OpenClaw workspace. Do the steps in order: download the xiaohongshu-mcp binaries (the box shows the Linux x64 files; the README also lists macOS ARM files named xiaohongshu-mcp-darwin-arm64 and xiaohongshu-login-darwin-arm64), copy the repo into the skills folder, then sign in and start the service at http://localhost:18060/mcp. On a headless Linux server install xvfb first. The README lists Linux and macOS and Python 3.10 or newer. The README gives no Claude Code or Claude app install, so there are no tabs for them.

From the project README. Source.

What's in the skill

When it loads

小红书（RedNote）内容工具。使用场景： - 搜索小红书笔记并获取详情 - 获取首页推荐列表 - 获取帖子详情（正文、图片、互动数据、评论） - 发表评论 / 回复评论 - 获取用户主页和笔记列表 - 点赞、收藏帖子 - 发布图文或视频笔记 - 热点话题跟踪与分析报告 - 帖子导出为长图触发词示例： - "搜一下小红书上的XX" - "跟踪一下小红书上的XX热点" - "分析小红书上关于XX的讨论" - "小红书XX话题报告" - "生成XX的小红书舆情报告"

Sections in SKILL.md

前置条件
核心数据流
脚本参考
MCP 工具详细参数
search_feeds — 搜索笔记
get_feed_detail — 帖子详情
post_comment_to_feed — 发表评论
reply_comment_in_feed — 回复评论
user_profile — 用户主页
like_feed — 点赞/取消
favorite_feed — 收藏/取消
publish_content — 发布图文
publish_with_video — 发布视频
其他工具
热点跟踪
长图导出

Key facts

Author: zhjiang22
Repo: zhjiang22/openclaw-xhs
License: MIT for the shell script wrapper only (LICENSE and README); GitHub shows no standard license
Installs on skills.sh: 11,590 (Nov 2, 2026)
GitHub stars: 125 for the openclaw-xhs repo (Nov 2, 2026)
Last repo commit: Mar 8, 2026
Audits on skills.sh: Gen Agent Trust Hub: fail, Socket: pass, Snyk: fail
What it includes: 24 files in the repo: SKILL.md, 15 scripts in scripts/, 4 in tools/xhs-downloader/, 2 READMEs, LICENSE and .gitignore (counted from the repo tree)
Needs: xiaohongshu-mcp binaries, jq, python3, and a Xiaohongshu QR-code sign-in
Platforms: Linux and macOS, Python 3.10 or newer (README badges)

What it includes

Searches RedNote notes by keyword.
Calls search_feeds. SKILL.md lists filters for sort, note type, publish time, scope and location.
Try: “Search Xiaohongshu for pour-over coffee.”
Runs code · search.sh <keyword>
Fetches the homepage recommendation feed.
Runs code · recommend.sh
Gets a note with its text, images and comments.
SKILL.md says most actions need a feed_id and xsec_token pair taken from search, feed or profile results, never invented.
Runs code · post-detail.sh <feed_id> <xsec_token>
Posts a comment on a note.
The script builds the request and sends it with no confirmation step of its own.
Runs code · comment.sh <feed_id> <xsec_token> <text>
Gets a user profile and their notes.
Runs code · user-profile.sh <user_id> <xsec_token>
Searches, pulls details and writes a Markdown trend report.
Options are --limit N, --output file and --feishu. The report has overview stats, hot posts, comment keywords and a trend analysis.
Try: “Track the DeepSeek topic with 5 posts.”
Runs code · track-topic.sh <topic>
Exports notes from a posts.json file as one long JPG.
Needs Python 3.10 or newer and Pillow.
Runs code · export-long-image.sh
Calls any tool of the local xiaohongshu-mcp service.
SKILL.md also lists reply_comment_in_feed, like_feed, favorite_feed, publish_content, publish_with_video and delete_cookies.
Runs code · mcp-call.sh <tool> [json]
Starts or stops the local service on port 18060, and Xvfb when there is no display.
Runs code · start-mcp.sh / stop-mcp.sh
Checks login status, or checks for xiaohongshu-mcp, jq and python3.
Runs code · status.sh / install-check.sh

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can post and publish as your account
SKILL.md lists comment, reply, like, save, publish_content and publish_with_video. comment.sh sends the comment with no confirmation of its own. Read each command before you approve it. github.com
It runs a third-party binary you download
The README says xiaohongshu-mcp is a separate project that you download from its releases, and that it has no declared license. Check what you run before you start it. github.com
Login cookies are copied around
start-mcp.sh syncs cookies from a source file to /tmp/cookies.json. The README says cookie files are copied with 600 permissions. SKILL.md says cookies last about 30 days. github.com
Another skill can receive your report
track-topic.py with --feishu looks for a feishu-docs skill in known skill folders and runs its doc-import.sh with a report saved at /tmp/xhs_report.md. github.com
Fetched posts are untrusted text
The README says content from Xiaohongshu is user-generated. Do not let the assistant follow instructions found in a note or comment. github.com
First start downloads a browser
SKILL.md says the first start downloads a headless browser of about 150 MB. On Linux servers with no display the scripts start Xvfb. github.com

Technical details

Turning on read-only	No read-only mode is documented. search.sh, recommend.sh, post-detail.sh and user-profile.sh read; comment.sh and the publish tools write.
Talks to	Xiaohongshu, through the xiaohongshu-mcp browser. github.com releases (xiaohongshu-mcp binaries). http://localhost:18060/mcp (local service)
Sign-in and keys	You sign in by scanning a QR code with the Xiaohongshu app. The service keeps login cookies, which SKILL.md says expire after about 30 days.
Scopes	Acts as the Xiaohongshu account whose cookies the service holds Can comment, reply, like, save and publish image or video notes Runs a local xiaohongshu-mcp service on port 18060 and a headless browser Runs 15 scripts and downloads separate binaries

Questions

What does the xiaohongshu skill do?

It gives your assistant shell scripts that call a local xiaohongshu-mcp service. With them the assistant can search RedNote (小红书) notes, read posts and comments, comment, like, save, publish notes and write trend reports.

How do I install it?

Use the install box at the top of this page. The README route copies the repo into an OpenClaw workspace skills folder, and you must also download the xiaohongshu-mcp binaries and sign in by QR code.

Does it work in Claude Code?

The README and SKILL.md describe an OpenClaw workspace install and never mention Claude Code. The skills CLI command is listed for completeness, but the documented setup is OpenClaw.

Do I need an API key?

No key is named in the README or SKILL.md. You sign in with the Xiaohongshu app by scanning a QR code, or copy cookies from a machine with a screen.

Is it safe?

It acts as your Xiaohongshu account and can post, comment and publish. It also runs a downloaded binary and a local service. Our advice: use a spare account, and read each command before you approve it.

Is it by Xiaohongshu?

No. The README says it is a wrapper around xiaohongshu-mcp by another author, and that xiaohongshu-mcp is a separate project. The repo owner is zhjiang22.

What license does it have?

The LICENSE file is MIT and says it covers the shell script wrapper layer only. The README says xiaohongshu-mcp has no declared license and that XHS-Downloader, used for memory export, is GPL-3.0.

What does the memory export do?

The README describes turning your liked or saved posts into Markdown in ~/.openclaw/workspace/xhs-memory. It uses XHS-Downloader plus a Tampermonkey script, and you then add that folder to the OpenClaw memorySearch setting.

Information

updated Nov 2, 2026

Repository: zhjiang22/openclaw-xhs

zhjiang22/openclaw-xhs skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

openclaw-xhs README · github.com
xiaohongshu SKILL.md · github.com