xiaohongshu

小红书 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
        │

脚本参考

MCP 工具详细参数

search_feeds — 搜索笔记

filters 可选字段：

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

get_feed_detail — 帖子详情

• 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 — 发表评论

reply_comment_in_feed — 回复评论

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

user_profile — 用户主页

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

like_feed — 点赞/取消

favorite_feed — 收藏/取消

publish_content — 发布图文

• images: 至少1张，支持本地路径或 HTTP URL
• tags: 可选，话题标签
• schedule_at: 可选，定时发布（ISO8601，1小时~14天内）

publish_with_video — 发布视频

其他工具

热点跟踪

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

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

长图导出

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

posts.json 格式：

依赖：Python 3.10+、Pillow。

注意事项

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