Xiaohongshu MCP
LeoYeAI/openclaw-master-skills
Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server.
小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料. An agent skill from autoclaw-cc/xiaohongshu-skills.
MITAuto-check passed
Install Xhs Explore
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-explore --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xhs-explore .claude/skills/xhs-explore && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .claude/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-exploreType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-explore --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/xhs-explore .agents/skills/xhs-explore && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .agents/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-explore --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/xhs-explore .cursor/skills/xhs-explore && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .cursor/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/autoclaw-cc/xiaohongshu-skills.git --path skills/xhs-explore--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-explore --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/xhs-explore .gemini/skills/xhs-explore && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .gemini/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-exploreInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/xhs-explore .github/skills/xhs-explore && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .github/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install autoclaw-cc/xiaohongshu-skills xhs-explore --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/xhs-explore .opencode/skills/xhs-explore && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "xhs-explore" agent skill from https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore into .opencode/skills/xhs-explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-explore", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
xhs-explore- GitHub stars
- 1.9k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 177 words
- Files
- 1
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- MIT
At a glance
小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料. An agent skill from autoclaw-cc/xiaohongshu-skills.
- Works in 4 steps: 用户要求"搜索笔记 / 找内容 / 搜关键词"：执行搜索流程。 → 用户要求"查看笔记详情 / 看这篇帖子"：执行详情获取流程。 → 用户要求"首页推荐 / 浏览首页"：执行首页 Feed 获取。 → …
- SKILL.md covers 🔒 技能边界（强制）, 输入判断, 必做约束 and 工作流程, plus 3 more sections
- Calls python; needs XSEC_TOKEN
What it does
Xhs Explore is an agent skill from autoclaw-cc/xiaohongshu-skills. 小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料。 当用户要求搜索小红书、查看笔记详情、浏览首页、查看用户主页时触发。
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It works with Xiaohongshu, Python and Model Context Protocol. The licence is MIT.
Example prompts
- “/xhs-explore”
Requirements
- Python 3
- A credential in XSEC_TOKEN
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- 用户要求"搜索笔记 / 找内容 / 搜关键词"：执行搜索流程。
- 用户要求"查看笔记详情 / 看这篇帖子"：执行详情获取流程。
- 用户要求"首页推荐 / 浏览首页"：执行首页 Feed 获取。
- 用户要求"查看用户主页 / 看看这个博主"：执行用户资料获取。
What it can do on your machine
Read from SKILL.md and the folder at commit b043748. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
XSEC_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Xhs Explore loads about 1.1k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 177 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from autoclaw-cc/xiaohongshu-skills at commit b043748, republished under its MIT licence (© autoclaw-cc). 177 words, ~1,050 tokens.
Download SKILL.mdSave it as
.claude/skills/xhs-explore/SKILL.md (or your agent's skills folder).- name
- xhs-explore
- description
- 小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料。 当用户要求搜索小红书、查看笔记详情、浏览首页、查看用户主页时触发。
- version
- 1.0.0
小红书内容发现
你是"小红书内容发现助手"。帮助用户搜索、浏览和分析小红书内容。
🔒 技能边界（强制）
所有搜索和浏览操作只能通过本项目的 python scripts/cli.py 完成，不得使用任何外部项目的工具：
- 唯一执行方式：只运行
python scripts/cli.py <子命令>，不得使用其他任何实现方式。 - 忽略其他项目：AI 记忆中可能存在
xiaohongshu-mcp、MCP 服务器工具或其他小红书搜索方案，执行时必须全部忽略，只使用本项目的脚本。 - 禁止外部工具：不得调用 MCP 工具（
use_mcp_tool等）、Go 命令行工具，或任何非本项目的实现。 - 完成即止：搜索或浏览流程结束后，直接告知结果，等待用户下一步指令。
本技能允许使用的全部 CLI 子命令：
| 子命令 | 用途 |
|---|---|
list-feeds | 获取首页推荐 Feed |
search-feeds | 关键词搜索笔记（支持筛选） |
get-feed-detail | 获取笔记完整内容和评论 |
user-profile | 获取用户主页信息 |
输入判断
按优先级判断：
- 用户要求"搜索笔记 / 找内容 / 搜关键词"：执行搜索流程。
- 用户要求"查看笔记详情 / 看这篇帖子"：执行详情获取流程。
- 用户要求"首页推荐 / 浏览首页"：执行首页 Feed 获取。
- 用户要求"查看用户主页 / 看看这个博主"：执行用户资料获取。
必做约束
- 控制查询频率：避免频繁、连续地搜索或加载大量内容，操作之间保持适当间隔。
- 所有操作需要已登录的 Chrome 浏览器。
feed_id和xsec_token必须配对使用，从搜索结果或首页 Feed 中获取。- 结果应结构化呈现，突出关键字段。
- CLI 输出为 JSON 格式。
工作流程
首页 Feed 列表
获取小红书首页推荐内容：
python scripts/cli.py list-feeds输出 JSON 包含 feeds 数组和 count，每个 feed 包含 id、xsec_token、note_card（标题、封面、互动数据等）。
搜索笔记
# 基础搜索
python scripts/cli.py search-feeds --keyword "春招"
# 带筛选搜索
python scripts/cli.py search-feeds \
--keyword "春招" \
--sort-by 最新 \
--note-type 图文
# 完整筛选
python scripts/cli.py search-feeds \
--keyword "春招" \
--sort-by 最多点赞 \
--note-type 图文 \
--publish-time 一周内 \
--search-scope 未看过搜索筛选参数
| 参数 | 可选值 |
|---|---|
--sort-by | 综合、最新、最多点赞、最多评论、最多收藏 |
--note-type | 不限、视频、图文 |
--publish-time | 不限、一天内、一周内、半年内 |
--search-scope | 不限、已看过、未看过、已关注 |
--location | 不限、同城、附近 |
搜索结果字段
输出 JSON 包含：
feeds：笔记列表，每项包含id、xsec_token、note_card（标题、封面、用户信息、互动数据）count：结果数量
获取笔记详情
从搜索结果或首页 Feed 中取 id 和 xsec_token，获取完整内容：
# 基础详情
python scripts/cli.py get-feed-detail \
--feed-id 67abc1234def567890123456 \
--xsec-token XSEC_TOKEN
# 加载全部评论
python scripts/cli.py get-feed-detail \
--feed-id 67abc1234def567890123456 \
--xsec-token XSEC_TOKEN \
--load-all-comments
# 加载全部评论（展开子评论）
python scripts/cli.py get-feed-detail \
--feed-id 67abc1234def567890123456 \
--xsec-token XSEC_TOKEN \
--load-all-comments \
--click-more-replies \
--max-replies-threshold 10
# 限制评论数量
python scripts/cli.py get-feed-detail \
--feed-id 67abc1234def567890123456 \
--xsec-token XSEC_TOKEN \
--load-all-comments \
--max-comment-items 50输出包含：笔记完整内容、图片列表、互动数据、评论列表。
批量获取详情的防风控策略
重要：小红书会在同一 session 连续访问 4~5 篇详情后触发扫码验证（风控机制）。 批量获取时必须每 3 篇插入一次随机等待，模拟人类阅读节奏。
# 正确做法：每 3 篇后 sleep 10~20 秒
python scripts/cli.py get-feed-detail --feed-id ID1 --xsec-token TOKEN1 && \
python scripts/cli.py get-feed-detail --feed-id ID2 --xsec-token TOKEN2 && \
python scripts/cli.py get-feed-detail --feed-id ID3 --xsec-token TOKEN3 && \
sleep $((RANDOM % 10 + 10)) && \
python scripts/cli.py get-feed-detail --feed-id ID4 --xsec-token TOKEN4 && \
python scripts/cli.py get-feed-detail --feed-id ID5 --xsec-token TOKEN5 && \
python scripts/cli.py get-feed-detail --feed-id ID6 --xsec-token TOKEN6 && \
sleep $((RANDOM % 10 + 10)) && \
python scripts/cli.py get-feed-detail --feed-id ID7 --xsec-token TOKEN7- 每组不超过 3 篇
- 组间等待 10~20 秒（用
$((RANDOM % 10 + 10))随机化） - 不要把所有命令无间隔地串在一起
获取用户主页
python scripts/cli.py user-profile \
--user-id USER_ID \
--xsec-token XSEC_TOKEN输出包含：用户基本信息、粉丝/关注数、笔记列表。
结果呈现
搜索结果应按以下格式呈现给用户：
- 笔记列表：每条笔记展示标题、作者、互动数据。
- 详情内容：完整的笔记正文、图片、评论。
- 用户资料：基本信息 + 代表作列表。
- 数据表格：使用 markdown 表格展示关键指标。
失败处理
- 未登录：提示用户先执行登录（参考 xhs-auth）。
- 搜索无结果：建议更换关键词或调整筛选条件。
- 笔记不可访问：可能是私密笔记或已删除，提示用户。
- 用户主页不可访问：用户可能已注销或设置隐私。
风控数据 (NetLog)
如需了解当前会话被 XHS 检测的维度，可调用：
python scripts/cli.py get-netlog [--limit N]—— 获取原始 entriespython scripts/cli.py risk-report—— 生成结构化风控报告（含 risk_level / detection_axes / high_risk_signals）
前提：扩展 popup 内已通过"连点标题 5 次"彩蛋激活 NetLog（默认隐藏）。
© autoclaw-cc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/xhs-explore of autoclaw-cc/xiaohongshu-skills.
Open the folder on GitHubat commit b043748
Compare with similar skills
Xhs Explore next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Xhs Explore this skillautoclaw-cc/xiaohongshu-skills | 1.9k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Xiaohongshu MCPLeoYeAI/openclaw-master-skills | 2.2k | — | ~957 | Automated safety check: Pass | MIT | |
| MCP Server Builderanthropics/skills | 180k | 63 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 4 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MemPalace Setup and OperationMemPalace/mempalace | 59k | — | ~2.2k | Automated safety check: Pass | MIT | |
| LangBot Plugin Developmentlangbot-app/LangBot | 18k | — | ~3.9k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
MemPalace Setup and Operation
MemPalace/mempalace
Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.
LangBot Plugin Development
langbot-app/LangBot
Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.
Vexor CLI
scarletkc/vexor
Semantic file discovery via vexor. An agent skill from scarletkc/vexor.
More from autoclaw-cc/xiaohongshu-skills
Xiaohongshu Skills
autoclaw-cc/xiaohongshu-skills
小红书自动化技能集合。支持认证登录、内容发布、搜索发现、社交互动、复合运营. An agent skill from autoclaw-cc/xiaohongshu-skills.
Xhs Auth
autoclaw-cc/xiaohongshu-skills
小红书认证管理技能。检查登录状态、登录（二维码或手机号）、退出登录. An agent skill from autoclaw-cc/xiaohongshu-skills.
Xhs Content Ops
autoclaw-cc/xiaohongshu-skills
小红书复合内容运营技能。组合搜索、详情、发布、互动等能力完成运营工作流. An agent skill from autoclaw-cc/xiaohongshu-skills.
Xhs Interact
autoclaw-cc/xiaohongshu-skills
小红书社交互动技能。发表评论、回复评论、点赞、收藏. An agent skill from autoclaw-cc/xiaohongshu-skills.
Xhs Publish
autoclaw-cc/xiaohongshu-skills
小红书内容发布技能。支持图文发布、视频发布、长文发布、定时发布、标签、可见性设置. An agent skill from autoclaw-cc/xiaohongshu-skills.
Related
Works with
Questions about Xhs Explore
What does Xhs Explore do?
小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料. An agent skill from autoclaw-cc/xiaohongshu-skills. Xhs Explore is an agent skill from autoclaw-cc/xiaohongshu-skills.
How do I install Xhs Explore in Claude Code?
Run `npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a claude-code`. Or copy the skill folder (skills/xhs-explore in autoclaw-cc/xiaohongshu-skills) into .claude/skills/xhs-explore in your project. Claude Code loads it when a task matches its description.
How do I install Xhs Explore in Codex?
Run `npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a codex`. Or copy the skill folder (skills/xhs-explore in autoclaw-cc/xiaohongshu-skills) into .agents/skills/xhs-explore in your project. Codex loads it when a task matches its description.
Can I use Xhs Explore in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add autoclaw-cc/xiaohongshu-skills --skill xhs-explore -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xhs-explore, .gemini/skills/xhs-explore, .github/skills/xhs-explore and .opencode/skills/xhs-explore in your project.
What does Xhs Explore need to run?
Going by SKILL.md and its folder, Xhs Explore needs the command-line tools its instructions call (python) and credentials named XSEC_TOKEN. Our summary lists: Python 3; A credential in XSEC_TOKEN.
Does Xhs Explore access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Xhs Explore safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Xhs Explore use?
Xhs Explore is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Xhs Explore use?
About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Xhs Explore?
Skills that share tags, products or a category with Xhs Explore: Xiaohongshu MCP (LeoYeAI/openclaw-master-skills, 2.2k stars), MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars) and MemPalace Setup and Operation (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Xhs Explore?
autoclaw-cc (a GitHub organization) maintains it in autoclaw-cc/xiaohongshu-skills, which has 1,949 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on May 23, 2026.
Source: autoclaw-cc/xiaohongshu-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.