MCPInstall

xiaohongshu

by zhjiang22

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

Installs
11.6K
Last 24h
—
Trending rank
—
Security
Fail

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/zhjiang22/openclaw-xhs --skill xiaohongshu
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads xiaohongshu automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub FailHIGH ·This skill acts as a wrapper for third-party tools and requires the manual download and execution of unverified binaries from an untrusted GitHub repository. Additionally, it processes external content from Xiaohongshu (posts and comments) and formats it into reports for the AI agent, creating a surface for indirect prompt injection. It also features cross-skill command execution by attempting to locate and run scripts from other installed skills.
Socket PassNo alerts
Snyk FailCRITICAL ·Risk: CRITICAL · No issues
Runlayer WarnMEDIUM ·12/24 files flagged
ZeroLeaks PassLOW ·1 finding · Score: 86/100

SKILL.md

The instructions your agent reads when the skill is triggered.

小红书 MCP Skill

基于 xiaohongshu-mcp 封装的 shell 脚本工具集。

前置条件

cd scripts/
./install-check.sh    # 检查依赖（xiaohongshu-mcp、jq、python3）
./start-mcp.sh        # 启动 MCP 服务（默认端口 18060）
./status.sh           # 确认已登录

未登录时需扫码：mcp-call.sh get_login_qrcode 获取二维码，用小红书 App 扫码。

服务端口可通过 MCP_URL 环境变量覆盖（默认 http://localhost:18060/mcp）。

核心数据流

重要： 大多数操作需要 feed_id + xsec_token 配对。这两个值从搜索/推荐/用户主页结果中获取，不可自行构造。

search_feeds / list_feeds / user_profile
        │
        ▼
  返回 feeds 数组，每个 feed 包含:
  ├── id          → 用作 feed_id
  ├── xsecToken   → 用作 xsec_token
  └── noteCard    → 标题、作者、封面、互动数据
        │
        ▼
  get_feed_detail(feed_id, xsec_token)
        │
        ▼
  返回完整笔记: 正文、图片列表、评论列表
  评论中包含 comment_id、user_id（用于回复评论）

脚本参考

脚本用途参数
search.sh <关键词>搜索笔记关键词
recommend.sh首页推荐无
post-detail.sh <feed_id> <xsec_token>帖子详情+评论从搜索结果获取
comment.sh <feed_id> <xsec_token> <内容>发表评论从搜索结果获取
user-profile.sh <user_id> <xsec_token>用户主页+笔记从搜索结果获取
track-topic.sh <话题> [选项]热点分析报告--limit N --output file --feishu
export-long-image.sh帖子导出长图--posts-file json -o output.jpg
mcp-call.sh <tool> [json_args]通用 MCP 调用见下方工具表
start-mcp.sh启动服务--headless=false --port=N
stop-mcp.sh停止服务无
status.sh检查登录无
install-check.sh检查依赖无

MCP 工具详细参数

search_feeds — 搜索笔记

{"keyword": "咖啡", "filters": {"sort_by": "最新", "note_type": "图文", "publish_time": "一周内"}}

filters 可选字段：

  • sort_by: 综合 | 最新 | 最多点赞 | 最多评论 | 最多收藏
  • note_type: 不限 | 视频 | 图文
  • publish_time: 不限 | 一天内 | 一周内 | 半年内
  • search_scope: 不限 | 已看过 | 未看过 | 已关注
  • location: 不限 | 同城 | 附近

get_feed_detail — 帖子详情

{"feed_id": "...", "xsec_token": "...", "load_all_comments": true, "limit": 20}
  • load_all_comments: false(默认) 返回前10条，true 滚动加载更多
  • limit: 加载评论上限（仅 load_all_comments=true 时生效），默认 20
  • click_more_replies: 是否展开二级回复，默认 false
  • reply_limit: 跳过回复数超过此值的评论，默认 10
  • scroll_speed: slow | normal | fast

post_comment_to_feed — 发表评论

{"feed_id": "...", "xsec_token": "...", "content": "写得真好！"}

reply_comment_in_feed — 回复评论

{"feed_id": "...", "xsec_token": "...", "content": "谢谢！", "comment_id": "...", "user_id": "..."}

comment_id 和 user_id 从 get_feed_detail 返回的评论列表中获取。

user_profile — 用户主页

{"user_id": "...", "xsec_token": "..."}

user_id 从 feed 的 noteCard.user.userId 获取，xsec_token 使用该 feed 的 xsecToken。

like_feed — 点赞/取消

{"feed_id": "...", "xsec_token": "..."}
{"feed_id": "...", "xsec_token": "...", "unlike": true}

favorite_feed — 收藏/取消

{"feed_id": "...", "xsec_token": "..."}
{"feed_id": "...", "xsec_token": "...", "unfavorite": true}

publish_content — 发布图文

{"title": "标题(≤20字)", "content": "正文(≤1000字)", "images": ["/path/to/img.jpg"], "tags": ["美食","旅行"]}
  • images: 至少1张，支持本地路径或 HTTP URL
  • tags: 可选，话题标签
  • schedule_at: 可选，定时发布（ISO8601，1小时~14天内）

publish_with_video — 发布视频

{"title": "标题", "content": "正文", "video": "/path/to/video.mp4"}

其他工具

工具参数说明
check_login_status无检查登录状态
list_feeds无获取首页推荐
get_login_qrcode无获取登录二维码（Base64 PNG）
delete_cookies无删除 cookies，重置登录

热点跟踪

自动搜索 → 拉取详情 → 生成 Markdown 报告。

./track-topic.sh "DeepSeek" --limit 5
./track-topic.sh "春节旅游" --limit 10 --output report.md
./track-topic.sh "iPhone 16" --limit 5 --feishu    # 导出飞书

报告包含：概览统计、热帖详情（正文+热评）、评论关键词、趋势分析。

长图导出

将帖子导出为白底黑字的 JPG 长图。

./export-long-image.sh --posts-file posts.json -o output.jpg

posts.json 格式：

[{
  "title": "标题", "author": "作者", "stats": "1.3万赞",
  "desc": "正文摘要", "images": ["https://..."],
  "per_image_text": {"1": "第2张图的说明"}
}]

依赖：Python 3.10+、Pillow。

注意事项

  • Cookies 有效期约 30 天，过期需重新扫码
  • 首次启动会下载 headless 浏览器（~150MB）
  • 同一账号避免多客户端同时操作
  • 发布限制：标题≤20字符，正文≤1000字符，日发布≤50条
  • Linux 服务器无桌面环境需安装 xvfb（apt-get install xvfb，脚本自动管理）

FAQ

What does the xiaohongshu skill do?

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

How do I install xiaohongshu?

Run npx skills add https://github.com/zhjiang22/openclaw-xhs --skill xiaohongshu in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/xiaohongshu/ (personal) or .claude/skills/xiaohongshu/ (project).

Which AI agents can use xiaohongshu?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is xiaohongshu safe to install?

Security partners have reviewed it: Gen Agent Trust Hub flagged risks; Socket passed; Snyk flagged risks; Runlayer flagged items to review; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains xiaohongshu?

It is published by zhjiang22 in zhjiang22/openclaw-xhs. It has 11,573 recorded installs.

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs