openclaw-xhs
🔥 让 OpenClaw 读懂你的小红书 — MCP 集成 + 热点跟踪 + 个人记忆库导出
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/zhjiang22--openclaw-xhs)HTML
<a href="/listings/zhjiang22--openclaw-xhs"><img src="/api/listings/zhjiang22--openclaw-xhs/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Install xiaohongshu-mcp
Download from [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases):
# Linux x64 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 # macOS ARM wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-arm64.tar.gz wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-login-darwin-arm64.tar.gz
Install:
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
2. Install This Toolkit
# Clone to OpenClaw workspace git clone https://github.com/zhjiang22/openclaw-xhs.git cp -r openclaw-xhs ~/.openclaw/workspace/skills/xiaohongshu # Or use symlink ln -s /path/to/openclaw-xhs ~/.openclaw/workspace/skills/xiaohongshu # Verify installation cd ~/.openclaw/workspace/skills/xiaohongshu/scripts ./install-check.sh
3. Login (Get Cookies)
**Option A: Desktop Environment**
./login.sh # Opens browser, scan QR code with Xiaohongshu app
**Option B: Headless Server**
Get cookies on your local machine, then copy to server:
# On local machine with GUI ./xiaohongshu-login # Cookies saved to /tmp/cookies.json # Copy to server scp /tmp/cookies.json user@server:~/.xiaohongshu/cookies.json
4. Start Service
./start-mcp.sh # Headless mode ./start-mcp.sh --headless=false # Show browser (debug)
Service runs at `http://localhost:18060/mcp`.
Server Deployment (Headless Linux)
On servers without a desktop environment, the underlying browser requires a virtual display. `start-mcp.sh` **auto-detects** the environment — if no display is found, it starts Xvfb automatically. Just install it first:
# Debian/Ubuntu sudo apt-get install -y xvfb # CentOS/RHEL sudo yum install -y xorg-x11-server-Xvfb
No extra configuration needed. The script handles: - Detecting the `DISPLAY` environment variable - Auto-starting `Xvfb :99` when no display is available - Cleaning up Xvfb when `stop-mcp.sh` is called
> **Note**: Without Xvfb, login and search will fail on headless servers. See [Issue #3](https://github.com/zhjiang22/openclaw-xhs/issues/3).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 202 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: xiaohongshu
- description: |
- 小红书(RedNote)内容工具。使用场景:
- - 搜索小红书笔记并获取详情
- - 获取首页推荐列表
- - 获取帖子详情(正文、图片、互动数据、评论)
- - 发表评论 / 回复评论
- - 获取用户主页和笔记列表
- - 点赞、收藏帖子
- - 发布图文或视频笔记
- - 热点话题跟踪与分析报告
- - 帖子导出为长图
- 触发词示例:
- - "搜一下小红书上的XX"
- - "跟踪一下小红书上的XX热点"
- - "分析小红书上关于XX的讨论"
- - "小红书XX话题报告"
- - "生成XX的小红书舆情报告"
- ---
- # 小红书 MCP Skill
- 基于 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 封装的 shell 脚本工具集。
- ## 前置条件
- ```bash
- 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 — 搜索笔记
- ```json
- {"keyword": "咖啡", "filters": {"sort_by": "最新", "note_type": "图文", "publish_time": "一周内"}}
- ```
- filters 可选字段:
- - `sort_by`: 综合 | 最新 | 最多点赞 | 最多评论 | 最多收藏
- - `note_type`: 不限 | 视频 | 图文
- - `publish_time`: 不限 | 一天内 | 一周内 | 半年内
- - `search_scope`: 不限 | 已看过 | 未看过 | 已关注
- - `location`: 不限 | 同城 | 附近
- ### get_feed_detail — 帖子详情
- ```json
- {"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 — 发表评论
- ```json
- {"feed_id": "...", "xsec_token": "...", "content": "写得真好!"}
- ```
- ### reply_comment_in_feed — 回复评论
- ```json
- {"feed_id": "...", "xsec_token": "...", "content": "谢谢!", "comment_id": "...", "user_id": "..."}
- ```
- `comment_id` 和 `user_id` 从 get_feed_detail 返回的评论列表中获取。
- ### user_profile — 用户主页
- ```json
- {"user_id": "...", "xsec_token": "..."}
- ```
- `user_id` 从 feed 的 `noteCard.user.userId` 获取,`xsec_token` 使用该 feed 的 `xsecToken`。
- ### like_feed — 点赞/取消
- ```json
- {"feed_id": "...", "xsec_token": "..."}
- {"feed_id": "...", "xsec_token": "...", "unlike": true}
- ```
- ### favorite_feed — 收藏/取消
- ```json
- {"feed_id": "...", "xsec_token": "..."}
- {"feed_id": "...", "xsec_token": "...", "unfavorite": true}
- ```
- ### publish_content — 发布图文
- ```json
- {"title": "标题(≤20字)", "content": "正文(≤1000字)", "images": ["/path/to/img.jpg"], "tags": ["美食","旅行"]}
- ```
- - `images`: 至少1张,支持本地路径或 HTTP URL
- - `tags`: 可选,话题标签
- - `schedule_at`: 可选,定时发布(ISO8601,1小时~14天内)
- ### publish_with_video — 发布视频
- ```json
- {"title": "标题", "content": "正文", "video": "/path/to/video.mp4"}
- ```
- ### 其他工具
- | 工具 | 参数 | 说明 |
- |------|------|------|
- | `check_login_status` | 无 | 检查登录状态 |
- | `list_feeds` | 无 | 获取首页推荐 |
- | `get_login_qrcode` | 无 | 获取登录二维码(Base64 PNG) |
- | `delete_cookies` | 无 | 删除 cookies,重置登录 |
- ## 热点跟踪
- 自动搜索 → 拉取详情 → 生成 Markdown 报告。
- ```bash
- ./track-topic.sh "DeepSeek" --limit 5
- ./track-topic.sh "春节旅游" --limit 10 --output report.md
- ./track-topic.sh "iPhone 16" --limit 5 --feishu # 导出飞书
- ```
- 报告包含:概览统计、热帖详情(正文+热评)、评论关键词、趋势分析。
- ## 长图导出
- 将帖子导出为白底黑字的 JPG 长图。
- ```bash
- ./export-long-image.sh --posts-file posts.json -o output.jpg
- ```
- posts.json 格式:
- ```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`,脚本自动管理)
README.md · README · 315 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # XHS AI Toolkit
- <p align="center">
- <b>Make AI understand your Xiaohongshu (RedNote)</b>
- </p>
- <p align="center">
- <a href="README_CN.md">简体中文</a> | English
- </p>
- <p align="center">
- <img alt="License" src="https://img.shields.io/badge/license-MIT-blue.svg">
- <img alt="Platform" src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS-lightgrey.svg">
- <img alt="Python" src="https://img.shields.io/badge/python-3.10+-green.svg">
- <img alt="MCP" src="https://img.shields.io/badge/MCP-compatible-purple.svg">
- </p>
- ---
- AI-powered toolkit for **Xiaohongshu (小红书 / RedNote)** that turns your favorite posts into AI memory.
- - **MCP Integration** — Search, browse, comment via AI assistants
- - **Trend Tracking** — Auto-generate topic reports with engagement analytics
- - **Memory Export** — Convert your liked/saved posts into AI-searchable knowledge base
- Built on [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) and [XHS-Downloader](https://github.com/JoeanAmier/XHS-Downloader).
- ## Features
- | Feature | Description |
- |---------|-------------|
- | Search | Search posts by keywords |
- | Feed | Get homepage recommendations |
- | Post Details | Fetch post content, comments, engagement stats |
- | Comment | Post comments to notes |
- | User Profile | Get user info and their posts |
- | Trend Tracking | Auto-generate topic analysis reports |
- | Long Image Export | Export posts as annotated JPG long images |
- | Memory Export | Export liked/saved posts as Markdown for AI memory |
- ## Quick Start
- ### 1. Install xiaohongshu-mcp
- Download from [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases):
- ```bash
- # Linux x64
- 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
- # macOS ARM
- wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-arm64.tar.gz
- wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-login-darwin-arm64.tar.gz
- ```
- Install:
- ```bash
- 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
- ```
- ### 2. Install This Toolkit
- ```bash
- # Clone to OpenClaw workspace
- git clone https://github.com/zhjiang22/openclaw-xhs.git
- cp -r openclaw-xhs ~/.openclaw/workspace/skills/xiaohongshu
- # Or use symlink
- ln -s /path/to/openclaw-xhs ~/.openclaw/workspace/skills/xiaohongshu
- # Verify installation
- cd ~/.openclaw/workspace/skills/xiaohongshu/scripts
- ./install-check.sh
- ```
- ### 3. Login (Get Cookies)
- **Option A: Desktop Environment**
- ```bash
- ./login.sh # Opens browser, scan QR code with Xiaohongshu app
- ```
- **Option B: Headless Server**
- Get cookies on your local machine, then copy to server:
- ```bash
- # On local machine with GUI
- ./xiaohongshu-login
- # Cookies saved to /tmp/cookies.json
- # Copy to server
- scp /tmp/cookies.json user@server:~/.xiaohongshu/cookies.json
- ```
- ### 4. Start Service
- ```bash
- ./start-mcp.sh # Headless mode
- ./start-mcp.sh --headless=false # Show browser (debug)
- ```
- Service runs at `http://localhost:18060/mcp`.
- #### Server Deployment (Headless Linux)
- On servers without a desktop environment, the underlying browser requires a virtual display.
- `start-mcp.sh` **auto-detects** the environment — if no display is found, it starts Xvfb automatically. Just install it first:
- ```bash
- # Debian/Ubuntu
- sudo apt-get install -y xvfb
- # CentOS/RHEL
- sudo yum install -y xorg-x11-server-Xvfb
- ```
- No extra configuration needed. The script handles:
- - Detecting the `DISPLAY` environment variable
- - Auto-starting `Xvfb :99` when no display is available
- - Cleaning up Xvfb when `stop-mcp.sh` is called
- > **Note**: Without Xvfb, login and search will fail on headless servers. See [Issue #3](https://github.com/zhjiang22/openclaw-xhs/issues/3).
- ## Usage
- ### Basic Commands
- ```bash
- ./status.sh # Check login status
- ./search.sh "coffee" # Search posts
- ./recommend.sh # Get recommendations
- ./post-detail.sh <id> <token> # Get post details
- ./comment.sh <id> <token> "Great post!" # Comment
- ./user-profile.sh <user_id> <xsec_token> # Get user profile
- ```
- ### Trend Tracking
- Auto-search trending posts and generate analysis reports:
- ```bash
- ./track-topic.sh "AI" --limit 10
- ./track-topic.sh "travel" --limit 5 --output report.md
- ./track-topic.sh "iPhone" --limit 5 --feishu # Export to Feishu
- ```
- ### MCP Tools
- | Tool | Description |
- |------|-------------|
- | `check_login_status` | Check login status |
- | `search_feeds` | Search posts |
- | `list_feeds` | Get homepage feed |
- | `get_feed_detail` | Get post details & comments |
- | `post_comment_to_feed` | Post comment |
- | `user_profile` | Get user profile |
- | `like_feed` | Like/unlike post |
- | `favorite_feed` | Save/unsave post |
- | `publish_content` | Publish image post |
- | `publish_with_video` | Publish video post |
- ### Long Image Export
- Export posts as annotated JPG long images (white background, black text):
- ```bash
- # Prepare posts.json
- cat > posts.json << 'EOF'
- [
- {
- "title": "Post title",
- "author": "Author",
- "stats": "13k likes 100 saves",
- "desc": "Post summary",
- "images": ["https://...webp"],
- "per_image_text": {"1": "Caption for 2nd image"}
- }
- ]
- EOF
- ./export-long-image.sh --posts-file posts.json -o output.jpg
- ```
- Requires: Python 3.10+, Pillow (`pip install Pillow`)
- ## Memory Export (Turn Likes into AI Memory)
- Export your liked/saved posts as a searchable knowledge base for AI assistants.
- ### 1. Install XHS-Downloader
- ```bash
- git clone https://github.com/JoeanAmier/XHS-Downloader.git
- cd XHS-Downloader
- pip install -r requirements.txt
- ```
- ### 2. Extract Post Links (Tampermonkey Script)
- 1. Install [Tampermonkey](https://www.tampermonkey.net/)
- 2. Install [XHS-Downloader UserScript](https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js)
- 3. Go to Xiaohongshu web → Profile → Liked/Saved
- 4. Click Tampermonkey menu → "Extract liked posts" or "Extract saved posts"
- 5. Links auto-copied to clipboard
- 6. Paste into `links.md`
- ### 3. Download & Export
- ```bash
- # Copy helper scripts
- cp tools/xhs-downloader/*.py /path/to/XHS-Downloader/
- # Download posts
- cd /path/to/XHS-Downloader
- python batch_download.py links.md
- # Export to workspace
- python export_to_workspace.py
- # Output: ~/.openclaw/workspace/xhs-memory/
- ```
- ### 4. Configure OpenClaw Memory Search
- Edit `~/.openclaw/openclaw.json`:
- ```json
- {
- "memorySearch": {
- "extraPaths": [
- "~/.openclaw/workspace/xhs-memory"
- ]
- }
- }
- ```
- Now your AI assistant can search your Xiaohongshu favorites!
- ## Project Structure
- ```
- openclaw-xhs/
- ├── README.md # English docs
- ├── README_CN.md # Chinese docs
- ├── LICENSE
- ├── SKILL.md # Skill manifest
- ├── scripts/ # MCP wrapper scripts
- │ ├── install-check.sh
- │ ├── start-mcp.sh
- │ ├── stop-mcp.sh
- │ ├── login.sh
- │ ├── mcp-call.sh
- │ ├── status.sh
- │ ├── search.sh
- │ ├── recommend.sh
- │ ├── post-detail.sh
- │ ├── comment.sh
- │ ├── user-profile.sh
- │ ├── track-topic.sh
- │ ├── track-topic.py
- │ ├── export-long-image.sh
- │ └── export-long-image.py
- └── tools/
- └── xhs-downloader/ # Memory export tools
- ├── README.md
- ├── batch_download.py
- ├── export_memory.py
- └── export_to_workspace.py
- ```
- ## Security
- This project implements the following security measures:
- - **Cookie protection**: Cookie files are copied with `600` permissions (owner-only read/write)
- - **Injection prevention**: All shell scripts use `jq` to build JSON payloads instead of string interpolation, preventing shell injection
- - **Tool name validation**: MCP tool names are restricted to alphanumeric characters and underscores
- - **Path validation**: Cross-skill script calls validate that target paths are within allowed directories
- - **Third-party content**: Content fetched from Xiaohongshu is user-generated; exercise appropriate caution
- ## Disclaimer
- This project is a **wrapper layer** for [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp).
- - Does NOT contain xiaohongshu-mcp source code
- - Users must download xiaohongshu-mcp binaries separately
- - Scripts communicate via HTTP protocol only
- ## Acknowledgments
- - [@xpzouying](https://github.com/xpzouying) — [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)
- - [@JoeanAmier](https://github.com/JoeanAmier) — [XHS-Downloader](https://github.com/JoeanAmier/XHS-Downloader) (GPL-3.0)
- ## License
- MIT License (wrapper scripts only)
- **Note:** xiaohongshu-mcp has no declared license. Please respect the author's terms.
- ---
- <p align="center">
- <b>If this project helps you, please give it a ⭐!</b>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.