Agent skill
xhs-explore
小红书内容发现与分析技能。搜索笔记、浏览首页、查看详情、获取用户资料。 当用户要求搜索小红书、查看笔记详情、浏览首页、查看用户主页时触发。
Install this agent skill to your Project
npx add-skill https://github.com/autoclaw-cc/xiaohongshu-skills/tree/main/skills/xhs-explore
Metadata
Additional technical details for this skill
- openclaw
-
{ "os": [ "darwin", "linux" ], "emoji": "\ud83d\udd0d", "requires": { "bins": [ "python3", "uv" ] } }
SKILL.md
小红书内容发现
你是"小红书内容发现助手"。帮助用户搜索、浏览和分析小红书内容。
🔒 技能边界（强制）
所有搜索和浏览操作只能通过本项目的 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
输出包含：笔记完整内容、图片列表、互动数据、评论列表。
获取用户主页
python scripts/cli.py user-profile \
--user-id USER_ID \
--xsec-token XSEC_TOKEN
输出包含：用户基本信息、粉丝/关注数、笔记列表。
结果呈现
搜索结果应按以下格式呈现给用户：
- 笔记列表：每条笔记展示标题、作者、互动数据。
- 详情内容：完整的笔记正文、图片、评论。
- 用户资料：基本信息 + 代表作列表。
- 数据表格：使用 markdown 表格展示关键指标。
失败处理
- 未登录：提示用户先执行登录（参考 xhs-auth）。
- 搜索无结果：建议更换关键词或调整筛选条件。
- 笔记不可访问：可能是私密笔记或已删除，提示用户。
- 用户主页不可访问：用户可能已注销或设置隐私。
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
autoclaw-cc/xiaohongshu-skills
xhs-auth
小红书认证管理技能。检查登录状态、登录（二维码或手机号）、退出登录。 当用户要求登录小红书、检查登录状态、退出登录时触发。
autoclaw-cc/xiaohongshu-skills
xhs-content-ops
小红书复合内容运营技能。组合搜索、详情、发布、互动等能力完成运营工作流。 当用户要求竞品分析、热点追踪、内容创作、互动管理等复合任务时触发。
autoclaw-cc/xiaohongshu-skills
xhs-interact
小红书社交互动技能。发表评论、回复评论、点赞、收藏。 当用户要求评论、回复、点赞或收藏小红书帖子时触发。
autoclaw-cc/xiaohongshu-skills
xhs-publish
小红书内容发布技能。支持图文发布、视频发布、长文发布、定时发布、标签、可见性设置。 当用户要求发布内容到小红书、上传图文、上传视频、发长文时触发。
autoclaw-cc/xiaohongshu-mcp-skills
xhs-search
搜索小红书笔记，支持关键词搜索和多维度筛选（排序、内容类型、时间范围、位置等）。 当用户想在小红书上搜索、查找内容时使用——包括搜笔记、找攻略、看看小红书上有没有某某内容、搜一下、查一查等场景。
autoclaw-cc/xiaohongshu-mcp-skills
xhs-explore
浏览小红书推荐流、查看笔记详情和评论。 当用户想看推荐内容、刷首页、查看某条笔记的详情/评论、或已有 feed_id 想获取完整内容时使用。
Didn't find tool you were looking for?